Наймите первого агента
Все шаги формы New agent, что меняет каждая настройка и как убедиться, что агент может работать, прежде чем давать ему настоящие задачи.
Наём агента создаёт сотрудника с именем, ролью, инструкциями, средой выполнения и бюджетом. В этом руководстве описан каждый шаг формы и то, как проверить агента, прежде чем на него полагаться.
Перед началом
- Право 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. Среда выполнения
Среда выполнения — движок, на котором работает агент.
- Выберите среду, например Claude или Codex.
- Выберите модель.
- Выберите аккаунт, под которым среда входит в систему. Если аккаунта ещё нет, подключите его: войдите через провайдера или вставьте 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 -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}'См. также
- Агенты: всё, что можно изменить после найма.
- Бюджеты и расходы
- Согласования