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

# Perguntas frequentes sobre AI Search

## Primeiros passos

### O que é AI Search?

AI Search é um gateway único da Novita que dá ao seu aplicativo acesso em tempo real para pesquisar na web. Você chama a Novita com uma chave de API e escolhe um provedor de pesquisa por solicitação, em vez de se cadastrar em cada provedor separadamente. Consulte o [Início rápido](/docs/pt-BR/guides/ai-search-quickstart) para o panorama completo.

### Quais provedores são compatíveis?

Atualmente **Exa** e **Tavily**. Cada um é exposto como um endpoint passthrough que espelha o formato de solicitação e resposta do próprio provedor. Consulte o [Quickstart](/docs/pt-BR/guides/ai-search-quickstart) para a lista de endpoints.

### Preciso de uma conta Exa ou Tavily separada?

Não. Sua chave de API da Novita autentica todas as solicitações do AI Search. Você não gerencia chaves ou contas de provedores upstream.

## Autenticação e Configuração

### Como faço a autenticação?

Use sua chave de API da Novita como um bearer token: `Authorization: Bearer <api_key>`. A mesma chave funciona para todos os provedores. Para criar ou gerenciar chaves, consulte [Gerenciamento de chaves de API](/docs/pt-BR/api-reference/basic-authentication).

### Existe um SDK da Novita para o AI Search?

Não — e você não precisa de um. O AI Search é uma integração, não um produto encapsulado: cada endpoint é um passthrough que encaminha sua solicitação ao provedor (Exa ou Tavily) no formato nativo desse provedor. Isso significa que você tem duas boas opções:

* **Use o SDK do próprio provedor.** Se o SDK permitir definir uma URL base personalizada, aponte-o para a rota de gateway correspondente e passe sua chave da Novita. Por exemplo, o SDK Python da Exa aceita `base_url="https://api.novita.ai/v3/exa"`. Consulte o [Guia de início rápido](/docs/pt-BR/guides/ai-search-quickstart#bring-your-own-provider-sdk) para um exemplo completo.
* **Chame os endpoints REST diretamente.** Funciona com qualquer cliente HTTP e não requer nenhum SDK. O [Guia de início rápido](/docs/pt-BR/guides/ai-search-quickstart) mostra exemplos em curl, Python, e JavaScript.

Se um SDK não expuser uma configuração de base-URL, use o caminho REST em vez disso.

## Posso trocar de provedores sem alterar a estrutura do meu código?

Na maioria das vezes. A autenticação, o host, e o fluxo da requisição permanecem idênticos — você altera a rota (e.g. `/v3/tavily/search` → `/v3/exa/search`) e alinhe o corpo aos nomes dos campos desse provedor (por exemplo, da Tavily `max_results` vs os da Exa `numResults`).

## Comportamento da busca

### Quão recentes são os resultados?

Os resultados refletem conteúdo da web em tempo real. Para perguntas sensíveis ao tempo, restrinja por data para manter páginas desatualizadas fora: Tavily expõe `time_range` e `start_date`/`end_date`; A Exa expõe `startPublishedDate`/`endPublishedDate`.

### Como restringir os resultados a sites confiáveis?

Use filtros de domínio — `include_domains`/`exclude_domains` no Tavily, `includeDomains`/`excludeDomains` na Exa — para manter a recuperação dentro de fontes em que você confia.

### Qual é a diferença entre search, extract e crawl?

* **Search** descobre páginas relevantes a partir de uma consulta.
* **Extract / Contents** extrai texto limpo de URLs que você já tem.
* **Crawl / Map** segue links para coletar ou listar muitas páginas de um site.

Veja [Respostas Fundamentadas na Web](/docs/pt-BR/guides/ai-search-grounded-answers#search-vs-extract-vs-crawl) para orientações sobre qual usar.

### A AI Search pode gerar uma resposta, não apenas links?

Sim. Tavily Search retorna uma resposta de LLM quando você define `include_answer`, e a Exa oferece um [Answer](/docs/pt-BR/api-reference/model-apis-exa-answer) endpoint. Para ter controle total sobre a redação e as citações, recupere os resultados e sintetize com a [LLM API](/docs/pt-BR/guides/llm-api) em vez disso — consulte [Respostas fundamentadas na Web](/docs/pt-BR/guides/ai-search-grounded-answers).

## Limites e solução de problemas

### Quais são os limites de taxa?

As solicitações do AI Search estão sujeitas tanto aos limites da plataforma Novita quanto aos limites próprios de cada provedor upstream, que dependem do nível do provedor vinculado à sua conta. Quando você excede um limite, a API retorna `429 Too Many Requests` — aguarde e tente novamente com atraso exponencial. Esses limites são independentes da [API de LLM](/docs/pt-BR/guides/llm-api) limites de taxa; uma chamada de busca não consome sua cota de LLM.

### Por que estou recebendo um erro 400?

Um parâmetro provavelmente não corresponde ao schema do provedor. Confirme se você está usando os nomes de campo desse provedor — uma causa comum é enviar os do Tavily `max_results` para uma rota Exa (que espera `numResults`).

### Onde posso obter mais ajuda?

Para dúvidas sobre integração ou limites mais altos, [agende uma chamada com nossa equipe](https://meet.brevo.com/novita-ai/contact-sales).
