3.9 KiB
Документ 10. Agent Protocol
Назначение
Документ определяет протокол взаимодействия AI-агентов в платформе Agent Control Center, включая регистрацию, выполнение задач, передачу контекста и восстановление после сбоев.
1. Цели протокола
- Унифицированное взаимодействие агентов.
- Независимость от поставщика LLM.
- Поддержка распределенного выполнения.
- Безопасная передача контекста.
- Совместимость между версиями.
2. Жизненный цикл агента
Состояния:
- Created
- Registered
- Idle
- Busy
- WaitingApproval
- Paused
- Resuming
- Completed
- Failed
- Offline
- Decommissioned
Все переходы состояний должны журналироваться.
3. Регистрация
При регистрации агент обязан передать:
- agent_id
- protocol_version
- provider
- model
- capabilities
- supported_tools
- max_context_size
После успешной регистрации агент получает конфигурацию и политики безопасности.
4. Heartbeat
Heartbeat отправляется периодически и содержит:
- agent_id
- timestamp
- current_state
- active_run_id
- resource_usage
- protocol_version
При отсутствии heartbeat в течение заданного интервала агент переводится в состояние Offline.
5. Выполнение задач
Каждая задача содержит:
- run_id
- task_id
- objective
- context
- constraints
- acceptance_criteria
- timeout
- priority
6. Handoff
При передаче задачи другому агенту передаются:
- objective
- current_status
- completed_steps
- remaining_steps
- artifacts
- memory_links
- open_questions
- constraints
- acceptance_criteria
Передача должна быть атомарной и журналируемой.
7. Checkpoint
Агент обязан поддерживать создание контрольных точек:
- checkpoint_id
- run_id
- timestamp
- execution_state
- memory_snapshot
- artifact_references
Checkpoint используется для восстановления после сбоя.
8. Восстановление
После восстановления агент:
- Загружает последний checkpoint.
- Проверяет актуальность контекста.
- Возобновляет выполнение.
- Публикует событие RunResumed.
9. Потоковые события
Агент может публиковать:
- progress;
- logs;
- warnings;
- partial_results;
- metrics.
Все события содержат correlation_id и request_id.
10. Совместимость
- Обязательное указание protocol_version.
- Несовместимые изменения требуют новой версии протокола.
- Старые версии поддерживаются в течение периода депрекации.
11. Требования безопасности
- Все сообщения подписываются.
- Используется TLS.
- Проверяется авторизация агента.
- Ограничиваются разрешенные инструменты.
- Все критические действия записываются в Audit.
Следующий документ
11_Connector_SDK.md