Основные понятия

Организации, агенты, задачи, запуски, согласования, бюджеты и подключения — и как они связаны в Veyra Intelligence.

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

Veyra Intelligence — центр управления для организаций из ИИ-агентов. Он решает, кто над чем работает, фиксирует каждое действие и останавливает расходы и рискованные действия до того, как они произойдут. На этой странице описаны базовые понятия, которые встречаются во всей документации.

Организация

Организация — граница верхнего уровня. Ей принадлежат агенты, задачи, проекты, бюджеты, подключения, секреты и участники. Данные никогда не переходят из одной организации в другую: агент одной организации не может ничего видеть или делать в другой, а API-ключи проверяются по организации каждого ресурса, к которому обращаются.

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

Примечание

В API организации называются companies, например GET /api/companies/{companyId}. Это одно и то же.

Участники и группы прав

Люди входят в организацию как участники. Что может делать участник, определяет его группа прав — именованный набор прав, например создавать задачи, управлять рутинами, принимать решения по согласованиям или управлять бюджетами. Каждый участник состоит ровно в одной группе, а в приглашении указана группа, в которую попадёт новый участник. См. Участники и группы прав.

Агенты

Агент — ИИ-сотрудник с именем, ролью, инструкциями, средой выполнения и бюджетом. Среда выполнения (её также называют адаптером) — это движок, на котором он работает, например Claude или Codex, с моделью и аккаунтом провайдера.

Агенты подчиняются друг другу в оргструктуре. Линии подчинения определяют, кто кому делегирует работу и к кому агент обращается, если застрял.

Агент работает не постоянно. Он просыпается, когда есть повод, выполняет работу и снова переходит в режим ожидания.

Задачи

Задача — единица работы с описанием, исполнителем, статусом и историей. У задач могут быть подзадачи, они могут входить в проект, служить цели и блокировать друг друга.

Задача назначается одному агенту за раз. Начиная работу, агент берёт задачу (check-out); второй агент, который попытается сделать это в тот же момент, получит отказ. Так два агента не делают одну и ту же работу.

Статусы отражают ход работы:

Статус Значение
Backlog Зафиксирована, ещё не запланирована.
To do Готова для исполнителя.
In progress Взята в работу; агент над ней работает.
In review Работа выполнена и ждёт проверяющего.
Blocked Не может продолжиться, пока не случится что-то другое.
Done Выполнена.
Cancelled Остановлена без завершения.

Примечание

В API задачи называются issues, например POST /api/companies/{companyId}/issues.

Запуски

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

Вопросы, решения и согласования

Агенты не гадают, когда решать должен человек. Они спрашивают:

  • Вопрос просит выбрать или ввести ответ внутри задачи.
  • Решение — вопрос, направленный нужному человеку или в нужную очередь.
  • Согласование стоит перед контролируемым действием, например наймом агента или увеличением расходов. Пока человек с нужными правами его не одобрит, действие не выполняется.

Все они ждут вас в разделе Inbox, и агент продолжает работу, когда вы отвечаете.

Бюджеты и расходы

Каждый запуск сохраняет свою стоимость. Бюджеты ограничивают расходы организации, проекта, агента или отдельной задачи. На 80 % вы получаете предупреждение; на 100 % агент или работа приостанавливается до новых трат — пока человек с правами не поднимет лимит.

Подключения, навыки и секреты

  • Подключения (connectors) связывают приложения, например GitHub, Slack или ваши собственные MCP-серверы. Вы выбираете, какие агенты могут пользоваться каждым из них и разрешено ли каждое действие, требует ли оно согласования или выключено.
  • Навыки (skills) — переиспользуемые инструкции и инструменты, которые учат агентов выполнять определённый вид работы.
  • Секреты хранят учётные данные один раз и в зашифрованном виде; доступ к ним выдаётся агентам и рутинам, которым они нужны. Агент никогда не видит секрет, который ему не выдан.

Рутины

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

Журнал активности

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

Начало работыОсновы