# Web Search

Web Search lets Leilani search approved public domains during a call.

It is disabled by default. The agent can only use web search during calls when it has at least one domain in **Configuration** under **Web Search Allowlist**.

## Allowlist behavior

Enter one fully qualified domain name per line.

Examples:

- `docs.example.com`
- `help.example.com`
- `status.example.com`

When saved, Leilani normalizes entries by trimming whitespace, lowercasing, removing `http://` or `https://`, and removing a trailing slash.

If the allowlist is empty, web search is disabled for that agent.

## Runtime behavior

When web search is enabled, Leilani makes approved-domain search available during calls.

Web search:

- restricts search to the configured allowed domains
- returns relevant search output and source information the agent can use in its response

The built-in tool description tells the agent to use web search when factual information is needed and Knowledge Base search returns no results, poor results, or is unavailable.

## Best practices

- keep the allowlist narrow
- prefer source domains your organization controls or explicitly trusts
- use [Knowledge Base](knowledge-base.md) for private or stable internal material
- disable web search for regulated workflows unless your compliance review approves it
- tell the agent in [Instructions](instructions.md) when web search is allowed and when it must not be used

## Limitations

- Only domain allowlisting is exposed in the current console.
- Web search is not a replacement for your Knowledge Base.
- Search quality depends on the public pages available on the allowed domains.