Документация Docs/ru/reference/ai-control-protocol/commands-events.md

Команды и события AiControl

Сгенерированный справочник. Не редактируйте его напрямую. Измените BuildTools/AiControlProtocol.json, затем запустите python BuildTools/docs_ai_control_protocol.py --write.

Обзор

Wire-контракт

Методы

Команды и события

Безопасность

Интеграция и проверка

Канонический JSON

Руководство

Стабильный ID	Поле	Тип	Контракт	Источник
`ai-control-protocol.command.type`	`type`	`string`	Обязательный непустой discriminator проектной команды.	BuildTools/ai_control_client.py
`ai-control-protocol.command.target-id`	`targetId`	`project identifier`	Необязательный идентификатор основной цели.	BuildTools/ai_control_client.py
`ai-control-protocol.command.item-id`	`itemId`	`project identifier`	Необязательный идентификатор предмета.	BuildTools/ai_control_client.py
`ai-control-protocol.command.aux-id`	`auxId`	`project identifier`	Необязательный вспомогательный идентификатор.	BuildTools/ai_control_client.py
`ai-control-protocol.command.x`	`x`	`integer`	Необязательная проектная координата X мира или сетки.	BuildTools/ai_control_client.py
`ai-control-protocol.command.y`	`y`	`integer`	Необязательная проектная координата Y мира или сетки.	BuildTools/ai_control_client.py
`ai-control-protocol.command.screen-x`	`screenX`	`integer`	Необязательная экранная координата X.	BuildTools/ai_control_client.py
`ai-control-protocol.command.screen-y`	`screenY`	`integer`	Необязательная экранная координата Y.	BuildTools/ai_control_client.py
`ai-control-protocol.command.int-arg`	`intArg`	`integer`	Необязательный целочисленный payload с проектным смыслом.	BuildTools/ai_control_client.py
`ai-control-protocol.command.string-arg`	`stringArg`	`string`	Необязательный строковый payload с проектным смыслом.	BuildTools/ai_control_client.py
`ai-control-protocol.command.append`	`append`	`boolean`	Необязательный запрос проектной семантики append вместо replace.	BuildTools/ai_control_client.py

Конверт завершения

Принятая команда возвращает commandSeq. Позднее проект добавляет событие с type=command_completed, тем же commandSeq, логическим success и понятным проекту message. Принятие никогда не означает успех.