Skip to main content

Web Search

Web Search gives Anyy a dedicated search tool for current public information. Configure one backend, test it with the pending settings, then enable it for conversations.

Configure in Dashboard

Open Dashboard → ToolsWeb Search.

  1. Choose a provider.
  2. Enter the API key when required.
  3. Review or enter the endpoint.
  4. Select Test.
  5. Save only after the test result matches the backend you intend to use.

The test performs a real search request. It may consume provider quota and can incur cost.

CLI setup is also available:

anyy tools websearch

Supported Backends

The current catalog includes Firecrawl Cloud and self-hosted Firecrawl, Exa, Parallel, Tavily, SearXNG, Brave Search Free Tier, Brave Search, Perplexity, Gemini Search, and xAI Grok Search.

Cloud services normally require a key. Self-hosted Firecrawl and SearXNG require an absolute HTTP or HTTPS endpoint. Anyy stores supported keys as Profile secret references rather than putting the value in config.yaml.

Tavily Options

Tavily exposes two additional controls:

OptionValues
Search depthbasic or advanced
Maximum results1 to 20; default 10

Advanced search can use more provider resources. Other backends reject Tavily-only options.

Ask for a current fact and say whether you want links:

Find the latest stable release of this library, summarize the changes, and include links to primary sources.

Anyy decides when the search tool is needed and returns only what the configured backend provides. Search finds candidate sources; it does not make an untrusted page authoritative.

Ask for source quality

For technical, legal, medical, or financial questions, explicitly request primary or official sources and verify important conclusions yourself.

Disable or Change Provider

Use the enable switch on Dashboard → Tools → Web Search. When switching providers, enter the new provider's credential and run a fresh test; a previous verification is not reused for a different endpoint or option set.

Troubleshooting

SymptomCheck
Test reports authentication failureReplace the provider key and confirm its product/plan access
Self-hosted backend is unreachableUse an absolute URL reachable from the Gateway host
Search works in test but not chatConfirm the backend is enabled and the web toolset is available
Tavily settings are rejectedUse basic/advanced and a result count from 1 to 20
Results are weak or staleRefine the query, request primary sources, or choose a better-suited backend