How Octo works

Spaces

A space is one working agent with its own memory, files, settings and owner. Every conversation Octo works in becomes its own space: a Telegram direct chat or group, a web chat conversation, a Bitrix24 dialog, a Yandex Messenger chat, or a space created through the API.

• The space owner pays for all work in it, including messages from members.
• Spaces are isolated: the memory and files of one space are not visible to another.
• The owner decides who may address the agent: everyone, only selected people, or everyone except blocked people.
• All of an owner's spaces are listed on the Spaces page of the dashboard, grouped by channel.

Channels

A channel is where you talk to the agent. The agent is the same in every channel; only the way messages arrive differs.

• Telegram: direct chats and groups with the @octodus_bot bot.
• Web chat: conversations right in the dashboard.
• Bitrix24: a chat bot in your portal's chats.
• Yandex Messenger: a bot in the chats of a Yandex 360 organization.
• API: your application creates spaces and sends requests over HTTP.

Helpers (sub-agents)

For long tasks the space's main agent starts helpers: separate workers for research, development, content or media. Helpers run in parallel in the space's own isolated environment, and the main agent collects their reports and answers you in the chat.

You can follow each helper on the status page: the Helpers at work and Helper journal panels show the start, the progress and the final report.

Schedules

Ask the agent in the chat to do something regularly, for example "send me a summary every morning at 9". A schedule can run once, daily, weekly, monthly or every N minutes, with active hours and days, in the space's time zone. Every schedule and its next run is listed on the Schedule tab of the status page.

Knowledge bases

A knowledge base holds the documents the agent relies on when it answers. An owner can keep several named bases (for example "sales" and "support"). Each version is approved and then stays unchanged; a space attaches one exact version, so a new version does not change answers until you attach it.

Default upload limits: 20 MB per file, 100 files per base, 500 MB per owner.

The status page

The status page shows what the agent is doing right now and how much energy it spends. It refreshes every 10 seconds. For a single space it also has tabs for helpers, tasks, model policies, settings, knowledge, files, schedule and secrets.