# Web Search

Searches the web for an answer to the requestor's question, optionally only on domains you approve

The **Web Search** tool searches the web for information about the requestor's question and returns one answer with links to its sources. Use it in a runbook when your own knowledge does not cover a question, for example vendor troubleshooting steps for a Mac, an iPhone, or Gmail.

The tool only reads. It does not change anything in an external system.

## How It Works

1. The agent sends the conversation context to the tool.
2. The tool runs up to two web searches. If you set **Allowed Domains**, it searches only those domains.
3. It returns one answer with the URLs of the pages it used. The agent uses that answer in its reply to the requestor.

If the search finds nothing useful, the tool tells the agent that it does not know the answer, and the agent follows your runbook (for example, it escalates).

> **Note:** The agent uses Web Search only in runbooks that include it. A ticket that
> matches no runbook is still answered from your indexed knowledge.

## Configuration Options

In the Risotto dashboard, select **Tools** in the sidebar. Select **Web Search** in the **Tool groups** list, find **Web Search**, and click **Enable**. The tool has no required fields.

| Field               | Required | Description                                                                                                                 |
| ------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Allowed Domains** | No       | The domains the tool can search, for example `support.apple.com`. Type a domain and press Enter. Empty means the whole web. |

> **Warning:** With no allowed domains, the tool can use any page on the web. Add only the
> vendor support sites you trust.

**Allowed Domains** filters by domain only. Enter a domain name, for example `slack.com`. You cannot enter a path such as `slack.com/help`, and you cannot block a domain or a page. If you allow `slack.com`, the tool can use every page on `slack.com`.

To control how the agent uses what the search finds, write the rule in the runbook, for example "Do not tell users to download apps from the vendor's website. Send them to our Self Service app." The runbook controls what the agent tells the requestor. **Allowed Domains** is the only setting that limits which pages the search can use.

## Example Runbook Uses

Many vendor support runbook templates use this tool, each limited to the vendor's help site. On the **Runbooks** page, click **Browse templates**. For example:

- **Apple Product Support** searches `support.apple.com` for macOS, iPhone, iPad, iCloud, and Apple ID questions.
- **Google Product Support** searches `support.google.com` for Gmail, Google Drive, Google Calendar, and Google Meet questions.
- **Slack Support** searches `slack.com`.
- **Microsoft 365 Support**, **Okta Support**, **Zoom Support**, **Atlassian Support**, and others search their vendor's support site.

Each template first searches your internal knowledge. It uses Web Search only when your documentation does not solve the issue, and it escalates when neither source does. See [Runbooks](https://www.tryrisotto.com/docs/dashboard/runbooks).

## Related

- [Runbooks](https://www.tryrisotto.com/docs/dashboard/runbooks)
- [Generate AI Response](https://www.tryrisotto.com/docs/integrations/tools/openai/generate_response)

Source: https://www.tryrisotto.com/docs/integrations/tools/web_search/search
