Документация
Docs/ru/reference/ai-control-protocol/index.md
Сгенерированный справочник протокола AiControl
Сгенерированный справочник. Не редактируйте его напрямую. Измените
BuildTools/AiControlProtocol.json, затем запуститеpython BuildTools/docs_ai_control_protocol.py --write.
| Обзор | Wire-контракт | Методы | Команды и события | Безопасность | Интеграция и проверка | Канонический JSON | Руководство |
Этот справочник определяет принадлежащий Engine и нейтральный к проекту конверт для опциональных bridges наблюдения и управления ИИ. Он не определяет игровую схему, пространство имён MCP, listener в основном runtime или обход server authority.
Состояние контракта
| Поле | Значение |
|---|---|
| Стабильность | experimental |
| Политика поддержки | Конверт версионируется, но остаётся экспериментальным; встраиваемые проекты должны закреплять ревизию Engine и владеть своими схемами наблюдений и действий. |
| Версия протокола | 1 |
| Маркер JSON-RPC | 2.0 |
| Endpoint по умолчанию | 127.0.0.1:43011 |
| Максимальный JSON payload | 1048576 |
| Стабильные элементы | 49 |
| Манифест-источник | BuildTools/AiControlProtocol.json |
| Digest контракта | d23079d2dda2357f9293250a395817f576437531c970245e710c436880bf8c65 |
| Справочник | Назначение |
|---|---|
| Wire-контракт | Framing, конверты, порядок и коды ошибок. |
| Методы | Шесть транспортных методов и их результаты. |
| Команды и события | Общие поля команд и асинхронное завершение. |
| Безопасность | Loopback, tokens, shipping-сборки и authority. |
| Интеграция и проверка | Ответственность проекта и исполняемые свидетельства. |
Граница
Включено:
- UTF-8 JSON с одним сообщением на строку поверх потока байтов TCP
- конверты request, result и error по форме JSON-RPC
- методы авторизации, liveness, status, наблюдения, событий и действий
- ограниченные transport, очередь команд и история событий
- жизненный цикл принятой команды и её асинхронного завершения
- граница угроз с loopback по умолчанию и эталонная проверка
Исключено:
- listener, скомпилированный в основной runtime FOnline
- проектные поля наблюдений, имена игровых действий, семантика сущностей и критерии готовности
- имена MCP-инструментов, рецепты оркестрации, игровые политики и prompts моделей
- обход server authority, команды администратора, TLS, discovery и публикация в интернете