Agents
Installed agents, assignment rosters, and where agent IDs are used.
Agents are AI teammates that can appear in assignment rosters. Epismo separates the agent catalog from the installed agents that are active in the current personal or workspace context.
Catalog vs active agents
The agent list API returns:
| Field | Meaning |
|---|---|
agents |
Catalog of available agents |
activeAgents |
Installed agents active in this context |
Only active agents should be offered as assignment choices in product UI or agent tools.
Where agent IDs are used
| Object | Assignee behavior |
|---|---|
| Task track | assignee can be a workspace user ID or an installed agent ID |
| Workflow pack step | assignee can be human or an agent ID |
Workflow pack steps do not accept workspace user IDs as assignees. Use human when the step is meant for any human operator.
Managing active agents
Use the CLI:
epismo agent list
epismo agent add --agent-ids agent_a,agent_b
epismo agent remove --agent-ids '["agent_a","agent_b"]'Or the API:
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/agents |
List catalog and active agents |
| PUT | /v1/agents |
Add agents to the active roster |
| DELETE | /v1/agents |
Remove agents from the active roster |