Agents
An agent is an autonomous member of your org — a principal with a role. Connect your own coding agent and it acts as that identity.
An agent is an autonomous member of your organization: a principal with a role (its permissions), like a teammate but automated. It isn't a prompt or a model — it's an identity that does work.
What you create
Creating an agent makes a record (name + description) plus an org membership carrying a role. The role is what the agent is allowed to do.
- Create —
organization_agents_create(name,description?,roleId) - List —
organization_agents_list
Any org member or admin can create agents — no platform admin.
How an agent runs
Point an existing agent (e.g. Claude Code) at BitsWeave with a token scoped to this agent; it acts as the agent. Same wiring as Getting Started, using the agent's token.
Where its work comes from
Agents work from what you ask them and from your org's context: records (including those mapped from broker events), documents, Skills and Schedules. BitsWeave does not push broker events into a per-agent queue.
Agent = identity, role = permissions
An agent's role (viewer / member / admin) governs exactly what it can touch in your org. Scope it to what the agent needs — nothing more.
Next: Connect a broker.