Ferramenta da Pesquisa Google

Com a ferramenta Pesquisa Google, o agente pode basear as respostas em informações atualizadas da web, embasando a conversa em dados do mundo real. Essa ferramenta é ideal para cenários que exigem conhecimento global, eventos atuais ou uma ampla variedade de tópicos.

Configuração

Defina as seguintes configurações ao criar a ferramenta:

  • Nome: O nome de exibição da instância da ferramenta (por exemplo, search_web).
  • Descrição: Uma breve descrição da finalidade da ferramenta. Os agentes de raciocínio usam essa descrição para decidir quando invocar a ferramenta.
  • Domínios excluídos: uma lista de domínios a serem excluídos dos resultados da pesquisa (máximo de 2.000). Por exemplo: "www.example.com" ou "example.com"
  • Domínios preferidos: uma lista de domínios para restringir os resultados da pesquisa (máximo de 20). Por exemplo: "www.example.com" ou "example.com"
  • URLs para contexto: URLs específicos para buscar contexto de embasamento (máximo de 20). O modelo usa o conteúdo dessas páginas diretamente. Por exemplo: "example.com/page/path"
  • Modalidades: personalize como o agente processa e resume os resultados da pesquisa para diferentes modalidades:
    • Comando de texto: instruções para processar resultados da pesquisa em conversas de texto.
    • Comando de voz: instruções para processar resultados da pesquisa em conversas por voz (por exemplo, manter as respostas concisas e naturais para a fala e evitar recitar URLs brutos).

Precedência das configurações

As configurações de domínio e URL são aplicadas na seguinte ordem:

  1. Domínios excluídos: maior precedência. Os domínios são excluídos mesmo que estejam listados em URLs para contexto ou Domínios preferenciais.
  2. URLs para contexto: o conteúdo é buscado, a menos que o domínio seja excluído.
  3. Domínios preferidos: precedência mais baixa.

URLs de contexto de ambiente de execução

Além dos URLs para contexto fornecidos na configuração da ferramenta, você pode instruir o agente a injetar URLs dinamicamente durante a execução.

Por exemplo, você pode adicionar o seguinte às instruções do agente: none If the user query is about x, look into these urls url1, url2, url3 using the 'Product Information Search' tool.

Citações e citações diretas

Quando um agente embasa a resposta usando a ferramenta da Pesquisa Google, a resposta de tempo de execução inclui metadados de citação em SessionOutput.citations para rastrear declarações geradas até fontes da Web.

Os metadados de citação contêm dois componentes principais:

  • Trechos citados (cited_chunks): a lista de documentos de origem usados para embasamento, incluindo a origem uri, página title, snippet text e o indicador requires_attribution.
  • Citações inline (inline_citations): offsets precisos de intervalo de bytes (start_index e end_index) no texto da resposta que mapeiam diretamente para cited_chunk_indices. Você pode usar citações inline no aplicativo cliente para renderizar selos interativos em sobrescrito, notas de rodapé ou links inline ancorados a declarações específicas na resposta do agente.

Requisitos de atribuição

As citações retornadas da fundamentação na Web podem exigir atribuição à fonte original:

  • Verifique o campo requires_attribution em cada CitedChunk.
  • Se requires_attribution for true, o aplicativo cliente precisará mostrar a atribuição de origem e o link para o URI de origem dos usuários finais.