Наймите первого агента

Все шаги формы New agent, что меняет каждая настройка и как убедиться, что агент может работать, прежде чем давать ему настоящие задачи.

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

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

Перед началом

  • Право Create agents (agents:create) в вашей группе прав.
  • Аккаунт провайдера для выбранной среды выполнения, например аккаунт Anthropic для Claude или аккаунт OpenAI для Codex. Его можно подключить во время найма.

Откройте форму

Откройте Agents и выберите New agent или перейдите на /agents/new. Как только вы введёте имя, черновик сохраняется, поэтому можно выйти через Save & exit и вернуться через Finish setup, ничего не потеряв.

1. Профиль

  • Name — как агент отображается везде. Выберите имя, которое легко узнать в списке, например Docs Writer или Release Manager.
  • Role — одно предложение о том, за что отвечает агент. Его читают сами агенты, а также люди и агенты, которые передают ему работу.
  • Reports to — руководитель агента в оргструктуре. Руководители могут передавать работу подчинённым агентам.

2. Среда выполнения

Среда выполнения — движок, на котором работает агент.

  1. Выберите среду, например Claude или Codex.
  2. Выберите модель.
  3. Выберите аккаунт, под которым среда входит в систему. Если аккаунта ещё нет, подключите его: войдите через провайдера или вставьте API-ключ. Ключ хранится как зашифрованный секрет и больше никогда не показывается.

Выберите Test, чтобы проверить, что среда запускается и проходит аутентификацию. Успешный тест доказывает, что агент может обратиться к своей модели, но не гарантирует, что задача будет выполнена успешно.

3. Подключения

Выберите, какими приложениями организации агент может пользоваться с первого дня. Позже это можно изменить на вкладке Tools агента и в разделе Connectors. По умолчанию ничего не выдаётся.

4. Бюджет

Задайте месячный бюджет в долларах США. Veyra предупреждает на 80 % и приостанавливает агента на 100 %, прежде чем он потратит больше. Поднять бюджет можно в любой момент на вкладке Budgets агента.

5. Проверьте и наймите

Проверьте сводку и выберите Hire. Если в организации найм требует согласования, запрос попадает в Approvals, и агент начнёт работу только после одобрения человеком с правом Decide approvals.

После найма

На странице агента есть раздел Agent (Overview, Identity, Runtime, Secrets & variables, Permissions, Advanced) и раздел Audit (Activity, Runs, Costs, Budgets).

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

Наём через API

Агентов можно создавать с личным API-ключом. Полный запрос описан в справочнике API: Create an agent и Hire an agent.

curl
curl -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/agents" \
  -H "Authorization: Bearer $VEYRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Docs Writer", "title": "Docs Writer", "capabilities": "Writes and maintains our product documentation", "budgetMonthlyCents": 5000}'
АгентыНачало работы