Agent Observability Python Framework Module: OpenAI Agents
agento11y-openai-agents provides callback handlers that map OpenAI Agents lifecycle events into agento11y generation recorder lifecycles.
Installation
pip install agento11y agento11y-openai-agents
pip install openai-agents
Quickstart
from agento11y import Client
from agento11y_openai_agents import with_agento11y_openai_agents_hooks
client = Client()
run_options = with_agento11y_openai_agents_hooks(None, client=client, provider_resolver="auto")
# Runner.run(agent, input="...", hooks=run_options["hooks"])
Native hooks wiring
from agento11y import Client
from agento11y_openai_agents import with_agento11y_openai_agents_hooks
client = Client()
run_options = with_agento11y_openai_agents_hooks(None, client=client, provider_resolver="auto")
# Runner.run(agent, input="...", hooks=run_options["hooks"])
Conversation mapping
Conversation ID precedence:
conversation_id/session_id/group_idthread_id- deterministic fallback
agento11y:framework:openai-agents:<run_id>
Metadata and lineage
Required framework tags:
agento11y.framework.name=openai-agentsagento11y.framework.source=handleragento11y.framework.language=python
Metadata includes:
- required:
agento11y.framework.run_type - optional:
agento11y.framework.run_id,agento11y.framework.thread_id,agento11y.framework.parent_run_id,agento11y.framework.component_name,agento11y.framework.retry_attempt,agento11y.framework.event_id
Provider resolver
Resolver order: explicit provider option -> framework metadata -> model prefix inference -> custom.
Troubleshooting
- If conversations are fragmented, pass stable
session_idorconversation_idin callback metadata. - If provider is inferred as
custom, setprovider="openai"(or another provider) on handler init. - Always call
client.shutdown()during teardown.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agento11y_openai_agents-0.16.0.tar.gz.
File metadata
- Download URL: agento11y_openai_agents-0.16.0.tar.gz
- Upload date:
- Size: 9.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
19fcc7fecd5234b500d9c39af237233feb12f1993ff3c09c77371bfb5b85901c
|
|
| MD5 |
fc73c267089705d313e6b49ec1b90573
|
|
| BLAKE2b-256 |
3779d36a19582087e7201bef29aaa2e3aed4b336571c1220d20f0a4ffecf99df
|
Provenance
The following attestation bundles were made for agento11y_openai_agents-0.16.0.tar.gz:
Publisher:
python-sdks-publish.yml on grafana/agento11y
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agento11y_openai_agents-0.16.0.tar.gz -
Subject digest:
19fcc7fecd5234b500d9c39af237233feb12f1993ff3c09c77371bfb5b85901c - Sigstore transparency entry: 2501300904
- Sigstore integration time:
-
Permalink:
grafana/agento11y@b0a2eaa0f60b53192bfb7973dd6b26b5bba5f570 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/grafana
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-sdks-publish.yml@b0a2eaa0f60b53192bfb7973dd6b26b5bba5f570 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file agento11y_openai_agents-0.16.0-py3-none-any.whl.
File metadata
- Download URL: agento11y_openai_agents-0.16.0-py3-none-any.whl
- Upload date:
- Size: 7.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d56d2332ba7e7083d4052ac5fec2eb476160883ff4bfd363c6abd31e9e2e9cf9
|
|
| MD5 |
7c1d8a6e8a180f2e5f349e3627053b55
|
|
| BLAKE2b-256 |
230f5e1e2cf5f25e359e3233e62d42f786c6e3e2c8b85bfe4dee4421af560c7a
|
Provenance
The following attestation bundles were made for agento11y_openai_agents-0.16.0-py3-none-any.whl:
Publisher:
python-sdks-publish.yml on grafana/agento11y
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agento11y_openai_agents-0.16.0-py3-none-any.whl -
Subject digest:
d56d2332ba7e7083d4052ac5fec2eb476160883ff4bfd363c6abd31e9e2e9cf9 - Sigstore transparency entry: 2501300941
- Sigstore integration time:
-
Permalink:
grafana/agento11y@b0a2eaa0f60b53192bfb7973dd6b26b5bba5f570 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/grafana
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-sdks-publish.yml@b0a2eaa0f60b53192bfb7973dd6b26b5bba5f570 -
Trigger Event:
workflow_dispatch
-
Statement type:
