docs/usage/agent/agent-team.mdx
One Agent's perspective is rarely enough. Complex problems need multiple angles; creative projects thrive on diverse expertise; decisions benefit from structured debate. Agent Group Chat assembles a team of specialized Agents that work together like a real group — a research Agent, an analysis Agent, and a writing Agent each contributing their strengths to your task. You're not just getting an answer; you're running a coordinated process.
Pose a question or task, and each Agent responds from its area of expertise. They can build on each other's outputs, challenge assumptions, or work in parallel — depending on the mode you choose.
Agent Groups fix all three.
Agent Groups adapt to the task:
Sequential — Agents work one after another in a defined order. Example: Research Agent gathers information → Analysis Agent processes data → Writing Agent creates the final document. Best for linear workflows with clear handoff points.
Parallel — Multiple Agents tackle different aspects simultaneously. Example: Marketing Agent writes copy while Data Agent compiles metrics. Best for independent subtasks.
Iterative — Agents review and refine work through multiple rounds. Example: Writer creates draft → Editor provides feedback → Writer revises → Editor does final review. Best for high-quality output that requires polish.
Debate — Agents argue different positions. An advocate makes the case, a critic challenges assumptions, an analyst weighs evidence, and a mediator synthesizes conclusions. Best for complex decisions that benefit from structured disagreement.
Every Agent Group includes a built-in moderator responsible for:
Click Create Group in the left sidebar to get started.
When creating a group, you can start from an existing template or assemble your own team. Choose whether to include a moderator and select the model for it.
In the group chat session, select an Agent in the left sidebar to swap its model or remove it from the group.
Click Add Member in the left sidebar to bring additional Agents into the group.
Go to Group Profile in the left sidebar to edit the group prompt, add Skills, or change the moderator model. You can also use Agent Builder on the right panel — describe your goal and it will generate the complete group configuration, including settings, system prompts, and Skill setup.
A sequential workflow for producing blog posts or articles:
Define clear roles — Each Agent should have a specific, well-defined responsibility:
Avoid redundancy — Don't create multiple Agents with overlapping roles. Each Agent should bring unique value.
Set clear handoff points — In sequential workflows, define exactly what each Agent passes to the next. Example: "Research Agent outputs a Markdown document with sources, key points, and data. Writer Agent uses this as input to draft."
Right-size the team — More Agents does not mean better results. Start with 2–3 Agents and add more only as needed. Too many Agents slow the workflow without adding value.
Match models to tasks — Use capable models where reasoning matters; use faster, lighter models for straightforward steps.
Content production — Blog posts (research → write → edit → SEO), social media campaigns, documentation, video scripts.
Business analysis — Market research, competitive analysis, financial modeling, risk assessment.
Software development — Feature development (requirements → design → code → testing), code review, bug fixing, API design.
Creative projects — Story development, marketing campaigns, product naming, design critique.
Group responds too slowly — Reduce the number of Agents, use lighter models for simple steps, switch to parallel mode when possible, or simplify Agent system roles.
Inconsistent outputs — Add clearer role definitions, include shared guidelines in the group context, add a reviewer Agent, or lower the temperature setting.
Agents not collaborating well — Explicitly define what each Agent receives and produces, add transition instructions between Agents, or switch to sequential mode.
Poor quality results — Upgrade to a better model for critical Agents, add specialist Agents for key areas, include a quality-control Agent, or write more detailed system roles.
<Cards> <Card href={'/docs/usage/getting-started/agent'} title={'Agent'} /><Card href={'/docs/usage/agent/scheduled-task'} title={'Scheduled Tasks'} />
<Card href={'/docs/usage/getting-started/page'} title={'Pages'} /> </Cards>