Creating Agents

Create agents from the Agents Workshop with a clear role, a bounded toolset, and a prompt the orchestrator can trust.

Before You Create

Decide the job first. A strong agent begins with a narrow responsibility such as "summarize workflow traces" or "prepare a release status report." If you cannot describe the job in one sentence, it is too broad.

Workshop Flow

1. Open the Agents Workshop.
2. Create a new agent or duplicate a similar one.
3. Set the name and instructions around one responsibility.
4. Attach only the tools that role should be allowed to use.
5. Save, then test it through a conversation or workflow run.

Model and Tools

Pair the model to the job. Use stronger reasoning models for planner or review work. Use smaller local models when low latency and cost control matter more than nuance. Every tool you attach increases the room for bad execution, so treat tool assignment like permissioning, not decoration.

{
  "name": "release-analyst",
  "model": "qwen2.5:7b-instruct",
  "instructions": "Summarize release work, call out operator risk, and avoid unsupported claims.",
  "tools": ["charting"]
}

Good Agent Shape

• One clear responsibility.
• One obvious model choice.
• Minimal tools.
• Outputs that a supervisor can verify.

Next Steps

Continue with Agent Configuration and then review Supervisor Concepts so the new agent has a proper execution home.