Порядок работы для агента

1. Выберите в llms.txt сценарий по задаче и роли в нужной организации. Уточните роль, объекты и ожидаемый результат, если по запросу их нельзя определить однозначно.
2. Начинайте с тестового стенда https://partner-test-yamagistrali.ru. Используйте рабочий стенд https://yamagistrali.ru, если пользователь явно выбрал его. Идентификаторы, доступ и токены проверяйте на выбранном стенде.
3. Используйте клиент, сгенерированный из OpenAPI. Для защищённых методов настройте доступ к выбранному стенду. Если способ передачи токена клиенту ещё не настроен, согласуйте его с пользователем. Если для задачи нужно действовать от имени организации, проверьте профиль и уточните выбор при необходимости.
4. Перед вызовом откройте карточку метода и проверьте правила работы с персональными и чувствительными данными. Передайте параметры и тело через сгенерированные типы. Если схема запроса содержит data, поместите поля в этот объект. Если используете HTTP-клиент напрямую, сверяйте HTTP-метод, путь и параметры строки запроса с карточкой. Для методов с JSON укажите Content-Type: application/json. Идентификаторы, коды и другие значения берите из задачи или из ответов предыдущих шагов.
5. Перед записью на рабочем стенде подтвердите у пользователя действие и объект. Обработайте ответ по карточке метода. При 401 или 403 остановите сценарий и сообщите, какой вызов отклонён. После тайм-аута или сетевой ошибки при записи сначала проверьте состояние объекта. Если результат установить не удалось, остановитесь и сообщите об этом пользователю.

Сообщите результат и какие шаги остались незавершёнными.

Обработать ответОбработать ответ

Сначала проверьте HTTP-статус, затем прочитайте тело в формате из карточки метода. Если метод возвращает JSON, а клиент передал байты, разберите JSON и только после этого читайте data. Если разобрать тело не удалось, сообщите об ошибке ответа. При скачивании файла сохраните байты успешного ответа. При ошибке скачивания передайте статус и сохраните тело ошибки отдельно от файла.