> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Tavily

> Prepare focused public-web search with source evidence, bounded content, and explicit quota handling.

Plan a Tavily lookup that finds public documentation for a product question. Define the permitted query and the evidence needed to answer it before making search part of an agent workflow.

<Note>
  Tavily is not a current native Threetone integration. Credential storage and tool authoring are available preparation steps; live search execution is not established by saving them.
</Note>

## Prepare a bounded search

Have a provider account, an approved API key, and an owner for search cost and data-sharing decisions.

<Steps>
  <Step title="Specify the useful result" id="tavily-query">
    Set a focused query, result limit, and relevant domain restrictions where supported. Review Tavily's [Search API reference](https://docs.tavily.com/documentation/api-reference/endpoint/search) for the current request options and Bearer authentication. Do not use a customer transcript as an unreviewed search query.
  </Step>

  <Step title="Protect the credential and returned context" id="tavily-credential">
    Store the key through a compatible [auth connection](/agents-platform/configure/authentication/auth-connections) or in your integration service. Limit returned content to useful excerpts and URLs. Treat retrieved text as untrusted source content that cannot change your access policy.
  </Step>

  <Step title="Keep uncertainty visible" id="tavily-result">
    Preserve source links and distinguish an empty result from provider failure. A relevance score does not establish that a statement is true. Set timeout, retry, and quota limits; report an incomplete search when those limits are reached.
  </Step>
</Steps>

Document the planned action through [tool configuration](/agents-platform/configure/tools/overview). Any resulting proposal to send a message or change a record requires a separate authorized action.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I allow arbitrary search options from agent output?" id="faq-tavily-options">Have your service validate allowed options and enforce result, cost, and content limits. A generated request should not override those limits.</Accordion>
  <Accordion title="Does an empty search prove the information does not exist?" id="faq-tavily-empty">No. It only means this request returned no usable evidence. Explain that limitation and let the reader refine the question.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.