Агенты
Настраивайте агента после найма: профиль, инструкции, среду выполнения, секреты, права и ключи; будите, приостанавливайте, возобновляйте и увольняйте его, смотрите вкладки аудита.
Агент — ИИ-сотрудник вашей организации. На этой странице описано, что можно изменить после найма и как управлять агентом каждый день. Как создать агента, см. в статье Наймите первого агента.
Штат
В разделе 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
# 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 и все методы в разделе Агенты.