Guider le comportement de l'agent avec un contexte créé

Cette page explique comment fournir au mieux un contexte créé à vos agents de données de l'API Conversational Analytics en rédigeant des requêtes efficaces à l'aide d'instructions système et, pour les données BigQuery, en fournissant également un contexte structuré. Bien que la fourniture d'un contexte créé soit facultative, un contexte créé bien structuré peut améliorer la justesse et la pertinence des réponses fournies par l'API.

Qu'est-ce que le contexte créé ?

Le contexte créé est un guide que les développeurs peuvent fournir pour façonner le comportement d'un agent de données et affiner les réponses de l'API. Ces conseils incluent des instructions système en texte libre et, pour les sources de données BigQuery, des champs de contexte structurés contenant des informations telles que des descriptions de tables et des exemples de requêtes. Pour répondre aux questions, l'agent combine ce contexte créé avec des informations provenant de sources de données (telles que des tables BigQuery, des explorations Looker et des sources de données Looker Studio) et avec l'historique des conversations (pour les conversations multitours).

En fournissant des instructions claires grâce à des champs contextuels structurés et des instructions système en forme libre, vous pouvez améliorer la capacité de l'agent à interpréter les questions des utilisateurs et à générer des réponses utiles et précises. Un contexte bien défini est particulièrement utile si vous vous connectez à des données telles que des tables BigQuery. Par exemple, vous pouvez utiliser le contexte créé pour fournir les types de consignes suivants à un agent :

  • Logique spécifique à l'entreprise : définis comme "fidèle" un client qui a effectué plus de cinq achats au cours d'une période donnée.
  • Mise en forme des réponses : résume toutes les réponses de l'agent de données en 20 mots ou moins pour faire gagner du temps aux utilisateurs.
  • Présentation des données : mets en forme tous les nombres pour qu'ils correspondent au guide de style de l'entreprise.

Fournir un contexte créé

Les informations spécifiques que vous pouvez fournir dépendent de votre source de données :

  • Pour les données BigQuery, vous pouvez définir à la fois un contexte structuré et des instructions système. Pour obtenir les meilleurs résultats, commencez par fournir du contexte à l'agent à l'aide des champs structurés disponibles. Vous pouvez ensuite fournir des conseils supplémentaires en définissant des instructions système.
  • Pour les données Looker, le contexte créé n'est fourni que par le biais d'instructions système.

Vous fournissez un contexte structuré dans les champs de l'API pour obtenir des détails tels que des descriptions de tables et des exemples de requêtes. Vous fournissez des instructions système sous la forme d'une chaîne au format YAML à l'aide du paramètre system_instruction.

Une fois que vous avez défini votre contexte créé, vous pouvez le fournir à l'API dans l'un des appels suivants :