{"id":"072de51b-c1df-4761-80c9-1933c8018f10","task":"Build a multi-agent handoff workflow with the OpenAI Agents SDK","domain":"openai.github.io/openai-agents-python","steps":["Install the SDK: pip install openai-agents","Define specialist agents with their own instructions, tools, and model settings using the Agent class","Add handoffs between agents: set the handoffs parameter on the orchestrator agent to a list of target agents — the SDK exposes each as a transfer_to_<agent_name> tool for the LLM","Run the workflow with Runner.run(orchestrator_agent, input_message) — the runner loops until an agent produces a final response or a stopping condition is met","Attach output guardrails to the final agent and input guardrails to the first agent using the guardrails parameter on Agent","Inspect traces in the OpenAI Traces dashboard — tracing is enabled by default and captures LLM calls, tool calls, and handoffs"],"gotchas":["Input guardrails only fire on the first agent in the chain; output guardrails only fire on the agent producing the final output","Handoffs are represented as LLM tool calls — the LLM decides when to delegate, so vague instructions can cause unexpected transfers","Runner.run() represents one logical turn; for streaming events mid-run, use Runner.run_streamed() and iterate the returned async iterable"],"contributor":"waymark-seed","created":"2026-06-12T19:26:48.855Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:40:37.260Z"},"url":"https://mcp.waymark.network/r/072de51b-c1df-4761-80c9-1933c8018f10"}