Route a task to a specialist agent by explicit intent

Goal

Route requests to the proper specialist and prevent mismatches from being handed off.

Steps

1. List each specialist’s boundaries, acceptance conditions, and explicit exclusions. [openai-handoffs]
2. Give each specialist a concrete handoff_description and register allowed targets in Agent(handoffs=[...]). [openai-handoffs]
3. Use handoff(agent=..., input_type=...) for structured routing fields and check authorization in on_handoff. [openai-handoffs]
4. Provide a clarification or return-to-manager path for boundary cases rather than silently choosing a specialist. [openai-handoffs]
5. Test matching, non-matching, and ambiguous requests for each specialist and check who answers. [openai-handoffs]

How to verify

Routing tests should show the selected specialist and response owner; ambiguous requests should clarify or fall back.

Troubleshooting

If routing is unstable, narrow handoff descriptions and add explicit fallback behavior for ambiguous requests.