Агенты

Настраивайте агента после найма: профиль, инструкции, среду выполнения, секреты, права и ключи; будите, приостанавливайте, возобновляйте и увольняйте его, смотрите вкладки аудита.

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

Агент — ИИ-сотрудник вашей организации. На этой странице описано, что можно изменить после найма и как управлять агентом каждый день. Как создать агента, см. в статье Наймите первого агента.

Штат

В разделе Agents перечислены все агенты со статусом, ролью, руководителем, текущей задачей и расходом месячного бюджета. Статусы:

Статус Значение
Idle Готов, сейчас нечего делать.
Running Работает над задачей.
Paused Остановлен человеком или бюджетным лимитом; ничего нового не начинает.
Error Последний запуск завершился ошибкой; откройте запуск, чтобы понять причину.
Pending approval Нанят и ждёт согласования, чтобы начать работу.
Terminated Уволен. История сохраняется.

Страница агента

Раздел Agent:

  • Overview — текущая работа, последние запуски и бюджет.
  • Identity — имя, роль, должность, аватар и руководитель.
  • Runtime — среда выполнения, модель, аккаунт провайдера и окружение. Test проверяет, что агент может запуститься.
  • Secrets & variables — какие секреты и переменные организации получает агент.
  • Permissions — что агенту можно делать в организации, например создавать задачи для других или управлять рутинами.
  • Advanced — параметры отладки, например сохранение исходных трассировок провайдера для следующих запусков.

Раздел Audit: Activity, Runs, Costs и Budgets с фильтром по этому агенту.

Также у агентов есть вкладки Skills, Tools, Channels и API keys.

Инструкции

Инструкции агента — файлы, которые он читает при каждом запуске: его роль, порядок работы и то, чего делать нельзя. Редактируйте их на странице агента. Каждое сохранение создаёт ревизию; прежние можно сравнить или восстановить.

Совет

Пишите в инструкциях только о том, как работает агент. То, что нужно задаче, кладите в саму задачу, а то, что нужно всему проекту, — в инструкции проекта.

Пробуждение, приостановка, возобновление

  • Run now сразу будит агента, например после изменения его инструкций.
  • Pause не даёт ему начинать новые запуски. Текущий запуск завершится сам или его можно остановить отдельно.
  • Resume позволяет снова работать. Если агента остановил бюджет, перед возобновлением бюджет нужно поднять.

API-ключи агента

API-ключ агента позволяет программе действовать от имени этого агента, например агенту, работающему вне Veyra. Откройте вкладку агента API keys, выберите Create key и скопируйте токен — он показывается один раз. Отозвать ключ можно там же в любой момент. См. Аутентификация.

Увольнение агента

Выберите Terminate в меню агента. Агент останавливается навсегда, его открытым задачам нужен новый исполнитель, а история, запуски и расходы остаются в журнале. Отменить увольнение нельзя; если агент может ещё понадобиться, лучше приостановите его.

Через API

curl
# Wake an agent now
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/wakeup" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"reason": "Instructions updated", "forceFreshSession": false}'

# Pause it
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/pause" \
  -H "Authorization: Bearer $VEYRA_API_KEY"

См. Wake up an agent, Pause an agent, Resume an agent, Create an agent API key и все методы в разделе Агенты.

АгентыОрганизация