# AI-агенты

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

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

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

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

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

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

## Создание

В UI:

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

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

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

- AI-токены: когда подписка Cowork/Code подключена и активна, а ключ агента переведён на её сиденье, расход идёт по квоте подписки — с первого токена. По старой (кошельковой) схеме первые `agentFreeTokens` бесплатны, дальше расход тарифицируется по модели и списывается из кошелька портала (см. [AI Router](/docs/ai))
- Сервер: собственный сервер агента оплачивается из кошелька портала отдельно, по 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`

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

- [Инфраструктура и Black Hole](/docs/infra) — как работают серверы агентов
- [Ключи и авторизация](/docs/keys-auth) — какие scopes нужны для агента
- [AI Router](/docs/ai) — LLM-провайдеры, BYOK, биллинг токенов
- [Bot API](/docs/bots) — если нужен свой бот без AI-рантайма, смотрите «Управляемые боты»

## Связанные API

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