Получение результата и событий
Для простой интеграции периодически читайте карточку запуска. Завершённые состояния: 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"Восстановление после разрыва
- Получите историю и сохраните
event_cursor. - Откройте поток с
after, равным этому курсору. - Сохраняйте ID обработанных событий.
- При переподключении передайте последний ID в
Last-Event-ID. Заголовок имеет приоритет надafter. - При недействительном курсоре получите новый снимок истории.
История содержит сообщения и вызовы инструментов. Для полной истории следуйте next_cursor. События также доступны обычными HTTP-запросами.
SSE ускоряет получение обновлений. Проверка текущего состояния и сохранение отметки доставки нужны независимо от соединения. Для потока используйте отдельный HTTP-клиент без короткого таймаута обычных запросов.