Skip to content
Crystal Desk

AI Agents / Configuring an Agent

Configuring an Agent

Putting an AI Agent on a stage is a configuration change within the workflow builder, not a separate system to set up.

Step 1: set the stage's assignment type to AI Agent

Open the stage's configuration panel (see Building a Workflow) and change the assignee type from a human role to "AI Agent." This replaces the role/skill/roster filtering chain entirely — an AI Agent stage always routes to the agent, not through the human assignment engine.

Step 2: choose an agent type

Select which of the four available agent types (see Agent Types) fits the stage's purpose — Script Drafter for a drafting stage, Reviewer Agent for a review gate, and so on. The agent type determines both what input it expects and what output shape it produces.

Step 3: configure its context

Each agent type is automatically given the ticket's own fields (Subject, custom fields like language and market) as context. For agent types that benefit from more, you can also configure it to receive the outputs of specific prior stages — a Reviewer Agent, for instance, is typically configured to read the Script stage's submitted text as its primary input.

Step 4: how output fills the completion form

When the stage activates, the agent runs automatically, and its output is mapped directly onto the same completion form fields a human assignee would fill in — a Script Drafter's generated text lands in the script_text field exactly as if a writer had typed it there. The stage then completes and routes onward using the same on_submit/on_approve/on_reject rules as any other stage.

An AI Agent stage can still be followed by a human Approval stage — in fact, this is the recommended pattern for anything client-facing, keeping a person as the final sign-off even when the first pass was AI-generated.

For a description of what each specific agent type expects and produces, continue to Agent Types.