Для AI-агентов: markdown этой страницы — /docs-content/agents.md индекс документации — /llms.txt

AI-агенты

AI-агент — это автономный AI-бот на собственном сервере в облаке. Платформа Вайбкод берёт на себя полный жизненный цикл: предоставление инфраструктуры, регистрацию бота в Битрикс24, установку и настройку рантайма Hermes, биллинг и обновления. Собственный сервер агента оплачивается из кошелька портала отдельно — в подписку Cowork/Code он не входит. AI-запросы агента идут по квоте подписки Cowork/Code, когда она подключена и активна. Если ключ агента ещё работает по старой схеме, расход сверх бесплатного лимита списывается из кошелька портала; если ключ уже переведён на сиденье подписки, а подписка не активна — запрос отклоняется, и списания не происходит.

Панель управления: https://vibecode.bitrix24.tech/agents

Что входит в агент

Агент — оркестратор над тремя компонентами:

Компонент Роль
API-ключ Вайбкод Единый endpoint для доступа к REST Битрикс24
Бот в Битрикс24 Зарегистрированный через imbot бот, отвечает в чатах
Сервер в облаке VM в Bitrix Cloud с рантаймом Hermes. По умолчанию — вытесняемый (preemptible) тариф (дешевле, облако перезапускает ~раз в сутки); включите «Всегда онлайн» при создании для непрерывной 24/7-работы на невытесняемом тарифе

Всё создаётся одной операцией POST /api/agents. Удаление каскадно снимает все три.

Создание

В UI:

  1. Открыть /agents, нажать «Создать агента»
  2. Указать имя + выбрать AI-модель (по умолчанию «авто» — роутер сам подбирает модель)
  3. Нажать «Создать» — провижининг идёт в фоне (~2–3 минуты)

После готовности в панели отобразится промпт-превью и ссылка на диалог с ботом в Битрикс24.

Модели и биллинг

  • AI-токены: когда подписка Cowork/Code подключена и активна, а ключ агента переведён на её сиденье, расход идёт по квоте подписки — с первого токена. По старой (кошельковой) схеме первые agentFreeTokens бесплатны, дальше расход тарифицируется по модели и списывается из кошелька портала (см. AI Router)
  • Сервер: собственный сервер агента оплачивается из кошелька портала отдельно, по ServiceType AGENT — поминутная помесячная ставка. В подписку Cowork/Code он не входит. Агент на общем размещении собственного сервера не имеет — отдельной строки за сервер у него нет
  • BYOK (свой ключ OpenAI/Anthropic): не тарифицируется платформой — только свой провайдер

Ограничения (beta)

  • Только cloud-серверы (BLACKHOLE mode) — собственные серверы больше не поддерживаются
  • Доступ к агентам выдаётся резолвером по портальному override Portal.policies.agentsAccess или политике тарифа (AUTO / WAITLIST / NONE); в режиме WAITLIST нужно подтверждение platform-admin (см. /platform/agents-access)
  • Лимит: maxAgentsPerUser в портальных политиках (по умолчанию 3)
  • Политика agentCreation: all / admins / none

Связанные темы

Связанные API

Методы управления агентами — в session-auth панели /api/agents/* (не V1 API). V1 API для агентов пока не публикуется — используйте UI или спросите в поддержке.