Outil Recherche Google

L'outil de recherche Google permet à votre agent de baser ses réponses sur des informations à jour provenant du Web, ce qui ancre efficacement la conversation dans des données du monde réel. Cet outil est idéal pour les scénarios nécessitant des connaissances sur le monde, des événements actuels ou un large éventail de sujets.

Configuration

Configurez les paramètres suivants lorsque vous créez l'outil :

  • Name (Nom) : nom à afficher pour l'instance de l'outil (par exemple, search_web).
  • Description : brève description de l'objectif de l'outil. Les agents de raisonnement utilisent cette description pour décider quand appeler l'outil.
  • Domaines exclus : liste des domaines à exclure des résultats de recherche (2 000 maximum). Par exemple : "www.example.com" ou "example.com"
  • Domaines préférés : liste des domaines auxquels limiter les résultats de recherche (20 maximum). Par exemple : "www.example.com" ou "example.com"
  • URL pour le contexte : URL spécifiques à extraire pour le contexte d'ancrage (20 maximum). Le modèle utilise directement le contenu de ces pages. Par exemple : "example.com/page/path"
  • Modalités : Personnalisez la façon dont l'agent traite et résume les résultats de recherche pour différentes modalités :
    • Prompt textuel : instructions pour traiter les résultats de recherche dans les conversations textuelles.
    • Requête vocale : instructions pour traiter les résultats de recherche dans les conversations vocales (par exemple, en gardant les réponses concises et naturelles pour la parole, et en évitant de réciter des URL brutes).

Priorité des paramètres

Les paramètres de domaine et d'URL s'appliquent dans l'ordre suivant :

  1. Domaines exclus : priorité la plus élevée. Les domaines sont exclus même s'ils figurent dans URL pour le contexte ou Domaines préférés.
  2. URL pour le contexte : le contenu est récupéré, sauf si le domaine est exclu.
  3. Domaines préférés : priorité la plus basse.

URL de contexte d'exécution

En plus des URL de contexte fournies dans la configuration de l'outil, vous pouvez demander à votre agent d'injecter des URL de manière dynamique au moment de l'exécution.

Par exemple, vous pouvez ajouter les éléments suivants dans les instructions de votre agent : none If the user query is about x, look into these urls url1, url2, url3 using the 'Product Information Search' tool.

Citations et citations insérées

Lorsqu'un agent ancre sa réponse à l'aide de l'outil Recherche Google, la réponse d'exécution inclut des métadonnées de citation dans SessionOutput.citations pour remonter aux sources Web des déclarations générées.

Les métadonnées de citation contiennent deux composants principaux :

  • Blocs cités (cited_chunks) : liste des documents sources utilisés pour l'ancrage, y compris la source uri, la page title, l'extrait text et l'indicateur requires_attribution.
  • Citations intégrées (inline_citations) : décalages précis de la plage d'octets (start_index et end_index) dans le texte de la réponse qui correspondent directement à cited_chunk_indices. Vous pouvez utiliser des citations intégrées dans votre application cliente pour afficher des badges interactifs en exposant, des notes de bas de page ou des liens intégrés ancrés à des affirmations spécifiques dans la réponse de l'agent.

Exigences d'attribution

Les citations renvoyées par l'ancrage Web peuvent nécessiter l'attribution à la source d'origine :

  • Vérifiez le champ requires_attribution de chaque CitedChunk.
  • Si requires_attribution est défini sur true, votre application cliente doit afficher l'attribution de la source et créer un lien vers l'URI de la source pour les utilisateurs finaux.