What problem does it solve?
Enables an agent to consult, delegate tasks to, or continue a conversation with another agent so that specialized judgment, review, or multi-turn collaboration can be obtained without losing context.
Core Features & Use Cases
- Agent discovery and selection: Use list_agents() to find the best-fit agent based on descriptions and extract its ID for addressing.
- Foreground and background interactions: Start live help with chat_with_agent(...) for immediate replies or submit_to_agent(...) for longer background tasks and then check_agent_task(...) for status.
- Session continuity and handoff: Preserve multi-turn context by passing session_id to continue conversations or resume prior sessions.
- Use Case: When a user requests expert review of a technical design, list available agents, choose a reviewer agent, and start a chat_with_agent request including context and session_id to get a precise second opinion.
Quick Start
List available agents, pick the best match, and initiate a chat_by calling list_agents() then chat_with_agent(to_agent="<id>", text="[Agent <your_agent_id> requesting] Please review this and advise.", session_id="<optional_session_id>").