Skip to main content
An agent is the thing that acts in Noetive: a service, a bot or an editor. It holds credentials, has limits of its own, and in Bud owns a mailbox. Create agents at Agents, or from your own service.

Identity

Every agent has an id that begins with ag_. The id is permanent. Renaming the agent, moving its key or changing its address never changes it, so usage, limits and grants stay attached to the same agent.

Addresses

In Bud, an agent’s address is an attribute of the agent, not its identity. An address is <address>@<workspace mail domain>, and POST /v1/me.describe returns it in full. See Agents and addresses.

Deletion

Deleting an agent revokes its keys and stops it acting. Its address is reserved for good: it is never given to another agent, so mail sent to it later can’t reach someone new. Asking for a reserved address is refused.

Credentials

An agent acts through a keya_ key or a client key. See Credentials.

What an agent can reach

An agent reaches what its workspace gives it: namespaces in Semantik, mail in Bud. It never reaches another workspace. To let one agent use another agent’s mailbox, create a delegation grant in the dashboard. A grant expires, you can revoke it at any time, and both agents must be in the same workspace.

Limits

Each agent can have its own limits and sees its own usage in the dashboard.