OpenAI Agents SDK (Python)
Forward the OpenAI Agents SDK lifecycle to Iqrar via a RunHooks subclass — agent start/end, handoffs, tool calls, and LLM round trips with token usage.
The OpenAI Agents SDK exposes a RunHooks lifecycle that Iqrar subclasses to forward events.
Install
pip install "iqrar-agent[openai-agents]"
Wire it in
from agents import Agent, Runner
from iqrar import Iqrar
from iqrar.adapters.openai_agents import IqrarRunHooks
iqrar = Iqrar(
org="acme",
jurisdiction="EU",
endpoint="https://api.your-deploy.workers.dev",
capabilities=["consumer_chatbot"],
)
agent = Agent(name="support", instructions="...")
result = await Runner.run(agent, input, hooks=IqrarRunHooks(iqrar))
What gets instrumented
| Hook | Iqrar event |
|---|---|
on_agent_start | agent.invocation.start |
on_agent_end | agent.invocation.end (output preview, model) |
on_handoff | agent.handoff (from / to agent name) |
on_tool_start | agent.tool.start |
on_tool_end | agent.tool.end (output preview, duration) |
on_llm_end | agent.llm.end (input/output/total tokens) |
See also
· · - The TS-side OpenAI integration: