
# Pesquisa Web em Tempo Real

A pesquisa web em tempo real confere ao seu bot de IA a capacidade de procurar informações durante uma conversa — tanto no seu próprio site como na internet aberta. Quando um cliente pergunta sobre um produto específico, disponibilidade ou preços que possam mudar frequentemente, o bot pode verificar e responder com informações atualizadas.


**Em termos simples:** Em vez de depender apenas das informações estáticas que introduziu durante a configuração, o bot pode visitar as páginas do seu site em tempo real para encontrar os detalhes mais recentes.

---

## Por que pode precisar da Pesquisa Web

Sem a pesquisa web, o seu bot apenas conhece o que introduziu nas suas instruções e FAQs. Isso funciona bem para informações que raramente mudam (como a sua política de devolução ou horário de funcionamento). Mas para coisas que se atualizam frequentemente, a pesquisa web mantém o bot atualizado.

**Com a pesquisa web ativada, o bot pode:**

- Pesquise no seu site produtos específicos com base no que o cliente procura
- Obtenha os preços, disponibilidade ou informações de inventário mais recentes
- Partilhe links diretos para páginas específicas de produtos ou serviços
- Procure respostas para perguntas gerais na internet aberta, mesmo sobre assuntos que não estão no seu site
- Leia URLs que um cliente partilha na conversa

**Exemplo de conversa:**

> **Cliente:** Têm apartamentos de 3 quartos disponíveis em Amesterdão?
>
> **Bot:** Deixe-me verificar as nossas listagens atuais para si...
>
> Temos 2 apartamentos de três quartos disponíveis em Amesterdão neste momento:
>
> 1. Jordaan Canal View - 3 quartos/2 casas de banho, 95m2, 2.450 EUR/mês
> 2. De Pijp Modern - 3 quartos/1 casa de banho, 82m2, 2.100 EUR/mês
>
> Gostaria de mais detalhes sobre algum destes?

Sem a pesquisa web, o bot teria de dizer algo genérico como "Temos apartamentos disponíveis em Amesterdão. Consulte o nosso site para ver as listagens atuais." Com a pesquisa web, o bot dá ao cliente exatamente o que ele precisa, diretamente no chat.

---

## Como Funciona

1. O cliente pergunta sobre algo específico
2. A IA decide que realizar uma pesquisa ajudaria a responder à pergunta
3. O bot pesquisa nos URLs Dinâmicos que configurou (pesquisa no site) ou na internet aberta (pesquisa web), utilizando palavras-chave da conversa
4. O conteúdo mais relevante é recuperado
5. A IA incorpora as descobertas na sua resposta

> **O bot tem duas capacidades web.** (1) A **pesquisa no site** analisa apenas os URLs Dinâmicos que configurar aqui, e é também o que permite ao bot abrir um link que um cliente cole na conversa — por isso, precisa de **pelo menos um** URL Dinâmico para funcionar. (2) A **pesquisa web** realiza uma pesquisa pública na internet aberta para perguntas gerais que não estão no seu site, e **não** precisa de URLs Dinâmicos. Ambas são controladas pelo interruptor **Pesquisa web por IA**: se o desligar, o bot não faz nenhuma das duas e responde apenas com base nas suas FAQs, fontes de conhecimento e instruções. A pesquisa web também requer um plano que inclua a funcionalidade de pesquisa web em tempo real.

O bot utiliza dois modos de pesquisa dependendo da pergunta:

- **Modo de lista** - Quando o cliente está a navegar ou a comparar opções, o bot analisa o conteúdo da sua página e devolve os resultados mais relevantes. Por exemplo: "Que apartamentos têm disponíveis?"
- **Modo específico** - Quando o cliente pergunta sobre um item em particular, o bot encontra e partilha um link direto para o produto ou serviço correspondente. Por exemplo: "Têm as Nike Air Max 90 em preto?"

O bot seleciona automaticamente o modo correto com base na conversação.

O bot também processa links partilhados pelos clientes. Se um cliente colar um URL no chat, o bot pode ler essa página e utilizar a informação na conversação.

---

## Como ativar a Pesquisa Web

### Verifique o seu plano

A pesquisa web em tempo real está disponível em planos elegíveis ou quando ativada na sua conta. Verifique o seu [nível de subscrição](../billing/subscription-tiers.md) para confirmar.

### Configuração

1. Abra o [Agente](../ai-agents/ai-agents.md) (em **AI Studio → AI Agents**). (Para um Agente ainda associado a uma campanha clássica, a mesma definição também aparece no passo **FAQs & Knowledge** dessa campanha.)
2. Clique no separador **FAQs & Knowledge** — a pesquisa na web encontra-se aí, juntamente com as suas FAQs e fontes de conhecimento, uma vez que são todas formas de o bot encontrar respostas.
3. Desloque-se até à secção **AI web search**.


4. Coloque o interruptor junto a **Pesquisa web por IA** na posição LIGADO. (Se o seu plano não incluir esta funcionalidade, o interruptor estará desativado e aparecerá um aviso de atualização — atualize primeiro em **Definições → Faturação**.)
5. Uma lista e um campo de introdução de texto aparecerão agora por baixo. Estes são os seus **URLs Dinâmicos** — as páginas web que o bot irá pesquisar, até **10** por Agente. São **opcionais**: deixe a lista vazia e o bot ainda poderá realizar uma pesquisa web pública. Adicionar pelo menos um URL é o que ativa a pesquisa nas suas próprias páginas e a leitura de links que os clientes colam na conversa.
6. Cole um URL no campo de introdução e clique em **+ Adicionar** (ou prima Enter).


