Agents overview
A Paperwork agent (an agent, for short) is an AI teammate with a job to do. You write down the goal, list the outcomes (tasks) you want, and choose which actions the agent may run. When someone starts a run inside a space, the agent works through the tasks toward that goal. It reads files, searches the knowledge graph, and dispatches actions. It pauses for your approval at the gates you set.
Agents are org-level and reusable. An agent is not tied to one space. You make it available to a space type. Every space created from that type can run it.
Agent definitions are admin-only. The library lives at Agents in the sidebar. If you are not an admin, you see “You need an admin role to manage agents.” Running an agent happens inside a space. Anyone who can contribute there can run one. See Run an agent.
Two run types — keep them straight
A space has both an Agents tab and an Actions tab. They are not the same thing.
This page and the rest of this section cover agent runs (the Agents tab). To run one action over some files, see Run an action.
The agents library
Open Agents to see every agent in your organization. The list has these columns:
Use New agent to start one. See Build an agent for the editor walkthrough.
The lifecycle
Every agent carries a status. It moves through three states.
Runs are always started by a person
There is no trigger or scheduling system. An agent never runs on its own, on a timer, or in response to an event. A person starts every run from a space’s Agents tab.