Support openai-agents (#4437)

Add support for AI agents projects using `openai-agents`
(https://pypi.org/project/openai-agents/)

Docs PR is here: getsentry/sentry-docs#14113

This integration:
- records tracing data of agent invocation, tool execution, ai client
requests to LLMs, and handoffs to other agents.
- captures input and output to/from LLMs if `set_default_pii=True`.
- is mostly compatible to the OpenTelememetry `gen_ai` semantic
conventions. (input and output is not compatible because Sentry does not
have Span events. This information is stored in arrays on the Span
attributes.
- Captures errors that happen during agent execution (like problems
during interaction with the LLM.

This integration does not:
- Capture errors during function tool exection because this is very hard
to patch (see comment in the code)

Example span tree in Sentry.io:
![Screenshot 2025-06-24 at 12 15
17](https://github.com/user-attachments/assets/87199067-434f-4bb9-b563-5c6fc18c56cb)

---------

Co-authored-by: Ivana Kellyer <[email protected]>

Author: antonpirker

.github/workflows/test-integrations-ai.yml

@@ -66,6 +66,10 @@ jobs:
         run: |
           set -x # print commands that are executed
           ./scripts/runtox.sh "py${{ matrix.python-version }}-openai-latest"
+      - name: Test openai_agents latest
+        run: |
+          set -x # print commands that are executed
+          ./scripts/runtox.sh "py${{ matrix.python-version }}-openai_agents-latest"
       - name: Test huggingface_hub latest
         run: |
           set -x # print commands that are executed
@@ -141,6 +145,10 @@ jobs:
         run: |
           set -x # print commands that are executed
           ./scripts/runtox.sh --exclude-latest "py${{ matrix.python-version }}-openai"
+      - name: Test openai_agents pinned
+        run: |
+          set -x # print commands that are executed
+          ./scripts/runtox.sh --exclude-latest "py${{ matrix.python-version }}-openai_agents"
       - name: Test huggingface_hub pinned
         run: |
           set -x # print commands that are executed

pyproject.toml

@@ -183,6 +183,10 @@ ignore_missing_imports = true
 module = "grpc.*"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "agents.*"
+ignore_missing_imports = true
+
 #
 # Tool: Flake8
 #

scripts/populate_tox/config.py

@@ -139,6 +139,12 @@
     "loguru": {
         "package": "loguru",
     },
+    "openai_agents": {
+        "package": "openai-agents",
+        "deps": {
+            "*": ["pytest-asyncio"],
+        },
+    },
     "openfeature": {
         "package": "openfeature-sdk",
     },

scripts/populate_tox/tox.jinja

@@ -400,6 +400,7 @@ setenv =
     litestar: TESTPATH=tests/integrations/litestar
     loguru: TESTPATH=tests/integrations/loguru
     openai: TESTPATH=tests/integrations/openai
+    openai_agents: TESTPATH=tests/integrations/openai_agents
     openfeature: TESTPATH=tests/integrations/openfeature
     opentelemetry: TESTPATH=tests/integrations/opentelemetry
     potel: TESTPATH=tests/integrations/opentelemetry

scripts/split_tox_gh_actions/split_tox_gh_actions.py

@@ -63,6 +63,7 @@
         "cohere",
         "langchain",
         "openai",
+        "openai_agents",
         "huggingface_hub",
     ],
     "Cloud": [