К содержимому

Получение результата и событий ​

Для простой интеграции периодически читайте карточку запуска. Завершённые состояния: completed, failed, cancelled. Текст ответа находится в final_message.text, если итоговое сообщение есть. Проверяйте и статус, и ошибку: наличие текста само по себе не означает успех.

Для интерфейса с обновлениями используйте SSE:

sh
curl -N "http://localhost:8000/api/v1/sessions/$SESSION_ID/events/stream" \
  -H "Authorization: Bearer $ORPHEUS_API_KEY"

Восстановление после разрыва ​

  1. Получите историю и сохраните event_cursor.
  2. Откройте поток с after, равным этому курсору.
  3. Сохраняйте ID обработанных событий.
  4. При переподключении передайте последний ID в Last-Event-ID. Заголовок имеет приоритет над after.
  5. При недействительном курсоре получите новый снимок истории.

История содержит сообщения и вызовы инструментов. Для полной истории следуйте next_cursor. События также доступны обычными HTTP-запросами.

SSE ускоряет получение обновлений. Проверка текущего состояния и сохранение отметки доставки нужны независимо от соединения. Для потока используйте отдельный HTTP-клиент без короткого таймаута обычных запросов.