# AI agents

An AI agent is an autonomous AI bot on its own server in the cloud. The Vibecode platform handles the full lifecycle: infrastructure provisioning, bot registration in Bitrix24, installation and configuration of the Hermes runtime, billing, and updates. The agent's own server is charged to the account wallet as a separate item — it is not included in the Cowork subscription. The agent's AI requests are covered by the Cowork subscription quota when that subscription is connected and active. If the agent's key still runs on the legacy scheme, usage beyond the free allowance is charged to the account wallet; if the key already runs on a subscription seat and the subscription is not active, the request is rejected and nothing is charged.

**Base URL:** `https://vibecode.bitrix24.com/v1` · **Authorization:** `X-Api-Key` header

Control panel: [https://vibecode.bitrix24.com/agents](/agents)

On the international `.com` platform, an active Vibe+ trial unlocks agents and managed bots. A regular paid Bitrix24 plan without that trial does not qualify. Access is retained on a paid Vibe+ plan. Managed bots also require the platform's bot feature to be enabled.

The trial permits one VM on the smallest supported plan, shared across agents and managed bots. It does not include Galaxy or paid AI usage beyond the included quota. The trial does not change wallet top-up availability. A managed bot provides the server, API key and Bitrix24 bot registration; it is not a ready-made AI chatbot.

When the trial ends, create and start requests are rejected with `403 VIBE_DEMO_EXPIRED`. The agent or bot is retained, and its demo VM is frozen by the scheduled access check; the physical stop is asynchronous. Viewing, stopping and deleting a retained agent or bot stay available after expiry, so its frozen VM can still be shut down and removed. Buying a Vibe+ plan restores full access but does not start the VM automatically; start it through the usual controls.

## What an agent includes

An agent is an orchestrator over three components:

| Component | Role |
|---|---|
| **Vibecode API key** | A single endpoint for accessing the Bitrix24 REST API |
| **Bot in Bitrix24** | A bot registered via `imbot` that replies in chats |
| **Server in the cloud** | A VM in Bitrix24 Cloud with the Hermes runtime. The platform picks the plan for you, and the machine runs around the clock |

Everything is created in a single action in the [/agents](/agents) dashboard. Deletion cascades and removes all three.

## Creation

In the UI:

1. Open [/agents](/agents) and click "Create Agent"
2. Enter a name and pick an AI model (default is "auto" — the router picks the model for you)
3. Click "Create agent" — provisioning runs in the background (~2–3 minutes)

Once ready, the panel shows a prompt preview and a link to the chat with the bot in Bitrix24.

## Models and billing

- AI tokens: when the Cowork subscription is connected and active and the agent's key runs on a subscription seat, usage draws on the subscription quota from the first token. On the legacy (wallet) scheme the first `agentFreeTokens` are free, and usage beyond that is billed by model and charged to the account wallet (see [AI Router](/docs/ai))
- Server: the agent's own server is charged to the account wallet as a separate item, under ServiceType `AGENT` — a monthly rate metered by the minute. It is not included in the Cowork subscription. An agent on shared placement has no server of its own — there is no separate server line for it
- BYOK (your own OpenAI/Anthropic key): not billed by the platform — you pay only your own provider

## Limitations (beta)

- Cloud servers only (BLACKHOLE mode) — self-hosted servers are no longer supported
- Access to agents is granted by a resolver based on the Bitrix24 account override `Portal.policies.agentsAccess` or the plan policy (`AUTO` / `WAITLIST` / `NONE`); in `WAITLIST` mode, platform-admin approval is required (see `/platform/agents-access`)
- Limit: `maxAgentsPerUser` in Bitrix24 account policies (default 3)
- The `agentCreation` policy: `all` / `admins` / `none`

## Endpoint reference

| Method | Path | Description |
|---|---|---|
| GET | [`/v1/agents`](/docs/agents/list) | List the API key owner's agents and their `bitrixBotId` values for Open Channel binding |

The API only lists agents. Create, update, and delete agents in the [agents dashboard](/agents). `DELETE /v1/bots/:id` deletes a standalone chat bot, not an AI agent.

## See also

- [AI Router](/docs/ai)
- [Infrastructure](/docs/infra)
- [Creating and using a key](/docs/keys-auth)
- [Bot platform](/docs/bots)