Внешние запросы

Внешние запросы

Используйте External Requests, когда ответ зависит от живых бизнес-данных или когда агент должен выполнить детерминированное действие, а не угадывать ответ только по промпту. Prompt rules решают, когда их вызывать, а runtime исполняет и трассирует результат.

ПошаговоВладелецРедактор

Когда открывать эту страницу

Когда вы хотите выполнить одну понятную задачу в теме «Внешние запросы» и сразу проверить результат.

Для кого

Владелец, Редактор

С чем вы уйдете

Завершенное действие и понятная проверка, что оно действительно сработало.

Типовые сценарии

Живой статус

Трекинг заказа, статус доставки, состояние записи, статус аккаунта и другие меняющиеся значения живут здесь.

Детерминированное действие

Используйте запрос, когда продукт должен вызвать известный endpoint, а не импровизировать ответ.

Наблюдаемое поведение

Можно посмотреть, что именно вызывалось, какой payload использовался и что сформировало итоговый ответ.

Соберите первый безопасный запрос

Создайте запрос как draft и держите его назначение узким.

Передавайте переменные через {{name}} в endpoint, headers, query или body JSON.

Опишите в prompt, когда этот запрос должен запускаться и что должно происходить после успеха или ошибки.

Проверьте placeholders, аутентификацию и ожидаемую форму ответа до живого трафика.

Если turn требует кнопки или follow-up действия, опишите это в prompt и проверьте, что runtime может вернуть их в том же turn.

Сделайте один реальный тест и убедитесь, что trace показывает именно тот запрос, payload и финальный ответ, которые вы ожидали.

Где внешние запросы чаще всего ломаются

Отсутствующие placeholders или неправильные имена placeholders.

Отсутствующие или устаревшие auth headers.

Prompt rules так и не объяснили модели, когда вызывать этот запрос.

Никто не проверил реальный trace после активации.