# Turn on web search

Web search lets a Web Agent look things up on the web during a conversation. Turn it on when users ask about things outside your app and your documents, such as a competitor's public pricing or today's exchange rate.

## Before you begin

Web search runs as a tool of Anthropic's API, so it depends on two settings.

- The workspace's model provider is Anthropic or Vercel AI Gateway. On Amazon Bedrock, Azure AI Foundry and LiteLLM the switch is disabled and the row says why. See [Model providers](https://docs.faustine.ai/workspace/model-providers/).
- The agent's chat model is an Anthropic model. See [Choose the chat model](https://docs.faustine.ai/web-agents/chat-model/).

## Turn on web search

To let the agent search:

1. In the portal, go to [**Web Agents**](https://auth.faustine.ai/go?to=%2Fweb-assistants) and select your agent.
2. Select the **Assistant** tab, then **Web search**.
3. Turn on **Web search**.

The switch saves when you change it and applies to the next message. It does not need a publish.

## How the agent searches

The model decides when to search. It can run up to 3 searches for one reply. The searches run on your model provider and are billed by it with the rest of the conversation.

With Vercel AI Gateway, replies that search are sent to the gateway's Anthropic upstream. If you brought your own Amazon Bedrock key to Vercel, those replies use Vercel's Anthropic credentials and are billed to your Vercel credits.

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| The switch is disabled, and the row says **Amazon Bedrock does not offer a web-search tool for Claude models.** | The workspace's model provider is Amazon Bedrock. | Switch the model provider. See [Switch model provider](https://docs.faustine.ai/workspace/switch-provider/). |
| The switch is disabled, and the row says **Web search is not available on Azure-hosted Claude deployments in Foundry.** | The workspace's model provider is Azure AI Foundry. | Switch the model provider. |
| The switch is disabled, and the row says **Your gateway does not expose a web-search tool we can use.** | The workspace's model provider is LiteLLM. | Switch the model provider. |
| The switch is disabled, and the row says **Web search works with Anthropic models only, and this agent uses an OpenAI model.** | The agent's chat model is an OpenAI model. | Select an Anthropic model under **AI Model**. See [Choose the chat model](https://docs.faustine.ai/web-agents/chat-model/). |

## Next steps

- [Add knowledge from files](https://docs.faustine.ai/web-agents/knowledge-files/): answer from your own documents first.
- [Choose the chat model](https://docs.faustine.ai/web-agents/chat-model/): the model that decides when to search.
- [Read the logs](https://docs.faustine.ai/web-agents/logs/): see the searches the agent ran in a conversation.