Pesquisa na Web
O que é a Pesquisa na Web?
A Pesquisa na Web é uma capacidade opcional que permite ao agente pesquisar na web durante uma conversa. Quando ativado, o agente pode decidir de forma autônoma pesquisar na web quando determinar que a pergunta do usuário exige informações não disponíveis nos seus dados do Salesforce.
Ao contrário das ferramentas padrão (que consultam os dados do seu Salesforce), a pesquisa na web acessa a internet pública. O agente recebe os resultados da pesquisa e os utiliza para formular uma resposta bem fundamentada, citando as fontes quando apropriado.
Cada pesquisa na web realizada pelo agente adiciona uma sobretaxa fixa de créditos além do uso normal de créditos baseado em tokens. Essas sobretaxas são registradas separadamente em cada transação de crédito.
Ativando a Pesquisa na Web
-
Abra a Definição de Agente
Navegue até o registro de Definição de Agente da REDAAI referente ao agente que deseja configurar.
-
Ative Allow Web Search
Marque a caixa de seleção Allow Web Search na Definição de Agente.
-
Salve
O agente agora pode realizar pesquisas na web durante as conversas. Nenhuma atribuição de ferramenta adicional é necessária — a pesquisa na web é injetada automaticamente quando ativada.
A pesquisa na web fica desativada por padrão em todos os agentes. Você deve ativá-la explicitamente para cada agente.
Como funciona
- Um usuário faz uma pergunta que exige informações externas (por exemplo, “Quais são as taxas de imposto sobre a propriedade mais recentes em Dubai?”)
- O agente determina que uma pesquisa na web ajudaria a responder à pergunta
- O agente realiza a pesquisa, recebe os resultados e lê as páginas relevantes
- O agente sintetiza as informações em uma resposta, citando as fontes
O agente decide quando pesquisar com base no contexto da pergunta. Você não precisa instruir os usuários a pedir pesquisas na web — o agente usa seu próprio julgamento.
Custo em créditos
| Item | Custo |
|---|---|
| Cada pesquisa na web realizada | Sobretaxa fixa, registrada separadamente do uso de tokens |
| Uso normal de tokens | Cálculo de créditos padrão (inalterado) |
| Total de uma mensagem com pesquisa na web | Créditos de tokens mais uma sobretaxa para cada pesquisa realizada |
A sobretaxa é registrada no campo Tool Surcharge Credits em cada registro de Transação de crédito de IA, para que você possa acompanhar os custos de pesquisa na web separadamente dos custos de tokens.
Configurando o número máximo de pesquisas por turno
Você pode limitar quantas pesquisas na web o agente realiza em um único turno de conversa. Isso é configurado por meio da definição Web Search Max Uses no painel de administração de REDA AI (Platform Settings).
| Definição | Padrão | Intervalo | Descrição |
|---|---|---|---|
| Web Search Max Uses | 5 | 1 em diante — sem teto | Número máximo de pesquisas na web por turno de conversa |
Esta configuração não tem limite superior. A REDA AI eleva para 1 qualquer valor menor e, de resto, aceita o número como está — 50 significa cinquenta buscas em um único turno. Cada busca consome créditos, então um erro de digitação aqui multiplica o custo de todas as respostas daquele agente. (Compare com o Max Tools, que é deliberadamente limitado a 100 exatamente por esse motivo.) Defina-o de forma deliberada e mantenha-o baixo.
Um valor mais baixo reduz o consumo de créditos, mas pode limitar a capacidade do agente de pesquisar questões complexas. Um valor mais alto permite uma pesquisa mais completa a um custo maior em créditos.
Substituição por agente. Um agente específico pode ter seu próprio valor de Web Search Max Uses na Definição de Agente dele. Deixe em branco e o agente usa o padrão da organização acima; defina-o para dar mais pesquisas a um agente voltado à pesquisa, ou para limitar abaixo do padrão da organização um agente de alto volume voltado ao cliente, sem mudar nada para os demais. Consulte Configuração do agente.
Quando ativar a Pesquisa na Web
- Agentes que respondem perguntas sobre regulamentações, tendências de mercado ou eventos atuais
- Agentes de suporte que precisam consultar documentação externa ou recursos públicos
- Agentes voltados para pesquisa, nos quais os usuários esperam dados externos em tempo real
- Agentes de Widget Externo — cada conversa de convidado com pesquisa na web custa mais créditos. Monitore o uso.
- Agentes de alto volume — a sobretaxa por pesquisa se acumula rapidamente com muitas conversas
- Agentes exclusivos para dados — se o agente só precisa consultar os dados do seu Salesforce, a pesquisa na web é desnecessária
Monitorando o uso da Pesquisa na Web
Você pode acompanhar o uso da pesquisa na web por meio de:
- Transações de crédito — o campo Tool Surcharge Credits mostra o valor da sobretaxa para cada turno de conversa. Um valor maior que 0 indica que pesquisas na web foram realizadas.
- Relatórios de Período de crédito — monitore o consumo geral de créditos para detectar picos inesperados provenientes do uso de pesquisa na web
- Transcrições de conversas — revise as conversas para ver o que o agente pesquisou e como os resultados da pesquisa foram utilizados
Perguntas frequentes
Não. A pesquisa na web fica disponível automaticamente quando você ativa Allow Web Search na Definição de Agente. Ela não aparece na lista de atribuição de ferramentas — é injetada automaticamente.
Sim. Use prompts de Guardrail para orientar o comportamento de pesquisa do agente. Por exemplo: “Pesquise na web apenas para questões regulatórias ou legais. Para perguntas sobre produtos, use apenas os dados do Salesforce.”
Sim. A pesquisa na web funciona nos canais Interno, Widget Externo, Comunidade e API. A sobretaxa de créditos se aplica independentemente do canal.
O agente usa seu próprio julgamento para decidir quando uma pesquisa na web é útil. Se você quiser restringir isso, adicione um prompt de Guardrail como: “Realize pesquisas na web apenas quando o usuário pedir explicitamente informações externas ou atuais.”
Crie um relatório sobre o objeto REDAAI Transação de crédito de IA. O campo Tool Surcharge Credits contém a sobretaxa de pesquisa na web de cada transação. Some esse campo para ver o custo total de pesquisas na web em um período.
Próximos passos
Saiba mais sobre os recursos de Upload de Arquivos, ou consulte Como Funcionam os Créditos para entender o modelo completo de créditos, incluindo as sobretaxas.