Busca na Web
De ao seu agente acesso a informacoes em tempo real: noticias, precos, documentacao e qualquer conteudo publico da internet.
O que e a Busca na Web?
Por padrao, um modelo de IA so conhece o que aprendeu no treinamento. Com a Busca na Web ativada, seu agente ganha duas ferramentas nativas:
- web_search — pesquisa na internet (como voce faria no Google) e usa os resultados na resposta
- web_fetch — abre uma pagina especifica e le o conteudo dela
Na pratica: cotacoes e precos atuais, noticias de hoje, documentacao de produtos, status de servicos — o agente busca sozinho, quando percebe que precisa.
Como ativar
- No dashboard, abra seu bot e va no menu Comportamento
- Localize o card Busca na web
- Ative o toggle — pronto: o provedor padrao (DuckDuckGo, gratuito) ja funciona sem nenhuma chave
Ja vem ativado
Bots novos ja nascem com a busca ativada no DuckDuckGo. Voce so precisa mexer aqui se quiser desativar ou trocar o provedor.
Provedores disponiveis
Voce escolhe qual mecanismo de busca o agente usa:
- DuckDuckGo — padrao, gratuito, sem chave. Bom para uso leve.
- Tavily — busca otimizada para IA. Requer chave propria (tem plano gratuito).
- Perplexity — busca com sintese de resposta. Requer chave propria.
- Exa — busca semantica para casos avancados. Requer chave propria.
- Gemini (grounding) — busca via Google. Requer chave Gemini propria.
Provedores com chave propria tendem a ser mais estaveis e com melhores resultados para uso intenso — o DuckDuckGo gratuito pode sofrer bloqueios temporarios (CAPTCHA) sob uso muito frequente.
Usando sua propria chave
- Crie a chave no site do provedor (ex.:
tavily.com,perplexity.ai) - No dashboard do bot, va na aba Secrets & API Keys e salve a chave como service key com o nome de variavel exato:
- Tavily:
TAVILY_API_KEY - Perplexity:
PERPLEXITY_API_KEY - Exa:
EXA_API_KEY - Gemini:
GEMINI_API_KEY
- Tavily:
- No card Busca na web, selecione o provedor correspondente e salve
A plataforma cuida do resto
Ao selecionar um provedor com chave, o QuickClaw instala automaticamente o plugin oficial do provedor no seu bot e reinicia o agente para aplicar. O bot fica indisponivel por alguns segundos durante a troca — e normal.
Limites e comportamento
- Um provedor por vez — o agente usa o provedor selecionado no card. Trocar e imediato (basta selecionar outro e salvar).
- Custo — buscas com chave propria consomem a cota/creditos do SEU plano no provedor de busca (nao os creditos QuickClaw).
- Privacidade — os termos buscados sao enviados ao provedor de busca escolhido, como em qualquer pesquisa na web.
Resolucao de problemas
O agente diz que a busca esta desabilitada (ex.: "web_search is disabled or no provider is available"):
- Confira se o card Busca na web esta ativado
- Se usa provedor com chave: confira se a service key esta salva com o nome de variavel exato (tabela acima)
- Abra o card, salve novamente a escolha do provedor — isso regenera a configuracao e reinicia o bot
- Persistindo, fale com o suporte: suporte@myquickclaw.com
Nao edite a configuracao interna
Os caminhos tools.web.search.* e plugins.allow do arquivo de configuracao sao gerenciados pela plataforma — pedir para o proprio agente editar nao funciona (e protegido). Use sempre o card do dashboard.
Veja tambem: Obtendo API Keys e Resolucao de problemas.