7. Repita o processo para cada página que pretender adicionar. Assim que tiver adicionado 10, o campo de introdução desaparece — remova um primeiro se quiser adicionar uma página diferente.
8. Clique em **Save changes** na parte inferior.

### O que são URLs Dinâmicos?

Os URLs Dinâmicos são as páginas web que pretende que o bot consiga pesquisar durante as conversações. Estes são diferentes dos "URLs da Página de Vendas" que poderá ter adicionado durante a configuração da campanha:

| | URLs da Página de Vendas | URLs Dinâmicos |
|--|----------------|-------------|
| **Quando utilizados** | Lidos uma vez durante a configuração da campanha | Pesquisados em tempo real durante cada conversação relevante |
| **Objetivo** | Gerar instruções iniciais e FAQs do bot | Fornecer respostas atuais e atualizadas |
| **Ideal para** | Conteúdo estático (página sobre, informações gerais) | Conteúdo que muda frequentemente (listagens, inventário, preços) |

### Que páginas adicionar como URLs Dinâmicos

- Páginas de listagem de produtos ou catálogos
- Páginas de serviços
- Páginas de preços que mudam frequentemente
- Páginas de inventário ou disponibilidade
- Qualquer página com informações que são atualizadas regularmente

---

## Casos de utilização comuns

| Cenário | O que o cliente pergunta |
|----------|----------------------|
| **Pesquisa de produtos** | "Têm sapatilhas de corrida azuis no tamanho 44?" |
| **Verificação de disponibilidade** | "Que apartamentos têm disponíveis este mês?" |
| **Consulta de preços** | "Quanto custa o plano Profissional?" |
| **Comparação de funcionalidades** | "Qual é a diferença entre o Basic e o Pro?" |
| **Promoções atuais** | "Têm alguma promoção em curso?" |
| **Verificação de links** | O cliente partilha um link de produto, o bot lê-o e fornece detalhes |

---

## Quando é que o bot pesquisa (e quando não pesquisa)?

**O bot IRÁ pesquisar quando:**

- O cliente pergunta sobre algo específico que provavelmente está no seu site
- A pergunta envolve detalhes que mudam (preços, disponibilidade, níveis de stock)
- A resposta ainda não está coberta nas instruções ou FAQs do bot

**O bot NÃO irá pesquisar quando:**

- A pergunta pode ser respondida a partir das FAQs ou das Instruções de IA (não é necessário pesquisar)
- A pergunta não está relacionada com o conteúdo do seu website

---

## Custo em Créditos

Uma pesquisa na web é faturada como qualquer outra chamada de ferramenta de bot, ao nível de Qualidade de IA do seu Agente:

| Nível de Qualidade de IA | Créditos por pesquisa na web | Com a sua própria chave Anthropic (BYOK) ligada |
|---|---|---|
| Pro | 1 crédito | 0 créditos — executado na sua chave |
| Economy (descontinuado) | 0,5 créditos | 0 créditos — executado na sua chave |
| Max | 0,25 créditos | ainda 0,25 créditos, faturados mesmo com a sua própria chave ligada, porque o Max é executado no nosso próprio modelo |
| Mini | 0,15 créditos | ainda 0,15 créditos, faturados mesmo com a sua própria chave ligada, porque o Mini é executado no nosso próprio modelo |

**Dica:** Se o bot estiver a pesquisar demasiado frequentemente para os mesmos tipos de perguntas, considere adicionar essas respostas como FAQs. As FAQs estão incluídas automaticamente e não custam créditos adicionais.

---

## Dicas para Melhores Resultados

1. **Adicione páginas com conteúdo estruturado.** Páginas de listagem de produtos, catálogos e tabelas de preços funcionam melhor. Evite páginas que exijam início de sessão. Páginas dinâmicas e renderizadas com JavaScript são suportadas.

2. **Utilize a pesquisa na web em conjunto com as FAQs.** Para informações que raramente mudam (políticas de devolução, horário de funcionamento, informações gerais), utilize as FAQs. Reserve a pesquisa na web para conteúdos que são atualizados frequentemente.

3. **Testar em Try Out.** Faça perguntas específicas sobre o produto para garantir que o bot consegue encontrar e apresentar corretamente as informações do seu website.

4. **Monitorize a utilização de créditos.** Se o seu bot pesquisar frequentemente, considere expandir as suas FAQs para cobrir perguntas comuns - isto reduz a necessidade de pesquisas na web e poupa créditos.

---

## Próximos Passos

- [Gerir FAQs](faq-management.md) — a outra ferramenta no mesmo separador para fundamentar o bot no seu conteúdo.
- [Funções Personalizadas](custom-functions.md) — as ferramentas integradas **Search Your Website**, **Check a Link** e **Search the Web** que esta funcionalidade potencia.
- [Agentes de IA](../ai-agents/ai-agents.md) — onde reside o separador FAQs & Knowledge.
