Запуски и расшифровки

Читайте шаг за шагом, что агент сделал в запуске; почему запуски начинаются; как отменять, повторять и отлаживать их и как получать события запусков через API.

Veyra Docs TeamОбновлено 1 мин чтенияВерсия 2 · История

Запуск — один рабочий сеанс агента. Он фиксирует каждый шаг: что разбудило агента, что он прочитал, какие инструменты вызвал, что написал и сколько это стоило. Когда что-то идёт не так, запуск показывает, где именно.

Почему начинаются запуски

Триггер Пример
Назначение Агенту назначили задачу.
Упоминание Агента упомянули в комментарии.
Ответ Вы ответили на вопрос или запрос согласования агента.
Расписание или рутина Подошло время рутины.
Снятие блокировки Завершилась задача, которую ждала эта.
Вручную Кто-то нажал Run now.

Откройте запуск

В задаче откройте запуск из её ленты. У агента откройте Runs. Каждый запуск доступен по адресу /agents/<agent>/runs/<run>.

На странице запуска показаны:

  • Статус: в очереди, выполняется, успешно, ошибка или отменён.
  • Расшифровка: сообщения агента, вызовы инструментов с входными данными и результатами, ошибки.
  • Стоимость: токены и деньги по моделям.
  • Рабочее пространство: где выполнялся запуск и что изменил.
  • Задачи, которых коснулся запуск.

Отмена и повтор

Stop отменяет выполняющийся запуск. Retry после сбоя начинает новый запуск той же работы. Повтор никогда не повторяет шаг, уже успешно выполненный вне Veyra, например отправленное письмо: агент видит, что произошло раньше.

Отладка

Для сложных проблем включите Capture raw provider traces в настройках агента Advanced. Следующие запуски сохранят точный обмен с провайдером со скрытыми чувствительными данными, чтобы его можно было изучить. Закончив, выключите настройку; трассировки можно удалить.

Через API

curl
# A run and its events
curl "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID" -H "Authorization: Bearer $VEYRA_API_KEY"
curl "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID/events" -H "Authorization: Bearer $VEYRA_API_KEY"

# Cancel it
curl -X POST "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID/cancel" -H "Authorization: Bearer $VEYRA_API_KEY"

См. Get a run, Get events for a run, Cancel a run и раздел Запуски.

АгентыЗапускиНаблюдаемость