Agents - Comms

Agents are the product path for teams that want Comms to own free-form conversation: instructions, knowledge, tools, and human handoff. You do not need an agent to use the Messages API. Keys talk to the line directly.

When to use an agent

Use an agent	Use the API only
Customers text free-form questions	System events (receipts, status, ops)
You want Creed / knowledge without code	Your product already owns the copy
Human handoff rules matter	Fully automated pipelines

Create an agent

Agents are created through your own AI connected over MCP:

Open MCP in the dashboard and connect Claude, Cursor, or any MCP client.
Ask it to create the agent — describe the job in plain English and it calls osis_comms_create_agent with a full creed.
Confirm the line and test from the inbox.

Combined pattern

Many production systems use both:

Your backend sends operational messages via Send a message.
An agent answers open-ended replies on the same line.
Inbox handoff brings a human in when needed.

See How Comms works and Architecture.