Agent object

An agent is a defined set of capabilities that can plan, research, and reason within a workflow. Each agent has a specific type that determines its behavior and domain of expertise — for example, a cip_orchestrator agent coordinates customer identification program reviews, while domain agents handle narrower tasks like address verification or sanctions screening.

Agents are predefined by Middesk; you don’t author your own. To use one, create a Run referencing the agent and its required context. The Run captures the agent’s plan and steps, while Actions capture moments where the agent pauses for human input.

To list the agents available to your account, see the Agents API. For an introduction to the agent model, see Work with agents.

Agent object

1
{
2
  "object": "agent",
3
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
4
  "type": "cip_orchestrator",
5
  "name": "CIP Orchestrator",
6
  "description": "Orchestrates customer identification program reviews across multiple verification domains.",
7
  "created_at": "2026-01-15T12:00:00.000Z",
8
  "updated_at": "2026-01-15T12:00:00.000Z"
9
}

Agent attributes