---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
description: Как выбрать сценарий и стенд, подготовить запрос и обработать ответ.
vcsPath: motorway/magacg/support/docs/src/ru-x-ai/concepts/agent-workflow.md
updatedAt: '2026-11-12T12:16:53.000Z'
alternate:
  - href: https://yamagistrali.ru/docs/ru-x-ai/concepts/agent-workflow.md
    type: text/markdown
    title: Markdown version
  - href: https://yamagistrali.ru/docs/ru-x-ai/llms.txt
    rel: describedby
---

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

1. Выберите в `llms.txt` сценарий по задаче и роли в нужной организации. Уточните роль, объекты и ожидаемый результат, если по запросу их нельзя определить однозначно.
2. Начинайте с тестового стенда `https://partner-test-yamagistrali.ru`. Используйте рабочий стенд `https://yamagistrali.ru`, если пользователь явно выбрал его. Идентификаторы, доступ и токены проверяйте на выбранном стенде.
3. Используйте [клиент, сгенерированный из OpenAPI](https://yamagistrali.ru/docs/ru-x-ai/guides/generate-client.md). Для защищённых методов настройте [доступ к выбранному стенду](https://yamagistrali.ru/docs/ru-x-ai/guides/api-access.md). Если способ передачи токена клиенту ещё не настроен, [согласуйте его с пользователем](https://yamagistrali.ru/docs/ru-x-ai/guides/secrets.md). Если для задачи нужно действовать от имени организации, [проверьте профиль и уточните выбор при необходимости](https://yamagistrali.ru/docs/ru-x-ai/guides/api-access.md#verify-access).
4. Перед вызовом откройте карточку метода и проверьте [правила работы с персональными и чувствительными данными](https://yamagistrali.ru/docs/ru-x-ai/concepts/sensitive-data.md). Передайте параметры и тело через сгенерированные типы. Если схема запроса содержит `data`, поместите поля в этот объект. Если используете HTTP-клиент напрямую, сверяйте HTTP-метод, путь и параметры строки запроса с карточкой. Для методов с JSON укажите `Content-Type: application/json`. Идентификаторы, коды и другие значения берите из задачи или из ответов предыдущих шагов.
5. Перед записью на рабочем стенде подтвердите у пользователя действие и объект. [Обработайте ответ](https://yamagistrali.ru/docs/ru-x-ai/concepts/agent-workflow.md#read-response) по карточке метода. При `401` или `403` остановите сценарий и сообщите, какой вызов отклонён. После тайм-аута или сетевой ошибки при записи сначала проверьте состояние объекта. Если результат установить не удалось, остановитесь и сообщите об этом пользователю.

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

## Обработать ответ {#read-response}

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