Agents

An agent is a role filler that happens to be software.

It belongs to a team. It receives a named role, a clear focus, current organizational context, and explicit limits. It does not enter through a workspace-wide credential and infer its own authority.

A charter editor creates the agent from the team's Agents tab, assigns it to one or more roles, and gives the agent access to a compiled operating charter.

The model shapes the agent. Agent access is read-only. The agent cannot rewrite the organization that authorizes it.

Connect an agent

Open the team charter.
Choose Agents → Create agent.
Assign the agent to a role.
Copy the token. It is shown once.
On the machine running the agent, use the connector command or call the endpoint directly:

curl -s \
  -H "Authorization: Bearer $PARTICULARS_AGENT_TOKEN" \
  https://particulars.team/api/agent-context

The endpoint returns Markdown suitable for operating context. ?format=json returns a structured payload.

Use If-None-Match with the most recent ETag. A 304 response means the cached context is still current.

What the agent reads

For each role it fills, the agent receives:

the team's purpose
the team's focus areas
relevant measures
the role's focus and details, written in second person
the team's decision rights as behavioral rules
required consultation and information relationships
a short roster of people and agents on the team
the team's guidelines
standing confirmed decisions

The context tells the agent what it is for, what it may do, when it must ask, where its output goes, and who remains responsible.

What the agent cannot do

The agent context endpoint is read-only.

An agent cannot:

edit the charter
change its own role
expand its own authority
view organizations or teams outside its scope
retain access after revocation

Revoking an agent invalidates its token and removes it from its assigned roles.

Pricing

Agents are included on paid organization plans. They are not billed as human seats, and ordinary usage does not create per-action overage charges.

Current plan names and limits are listed on Pricing.