Guides

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Remarque :La fonctionnalité Playbook est exclue du Contrat de niveau de service Dialogflow.

Un playbook est l'élément de base des agents génératifs. Un agent génératif comporte généralement de nombreux playbooks, chaque playbook étant défini pour gérer des tâches spécifiques. Les données du playbook sont fournies au LLM, qui dispose ainsi des informations nécessaires pour répondre aux questions et exécuter les tâches. Chaque playbook peut fournir des informations, envoyer des requêtes à des services externes ou déférer la gestion des conversations à un flux ou à un autre playbook afin de gérer des sous-tâches.

Limites

Les limites suivantes s'appliquent :

• Les agents qui utilisent des playbooks ne peuvent pas envoyer de SMS de compagnon d'appel à partir de l'intent d'accueil par défaut du flux de démarrage par défaut, mais vous pouvez activer l'option de SMS de compagnon d'appel dans les flux standards.

Langues acceptées

Les playbooks sont compatibles avec les mêmes langues que les modèles Gemini.

Compatibilité avec les régions

Les playbooks sont compatibles avec les régions suivantes:

• global
• asia-south1
• asia-southeast1
• asia-northeast1
• australia-southeast1
• eu (multirégional)
• europe-west1
• europe-west2
• europe-west3
• northamerica-northeast1
• us (multirégional)
• us-central1
• us-east1
• us-west1

Données du playbook

Un playbook se compose des données suivantes:

• Nom du playbook: nom concis en langage naturel qui aide les développeurs et le LLM à comprendre les tâches gérées par le playbook
• Objectifs : description générale de ce que le playbook doit accomplir
• Instructions : définit les étapes du processus à suivre pour atteindre l'objectif
• Exemples : exemples de conversations qui sont en fait des exemples de requêtes few-shot pour le LLM
• Paramètres : utilisés pour stocker des informations sur une conversation, comme les entrées utilisateur, les informations système utilisateur, les résultats des actions, etc.

Types de playbooks

Lorsque vous créez un playbook, vous sélectionnez le type de playbook souhaité: playbook de tâche ou playbook de routine.

Playbooks de tâches

Les playbooks de tâches sont le type de playbook d'origine. Ils permettent de décomposer des tâches complexes en sous-tâches plus petites et réutilisables. Ils sont utilisés pour modéliser les étapes de conversation compositionnelles, où chaque étape communique via des paramètres d'entrée et de sortie.

L'exemple suivant montre un playbook de tâche (appelant) appelant un autre playbook de tâche (appelé):

1. L'appelant lance l'appelé.
2. L'appelant fournit les paramètres d'entrée nécessaires à l'appelé.
3. L'appelant traite ces informations, exécute sa fonction désignée et renvoie les paramètres de sortie.
4. L'appelant reçoit des paramètres de l'appelé.

N'importe quel playbook de routine ou de tâche peut appeler un autre playbook de tâche, mais un playbook de tâche ne peut pas appeler un autre playbook de routine.

Playbooks de routine

Les playbooks de routine sont un nouveau type de playbook. Elles sont utilisées pour modéliser les étapes de conversation séquentielles, où chaque étape est complète et indépendante. Ils peuvent appeler des playbooks de tâches pour décomposer des tâches plus importantes en sous-tâches plus petites, et ils peuvent passer à d'autres playbooks ou flux de routine.

L'image suivante montre un playbook de routine (A), une transition vers un autre playbook de routine (B) et une transition vers un flux (C):

1. Le playbook de routine A peut lire les paramètres de session au démarrage et écrire les paramètres de session juste avant de quitter.
2. Le playbook de routine A se termine et passe au playbook de routine B.
3. Le playbook de routine B peut lire les paramètres de session au démarrage et écrire les paramètres de session juste avant de quitter.
4. Le playbook de routine B se termine et passe au flux C.
5. Le flux C peut lire et écrire des paramètres de session.

Si un playbook de routine ne passe pas à un autre playbook ou flux de routine, la session revient au dernier flux actif ou se termine s'il n'y en a pas.

Les playbooks de routine présentent le comportement de gestion des paramètres suivant:

• Lorsqu'un playbook de routine est saisi, des valeurs équivalentes aux paramètres de session portant le même nom sont attribuées à ses paramètres d'entrée.
• Lorsqu'un playbook de routine se termine, il génère des valeurs pour ses paramètres de sortie et les attribue à des paramètres de session portant le même nom.

Guide par défaut

Lorsque vous créez un agent génératif à l'aide de la console des agents conversationnels, un script génératif par défaut est créé automatiquement.

Le playbook par défaut est le point de départ des conversations. Il se distingue donc des autres playbooks par certains points importants:

• Le playbook par défaut ne reçoit pas de résumé des échanges précédents.
• Le playbook par défaut ne peut pas définir ni recevoir de paramètres d'entrée.

Importer et exporter des playbooks

Une fois que vous avez créé des playbooks à l'aide de la console des agents conversationnels, vous pouvez les exporter pour les utiliser dans un autre agent. Pour exporter un playbook:

1. Accédez à la liste des playbooks.
2. Cliquez sur le bouton d'exportation du playbook que vous souhaitez exporter.
3. Sélectionnez les options d'exportation.
4. Cliquez sur Exporter.

Pour importer un playbook que vous avez précédemment exporté:

1. Accédez à la liste des playbooks.
2. Cliquez sur Importer.
3. Sélectionnez les options d'importation.
4. Cliquez sur Importer.