What makes up an agent?
An agent combines instructions with capabilities that handle customer requests. Playbooks support flexible conversations, workflows define explicit processes, and knowledge and tools supply information and actions. You decide how these pieces fit together.
When to use this model
Use this model when designing an agent or diagnosing unexpected behavior. First identify which part should own the job: routing, a goal-specific conversation, a defined process, a knowledge lookup, or an external action.
How the pieces work together
The agent brings guidance and capabilities together. Its global prompt establishes identity and guardrails; its instructions guide what to do next. Playbooks and workflows handle different kinds of work, supported by knowledge and tools.
What each part contributes
Playbooks or workflows?
A playbook can call tools, and a workflow can include AI reasoning. The distinction is how the process is controlled, not whether it uses AI.
Example: handle a return request
A customer wants to return an item. You want a consistent eligibility process, but customers describe their reasons in different ways. Combine a workflow with a playbook:
The agent recognizes the request and selects your Returns workflow. Inside that workflow, a playbook asks follow-up questions until the return reason is clear. The workflow then uses that information in its eligibility check and follows the appropriate path.
This is an example you can configure, rather than a built-in returns process. The playbook step’s exit connection joins the flexible conversation to the next workflow step. Configure that connection.
Instructions and state have different scopes
The global prompt and agent instructions are different layers. When a playbook is active, agent-level routing instructions are no longer in context; put the guidance it needs in its own instructions. Compare instruction scopes.
A variable is stored data, not the same thing as the model’s current context. Configure where values are captured, where they are referenced, and whether they persist across sessions. Do not assume changing from one capability to another makes all prior instructions available. Understand variables and context.