[Feature]: OpenAI Agents SDK Cookbook

[yatharthk2]

Cookbook: Using Moss with OpenAI Agents SDK

Add a cookbook example showing how to wire Moss into an OpenAI Agents SDK agent as a retrieval tool.

What the example should cover

• Load a Moss index locally (load_index) before querying, to demonstrate sub-10ms retrieval
• Wrap client.query() as a function tool using the OpenAI Agents SDK @function_tool decorator
• Show optional metadata filter support passed as tool arguments
• End-to-end agent run: agent receives a question, calls the Moss tool, returns a grounded answer

Acceptance Criteria

• Example under examples/cookbook/openai-agents/
• Handles load_index() before the agent runs (not silently skipped)
• Tool schema covers query, top_k, and optional filter arguments
• Includes a short README explaining when to use metadata filters and the local-vs-cloud speed tradeoff

[staru09]

Would love to take this one.

[Atulsingh1155]

Anyone working on this issue?

[desiorac]

Submitted a PR for this: #146

Follows the same cookbook pattern as the CrewAI example — tool wrappers using @function_tool, multi-agent travel planner demo with agent.as_tool() orchestration, live tests, and metadata filter support.

[AryahCodes]

Hi! I'm a student in the CodePath AI301 program and I'd like to work on this issue. I'll start by reviewing the existing examples and reproducing the missing cookbook setup locally this week. Any pointers on preferred example structure or naming under examples/cookbook/openai-agents/ would be appreciated!