# New tools for building agents: Responses API, web search, file search, computer use, and Agents SDK

**URL:** <https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896>\
**Category:** Announcements\
**Created:** [March 11, 2025, 8:53pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896 "2025-03-11T20:53:13Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![edwinarbus](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/edwinarbus/32/455108_2.png) [@edwinarbus](https://community.openai.com/u/edwinarbus)\
**Post date:** [March 11, 2025, 8:53pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/1 "2025-03-11T20:53:13Z")

</div>

Today, we released our first set of tools to help you accelerate building agents. These building blocks will help you design and scale the complex orchestration logic required to build agents and enable agents to interact with tools to make them truly useful.

 ![API_Agents_Hero_16.9 1](https://us1.discourse-cdn.com/openai1/original/4X/1/3/0/1303c2ede4ad164e825ae1b4534f0bb89c4d95ec.jpeg)

**Introducing the Responses API**

The [Responses API](https://platform.openai.com/docs/quickstart?api-mode=responses) is a new API primitive that combines the best of both the Chat Completions and Assistants APIs. It’s simpler to use and includes built-in tools provided by OpenAI that execute tool calls and add results automatically to the conversation context. As model capabilities continue to evolve, we believe the Responses API will provide a more flexible foundation for developers building agentic applications.

**New tools to help you build useful agents**

[Web search](https://platform.openai.com/docs/guides/tools-web-search) delivers accurate and clearly-cited answers from the web. Using the same tool as search in ChatGPT, it’s great at conversation and follow-up questions—and you can integrate it with just a few lines of code. Web Search is available in the Responses API as a tool for the `gpt-4o` and `gpt-4o-mini` models, and can be paired with other tools. In the Chat Completions API, web search is available as a separate model, called `gpt-4o-search-preview` and `gpt-4o-mini-search-preview`. Available to all developers in preview.

[File search](https://platform.openai.com/docs/guides/tools-file-search) is an easy-to-use retrieval tool that delivers fast, accurate search results with a few lines of code. It supports multiple file types, reranking, attribute filtering, and query rewriting. File Search is available in the Responses API, plus continues to be available via the Assistants API.

[Computer use](https://platform.openai.com/docs/guides/tools-computer-use) is the fastest way to build computer-using agents with CUA, the same model that powers Operator in ChatGPT. You can use this tool to control computers or virtual machines that you operate. You simply pass screenshots to the tool, and it responds with an action you should take like click, scroll, or type. The model is available for select developers on tiers 3–5 as a research preview in the Responses API.

[Agents SDK](https://platform.openai.com/docs/guides/agents) is an orchestration framework that abstracts the complexity involved in designing and scaling agents. It includes built-in observability tooling that allows developers to log, visualize, and analyze agent performance to identify issues and areas of improvement. Inspired by [Swarm](https://github.com/openai/swarm), the Agents SDK is also open source and supports both other model and tracing providers.

---

<div class="post-metadata">

**Author:** ![edwinarbus](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/edwinarbus/32/455108_2.png) [@edwinarbus](https://community.openai.com/u/edwinarbus)\
**Post date:** [March 11, 2025, 8:54pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/2 "2025-03-11T20:54:22Z")

</div>



---

<div class="post-metadata">

**Author:** ![merefield](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/merefield/32/14812_2.png) [@merefield](https://community.openai.com/u/merefield)\
**Post date:** [March 11, 2025, 8:56pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/3 "2025-03-11T20:56:49Z")

</div>

@edwinarbus please add 🚀 emoji 😉 . Congrats on the new launch.

---

<div class="post-metadata">

**Author:** ![polepole](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/polepole/32/740575_2.png) [@polepole](https://community.openai.com/u/polepole)\
**Post date:** [March 11, 2025, 5:21pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/4 "2025-03-11T17:21:23Z")

</div>

# New tools for building agents

> [https://openai.com/index/new-tools-for-building-agents/](https://openai.com/index/new-tools-for-building-agents/)

How to use the OpenAI API for Q&A or to build a chatbot?

> [https://help.openai.com/en/articles/6643167-how-to-use-the-openai-api-for-q-a-or-to-build-a-chatbot](https://help.openai.com/en/articles/6643167-how-to-use-the-openai-api-for-q-a-or-to-build-a-chatbot)

---

<div class="post-metadata">

**Author:** ![Diet](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/diet/32/562749_2.png) [@Diet](https://community.openai.com/u/Diet)\
**Post date:** [March 11, 2025, 5:41pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/5 "2025-03-11T17:41:01Z")

</div>

Do we know when/how the computer use model will be rolled out?

---

<div class="post-metadata">

**Author:** ![VeitB](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/veitb/32/712987_2.png) [@VeitB](https://community.openai.com/u/VeitB)\
**Post date:** [March 11, 2025, 6:02pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/6 "2025-03-11T18:02:37Z")

</div>

Since they didn’t say later, I expect the roll-out is already underway.

Staff will show up later/soon. They will likely clarify the timeline.

---

<div class="post-metadata">

**Author:** ![VeitB](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/veitb/32/712987_2.png) [@VeitB](https://community.openai.com/u/VeitB)\
**Post date:** [March 11, 2025, 6:14pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/7 "2025-03-11T18:14:58Z")

</div>

Link to the documentation for the Agents SDK:

> **[OpenAI Agents SDK](https://openai.github.io/openai-agents-python/)**

---

<div class="post-metadata">

**Author:** ![curt.kennedy](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/curt.kennedy/32/709249_2.png) [@curt.kennedy](https://community.openai.com/u/curt.kennedy)\
**Post date:** [March 11, 2025, 6:29pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/8 "2025-03-11T18:29:28Z")

</div>

The Responses API docs:

[https://platform.openai.com/docs/api-reference/responses](https://platform.openai.com/docs/api-reference/responses)

---

<div class="post-metadata">

**Author:** ![Foxalabs](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/foxalabs/32/738355_2.png) [@Foxalabs](https://community.openai.com/u/Foxalabs)\
**Post date:** [March 11, 2025, 6:37pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/9 "2025-03-11T18:37:39Z")

</div>

> **[GitHub - openai/openai-cua-sample-app](https://github.com/openai/openai-cua-sample-app)**
>
> Contribute to openai/openai-cua-sample-app development by creating an account on GitHub.

Computer use agent example code, should give a decent intro to usage.

---

<div class="post-metadata">

**Author:** ![mat.eo](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/mat.eo/32/512009_2.png) [@mat.eo](https://community.openai.com/u/mat.eo)\
**Post date:** [March 11, 2025, 6:42pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/10 "2025-03-11T18:42:12Z")

</div>

> Based on your feedback from the Assistants API beta, we’ve incorporated key improvements into the Responses API. After we achieve full feature parity, we will announce a **deprecation plan** later this year, with a target sunset date in the first half of 2026.

RIP Assistants.

---

<div class="post-metadata">

**Author:** ![kenif](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/kenif/32/563395_2.png) [@kenif](https://community.openai.com/u/kenif)\
**Post date:** [March 11, 2025, 6:48pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/11 "2025-03-11T18:48:53Z")

</div>

Still not showing up, I’m hitting `computer-use-preview` on the sample app and get this response:

```auto
"error": {
        "message": "The model `computer-use-preview-2025-03-11` does not exist or you do not have access to it.",
        "type": "invalid_request_error",
        "param": null,
        "code": "model_not_found"
    }

```

---

<div class="post-metadata">

**Author:** ![VeitB](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/veitb/32/712987_2.png) [@VeitB](https://community.openai.com/u/VeitB)\
**Post date:** [March 11, 2025, 6:53pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/12 "2025-03-11T18:53:29Z")

</div>

You can use models from other providers.

> Using other LLM providers  
> Many providers also support the OpenAI API format, which means you can pass a base\_url to the existing OpenAI model implementations and use them easily. ModelSettings is used to configure tuning parameters (e.g., temperature, top\_p) for the model you select.

Since the OpenAI API has been adopted by many providers, it should give us a broad range of models to choose from right from the start. Since the SDK is open source, it’s just a matter of time until the rest will be available as well.

See the last paragraph:

> **[Models - OpenAI Agents SDK](https://openai.github.io/openai-agents-python/models/)**

---

<div class="post-metadata">

**Author:** ![VeitB](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/veitb/32/712987_2.png) [@VeitB](https://community.openai.com/u/VeitB)\
**Post date:** [March 11, 2025, 7:08pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/13 "2025-03-11T19:08:54Z")

</div>

Input and output pricing for computer use. Batch API is available, caching is not.

 ![1000020097](https://us1.discourse-cdn.com/openai1/original/4X/6/3/1/63131b144cb319a4bc49b9b6a8150425c644e3c6.jpeg)

---

<div class="post-metadata">

**Author:** ![platypus](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/platypus/32/759972_2.png) [@platypus](https://community.openai.com/u/platypus)\
**Post date:** [March 11, 2025, 7:14pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/14 "2025-03-11T19:14:15Z")

</div>

Lot of people in the community have been asking for web search via API and now we have it, both in the new Responses API as well as the agents SDK. Great!

---

<div class="post-metadata">

**Author:** ![mat.eo](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/mat.eo/32/512009_2.png) [@mat.eo](https://community.openai.com/u/mat.eo)\
**Post date:** [March 11, 2025, 7:15pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/15 "2025-03-11T19:15:26Z")

</div>

Beautiful, thank you. For whatever reason I didn’t see the `openai_client` parameter for the Model. I should probably read the docs as well as the source code

---

<div class="post-metadata">

**Author:** ![VeitB](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/veitb/32/712987_2.png) [@VeitB](https://community.openai.com/u/VeitB)\
**Post date:** [March 11, 2025, 7:28pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/16 "2025-03-11T19:28:21Z")

</div>

Yes, thanks for bringing it up.  
Here are the prices for 1 million tokens for the search API.  
No caching and no batch API available.

 ![grafik](https://us1.discourse-cdn.com/openai1/original/4X/a/f/8/af87e46726968b8ad15d27dce7a434fb700be1dc.png)

---

<div class="post-metadata">

**Author:** ![aprendendo.next](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/aprendendo.next/32/721758_2.png) [@aprendendo.next](https://community.openai.com/u/aprendendo.next)\
**Post date:** [March 11, 2025, 7:51pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/17 "2025-03-11T19:51:44Z")

</div>

wow this is perfect, web search opens a lot of new usages! And with computer usage, we will finally see an explosion of new agents, but most important, we can now build our own mini-automations for specific projects. I’m very excited to try all these new toys!

---

<div class="post-metadata">

**Author:** ![\_j](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/_j/32/719663_2.png) [@\_j](https://community.openai.com/u/_j)\
**Post date:** [March 11, 2025, 8:00pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/18 "2025-03-11T20:00:07Z")

</div>

**Noteworthy** : the server-side “conversation state” feature introduced with the _responses API_: if you use this feature, by passing a `previous_response_id` along with only the latest input, it has no cost management to the chat length:

You get only:

- maximum loading of context window (pay 120k tokens a turn?), or
- an error thrown.

If you get into the situation where it is automatically discarding oldest turns, it is also destroying any context window caching with every new input.

```markdown
truncation: The truncation strategy to use for the model response.

* `auto`: If the context of this response and previous ones exceeds the model's context window size, the model will truncate the response to fit the context window by dropping input items in the middle of the conversation.
* `disabled` (default): If a model response will exceed the context window size for a model, the request will fail with a 400 error.

```

Thus, this conversation state is not practical to use in its current implementation unless you want to make chat sessions themselves of limited turn count length to users, or will set money on fire.

* * *

Additional: `"store": false` must be set by you when doing your own chat self-management as before, otherwise you get the server-side storage of chat session under a multitude of model response IDs as the default, consuming resources and perhaps response time.

Todo: compare network latency of 10-200kb chat requests to the latency of the backend response\_id retrieval when this is being more heavily utilized - like assistants.

---

<div class="post-metadata">

**Author:** ![nielm](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/nielm/32/342469_2.png) [@nielm](https://community.openai.com/u/nielm)\
**Post date:** [March 11, 2025, 8:01pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/19 "2025-03-11T20:01:35Z")

</div>

There seems to be an issue with API Keys on Responses endpoint.  
In my specific case, I tried using a pre-existing API Key which was restricted but allowed most features except fine-tuning. I received a 403 error - not enough permissions. I switched the API key from restricted to Full, and tried again, no difference.  
I then proceeded to create a NEW API Key, also with Full capabilities, and then it worked.  
So there seems to be an issues with previously created Keys not being allowed to use Responses API.

---

<div class="post-metadata">

**Author:** ![michael.dowling](https://sea2.discourse-cdn.com/openai1/user_avatar/community.openai.com/michael.dowling/32/511814_2.png) [@michael.dowling](https://community.openai.com/u/michael.dowling)\
**Post date:** [March 11, 2025, 8:35pm UTC](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896/20 "2025-03-11T20:35:54Z")

</div>

This is a phenomenal release! Probably the biggest developer release in a year. Love the simplicity of the new API also (as a relative simpleton myself!).

[Next page](https://community.openai.com/t/new-tools-for-building-agents-responses-api-web-search-file-search-computer-use-and-agents-sdk/1140896.md?page=2)
