# Practical and Useful Patterns for OpenAI Agent SDK 🌍 See what's happening inside your agents. Built-in tracing captures every LLM call, tool execution, handoff, and guardrail evaluation in your agent flow. Tracing is enabled by default. Visualize agent behavior in the Traces dashboard to accelerate debugging and quality improvement. 📌 Title: Tracing 🔗 URL: 🧩 Overview The OpenAI Agent SDK's built-in tracing automatically records every step of agent execution -- LLM calls, tool executions, handoffs, and guardrail evaluations. It's enabled by default and visualized in OpenAI's Traces dashboard. Group related runs with `with trace("name")`, ensure trace delivery in worker environments with `flush_traces()`, and control privacy with `RunConfig(trace_include_sensitive_data=False)` or environment variables. 🛠 How to Use Import `Agent`, `Runner`, and `trace` from `agents`. Create an `Agent` and run it with ` "What are the latest AI trends?")` -- tracing is automatically enabled by default, recording all LLM calls and tool executions. 🏗 Practical Usage Patterns **Grouping Related Runs with trace()** Bundle multiple agent runs into a single trace for a bird's-eye view of the entire workflow. Import `trace` from `agents` and wrap multiple ` calls inside a `with trace("Joke workflow"):` block. The joke generation, evaluation, and conditional improvement flow are grouped into a single trace for end-to-end visibility in the dashboard. **Reliable Trace Delivery with flush_traces()** In Celery/RQ/FastAPI background workers, flush traces before the process exits. Import `flush_traces` from `agents`. In Celery tasks, call `flush_traces()` after ` message))` to send traces. In FastAPI, call `flush_traces()` in the `@app.on_event("shutdown")` hook to guarantee trace delivery before process exit. **Privacy Controls for Sensitive Data** Control tracing in ZDR (Zero Data Retention) environments or when handling personal information. Pass `run_config=RunConfig(trace_include_sensitive_data=False)` to ` (the default is `True`) to omit LLM inputs/outputs and function call data from traces; the default can also be flipped with the `OPENAI_AGENTS_TRACE_INCLUDE_SENSITIVE_DATA` environment variable. To disable tracing entirely, set `OPENAI_AGENTS_DISABLE_TRACING=1` or pass `RunConfig(tracing_disabled=True)`. 💡 Use Cases 📊 Visualize LLM/tool/handoff/guardrail flows in the Traces dashboard with zero-config default tracing 🔗 Group multiple agent runs under with trace("Joke workflow") for end-to-end workflow visibility 🔄 Call flush_traces() in Celery/RQ/FastAPI workers to guarantee trace delivery before process exit 🔒 Protect medical/financial data privacy with trace_include_sensitive_data=False ⚠️ Caveats - Tracing is on by default, so sensitive data may inadvertently appear in traces. Review `trace_include_sensitive_data` settings for production environments. - `flush_traces()` is a blocking operation. Call it in shutdown hooks or task completion, not in the critical request path. - Trace data is sent to OpenAI. For compliance requirements, disable with `OPENAI_AGENTS_DISABLE_TRACING=1` or redirect with custom processors (see next section). ✨ Built-in tracing's greatest strength is "it just works with zero config." Start by checking the dashboard as-is, then add workflow grouping and privacy controls as needed! #OpenAIAgentSDK# #AIAgent#

A little boy at the San Antonio Zoo serenaded a bald eagle with “God Bless America,” and sweet video captured the bird seemingly listening intently to his patriotic performance. 🇺🇸🦅🎶

The Bluish-fronted Jacamar is found within and around Bird Friendly® farms in Peru. They can be spotted sitting on vines and branches where they await their chance to capture insect prey. #FeatheredFactFriday#

The full behind-the-scenes record of the 2025 Lay Zhang “GRANDLINE 5· Rock the Heavenly Palace” Tour — Ningbo Stop is here! First encounter with Ningbo, every detail on and off stage captured. Crew members, next stop — the Bird’s Nest!

Bird songs share surprising similarities with human music and speech, according to a large-scale study comparing vocalizations across hundreds of bird species and dozens of human languages. The findings in Science suggest that these similarities may arise partly from shared biological mechanisms, rather than vocal learning ability alone. Learn more:

Bird migration is underway! The park’s green spaces provide places for birds to rest and refuel as they make their way south for winter. We’ve documented more than 150 species of birds at the National Mall. Keep an eye out while you’re visiting the Mall. NPS photo