ДокументацияЧитать блог
ДокументацияТехнические руководства

Протоколы, распознавание Agent и отображение путей

Разберитесь в интерфейсах, потоках, CWD, путях и ограничениях Shell между ОС.

Протокол — формат запроса и ответа

Messages, Chat Completions и Responses различаются. User Client предоставляет совместимые адреса, Worker преобразует формат или вызывает нужный маршрут. Инструмент должен читать выбранный ответ.

АдресНазначение
POST /v1/messagesAnthropic Messages и поддерживаемый поток
POST /v1/chat/completionsChat Completions
POST /v1/responsesResponses
POST /v1/responses/compactСжатие на поддерживаемом канале
GET /v1/models и деталиКаталог текущего ключа
POST /v1/images/generations, editsПоддерживаемая генерация/редактирование изображений

Есть подсчёт, старые completions и WebSocket. Наличие адреса не открывает любую возможность тарифа/модели. Удалённые embeddings, files и отдельные HTTP audio не появляются из-за методов SDK.

Поток и выполнение

Фрагмент SSE/WebSocket не равен одному токену. Буферизация, преобразование и сборка аргументов меняют части. HTTP 200 или handshake могут предшествовать ошибке внутри потока.

Источник Agent, ОС и CWD определяются отдельно. Правила распознают инструмент, UA даёт сведения об ОС, CWD — рабочий каталог. Надёжное извлечение/повторное использование допускает отображение. Неизвестный, отсутствующий или конфликтующий каталог приводит к осторожному отказу от отображения, не к новому запрету запроса сам по себе.

ОС, CWD и отображение путей в квитанции

Границы отображения

Для известного Agent с надёжным каталогом совпадающие пути запроса заменяются виртуальными, а обратные восстанавливаются. Обработка касается декодированного текста, JSON и потоковых аргументов; зашифрованное reasoning не изменяется. Неизвестные форматы и несовпадающие пути исключают обещание полной безошибочности.

Синтаксис Shell не переводится. Пути не превращают PowerShell/cmd в Bash. Распознанная ОС может предпочесть такое же предоставление, но запасной маршрут всё равно даёт несовместимые команды. Проверяйте результаты и квитанцию; самокоррекция Agent не является гарантированным переводом Shell.

Правила публикуются по версиям; новые возможности парсера могут потребовать обновления Client. Неизвестный инструмент может использовать совместимый HTTP без предпочтения маршрута только по ОС. Отображение не удаляет любые секретные сведения или реальные пути из текста.