[Feature Request]: Document Swarm patterns

[marklysze]

Is your feature request related to a problem? Please describe.

Create a set of Swarm patterns that can be coded up and written about to give people a starting point.

Please provide suggestions for patterns.

Describe the solution you'd like

No response

Additional context

No response

[marklysze]

CC @AgentGenie

[AgentGenie]

I think the following patterns are good to cover:

1. Deterministic handoff
2. Conditional handoff based on context variable
3. Routing
4. Input/Output guardrails and evaluation

[marklysze]

Thanks @AgentGenie!

For:
1 - do you mean to create an example pattern? Some already have deterministic handoffs with OnContextCondition, but please provide another example if you mean something else.
2 - this is in some of the examples, do you mean making a more prominent note of this in the examples?
3 - can you provide a use-case example so I can see if it's already covered
4 - I think I understand, and like this idea, do you mean where an agent checks inputs and/or outputs of another agent?

[AgentGenie]

1 - do you mean to create an example pattern? Some already have deterministic handoffs with OnContextCondition, but please provide another example if you mean something else.
2 - this is in some of the examples, do you mean making a more prominent note of this in the examples?

We can either link to the examples or create new one if not exists.

3 - can you provide a use-case example so I can see if it's already covered.
The triage agent in DocAgent and triage agent in your trip planning agent may be good examples.

4 - I think I understand, and like this idea, do you mean where an agent checks inputs and/or outputs of another agent?
Yes this is a common use case. We can do this via either agents or in handoff functions.