Herramienta de Búsqueda de Google

La herramienta de Búsqueda de Google permite que tu agente base sus respuestas en información actualizada de la Web, lo que fundamenta de manera eficaz la conversación en datos del mundo real. Esta herramienta es ideal para situaciones que requieren conocimiento mundial, eventos actuales o una amplia variedad de temas.

Configuración

Establece los siguientes parámetros de configuración cuando crees la herramienta:

  • Nombre: Es el nombre visible de la instancia de la herramienta (por ejemplo, search_web).
  • Descripción: Es una breve descripción del propósito de la herramienta. Los agentes de razonamiento usan esta descripción para decidir cuándo invocar la herramienta.
  • Dominios excluidos: Es una lista de dominios que se excluirán de los resultados de la búsqueda (máximo 2,000). Por ejemplo, "www.example.com" o "example.com"
  • Dominios preferidos: Es una lista de dominios para restringir los resultados de la búsqueda (máximo 20). Por ejemplo, "www.example.com" o "example.com"
  • URLs para el contexto: Son URLs específicas para recuperar el contexto de fundamentación (máximo 20). El modelo usa el contenido de estas páginas directamente. Por ejemplo: "example.com/ruta/de/página"
  • Modalidades: Personaliza la forma en que el agente procesa y resume los resultados de la búsqueda para diferentes modalidades:
    • Instrucción de texto: Son instrucciones para procesar los resultados de la búsqueda en conversaciones de texto.
    • Instrucción por voz: Son instrucciones para procesar los resultados de la búsqueda en conversaciones de voz (por ejemplo, mantener las respuestas concisas y naturales para el habla, y evitar recitar URLs sin procesar).

Prioridad de la configuración

La configuración del dominio y la URL se aplica en el siguiente orden:

  1. Dominios excluidos: Tienen la precedencia más alta. Los dominios se excluyen incluso si aparecen en URLs para el contexto o Dominios preferidos.
  2. URLs para el contexto: Se recupera el contenido, a menos que se excluya el dominio.
  3. Dominios preferidos: Tienen la precedencia más baja.

URLs de contexto del entorno de ejecución

Además de las URLs para el contexto que se proporcionan en la configuración de la herramienta, puedes indicarle a tu agente que inserte URLs de forma dinámica durante el tiempo de ejecución.

Por ejemplo, puedes agregar lo siguiente en las instrucciones del agente: none If the user query is about x, look into these urls url1, url2, url3 using the 'Product Information Search' tool.

Citas y citas intercaladas

Cuando un agente fundamenta su respuesta con la herramienta de la Búsqueda de Google, la respuesta del tiempo de ejecución incluye metadatos de citas en SessionOutput.citations para rastrear las declaraciones generadas hasta las fuentes web.

Los metadatos de citas contienen dos componentes principales:

  • Fragmentos citados (cited_chunks): Es la lista de documentos fuente que se usaron para la fundamentación, incluidos la fuente uri, la página title, el fragmento text y el indicador requires_attribution.
  • Citas intercaladas (inline_citations): Desplazamientos precisos del rango de bytes (start_index y end_index) en el texto de la respuesta que se asignan directamente a cited_chunk_indices. Puedes usar citas intercaladas en tu aplicación cliente para renderizar distintivos interactivos en superíndice, notas al pie o vínculos intercalados anclados a afirmaciones específicas en la respuesta del agente.

Requisitos de atribución

Las citas que se devuelven de la fundamentación web pueden requerir la atribución a la fuente original:

  • Verifica el campo requires_attribution en cada CitedChunk.
  • Si requires_attribution es true, tu aplicación cliente debe mostrar la atribución de la fuente y vincular el URI de origen para los usuarios finales.