Skip to main content
The OpenAI Agents SDK adapter runs an OpenAI Agent, and its handoffs, on Tilde. It works with @openai/agents 0.18 in TypeScript, and openai-agents 0.22 in Python.

TypeScript example

A complete OpenAI Agents SDK agent in TypeScript.

Python example

A complete OpenAI Agents SDK agent in Python.

Install

How it works

On each invocation, the adapter returns a copy of your agent with the channel’s tools, the agent’s Tilde and bundled tools, and skills. It also returns run options that pass new user input to the model, and the abort signal. Your module-level agent is never changed.

Feature compatibility

Handoffs and agents as tools

Limitations

  • Hosted prompts. A prompt referenced by an OpenAI prompt ID is versioned by OpenAI, not Tilde. Discovery warns.
  • Hosted tools. OpenAI hosted tools, such as web search, are not published to Tilde, and their calls are not recorded.
  • Failed tool calls. The SDK turns a tool error into a result for the model. Tilde records the call as completed.
  • Server-managed conversations in Python. If you use previous_response_id, new user input during a run can reach the model twice.
  • CrewAI in the same environment. The Python adapter needs a different major version of the openai package from CrewAI. Keep them in separate environments.
  • Item IDs. Converted history items carry no IDs, because the Responses API rejects IDs it did not create.