DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS /// DOCS
AI AGENTS·OVERVIEW

AI Agents

Onnie ships three agent surfaces. They share the same chat UI and run on the same engine, but each has a different scope and purpose.

Three agents, one engine

Onnie AI is your personal workspace-wide assistant. Every workspace gets an Onnie AI by default — it can see everything in your workspace that you can see, run any tool, and produce Tasks. You don't configure it; you just talk to it.

Onniebots are scoped, configurable AI workers your team builds and maintains. Each Onniebot has its own instructions, a restricted set of tools it can call, and (optionally) a limited view of workspace data. Use them to build specialized agents: a bot that triages items into a table, a bot that handles a specific project's Tasks, or a bot that drafts status updates on demand. Onniebots live alongside your team and can be assigned Tasks directly.

Superagent is the orchestrator that sits under Onnie AI. It has a directory of all Onniebots in the workspace and can delegate work to the right bot — either through a synchronous sub-call (consult_bot) or by creating a Task assigned to a bot. One Superagent is created automatically when a workspace is provisioned. You interact with it every time you talk to Onnie AI.

Where you talk to agents

All three surfaces share the same Chat UI. The composer is at the bottom; the message list sits above it. Before sending your first message, the bot picker in the chat header lets you choose which agent to address. Once a chat has started, the bot is locked to that thread — to switch agents, open a new chat.

What agents can do

  • Read workspace data (projects, tables, records, pages, Tasks, bots) through the explore_* tools.
  • Create, update, assign, complete, cancel, and comment on Tasks.
  • Generate images, run web search, and execute code.
  • Consult other Onniebots and delegate Tasks to bots that accept delegated work.

The Superagent (Onnie AI) can additionally create and update Onniebots and update workspace- or project-level context (admin or editor role required).

What agents can't do

Agents cannot create or mutate arbitrary workspace entities. They can read records, tables, pages, and projects, but direct write access to those entity types is a planned expansion.

Onniebots are further constrained by their configuration: a Onniebot can only call the tools on its allowed_tools list, and skills are filtered to its allowed_skills. A Onniebot does not receive the bot directory and cannot delegate further. If a task exceeds what a Onniebot is configured to handle, route it through Onnie AI instead.