Afficher un formulaire avec un bouton Soumettre dans Copilot Studio
Note
Cet article s’applique aux chatbots classiques uniquement. Pour étendre les agents créés dans Copilot Studio, vous n’avez pas besoin d’utiliser Bot Framework Composer. Toutes les fonctionnalités décrites dans cet article sont disponibles pour les agents, directement dans Copilot Studio.
Améliorez votre chatbot classique en développant des boîtes de dialogue personnalisées avec Bot Framework Composer, puis en les ajoutant à un copilote créé dans Copilot Studio.
Dans cet exemple, vous apprendrez à afficher un formulaire avec un bouton Soumettre dans Copilot Studio en utilisant Composer.
Important
L’intégration de Composer n’est pas disponible pour les utilisateurs qui ne disposent que d’une licence Teams Microsoft Copilot Studio. Vous devez disposer d’une licence d’évaluation ou d’une licence Microsoft Copilot Studio complète.
Conditions préalables
- Affichez une carte adaptative dans Copilot Studio.
- Affichez une liste d’options à sélection multiple dans Copilot Studio.
- Utilisez la Recherche Bing comme solution de secours dans Copilot Studio.
Créer un déclencheur
Dans Copilot Studio, ouvrez le copilote à partir de l’exemple 3. Si vous n’avez pas encore terminé l’exemple 3, consultez Utiliser Recherche Bing comme solution de secours dans Copilot Studio.
Ouvrez votre bot dans Composer. Pour savoir comment procéder, consultez Prise en main de Bot Framework Composer.
Dans l’explorateur de bots, accédez à la boîte de dialogue principale. Sélectionnez Plus d’options (…), puis sélectionnez Ajouter un nouveau déclencheur.
Dans la fenêtre Créer un déclencheur :
Pour Quel est le type de ce déclencheur ?, sélectionnez Intention reconnue.
Pour Quel est le nom de ce déclencheur ?, saisissez
StartTrial
.Pour Phrases déclencheur, copiez et collez ce qui suit :
- start trial - sign up to try - register to try service
Sélectionnez Soumettre.
Accédez à la page Réponses de bot, sélectionnez Service de livraison de repas Contoso, puis sélectionnez Afficher le code.
Copiez et collez ce qui suit dans la vue de code :
# adaptivecardjson_StartTrialForm() - ``` { "type": "AdaptiveCard", "body": [ { "type": "TextBlock", "size": "Medium", "weight": "Bolder", "text": "Register for a meal plan trial:" }, { "type": "Input.Text", "placeholder": "Please enter your Name", "id": "Name" }, { "type": "Input.Text", "placeholder": "Please enter your Address", "id": "Address", "isMultiline": true }, { "type": "Input.Number", "placeholder": "How many weeks", "id": "Weeks" }, { "type": "ActionSet", "actions": [ { "type": "Action.Submit", "title": "Submit", "style": "positive" } ] } ], "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "version": "1.2" } ```
Notez que chaque champ de données de cette carte adaptative a reçu un ID : Nom, Adresse, et Semaines.
Copiez et collez le code suivant dans la même vue de code :
# AdaptiveCard_StartTrialForm() [Activity Attachments = ${json(adaptivecardjson_StartTrialForm())} ]
Ajouter une logique de conversation
Accédez à la page Créer et sélectionnez le déclencheur StartTrial.
Sur le canevas de création, sélectionnez Ajouter (+), Poser une question, et Texte.
Dans le volet des propriétés, sous la section Réponses de bot, sélectionnez Afficher le code.
Avertissement
L’ajout de l’expression suivante à l’éditeur de réponse au lieu de l’éditeur de code aura pour effet que le bot réponde avec du JSON brut au lieu d’une carte adaptative.
Copiez et collez l’expression suivante :
- ${AdaptiveCard_StartTrialForm()}
Sélectionnez l’onglet Entrée utilisateur dans le volet des propriétés, puis procédez comme suit :
- Pour Propriété, saisissez
user.name
. - Pour Valeur, saisissez
=turn.activity.value.Name
.
- Pour Propriété, saisissez
Sur le canevas de création sélectionnez Ajouter (+), Gérer les propriétés, puis Définir des propriétés.
Sur le volet Propriétés, exécutez la procédure suivante :
- Sous Affectations, sélectionnez Ajouter une nouvelle pour ajouter une zone Propriété et une zone Valeur.
- Pour Propriété, saisissez
user.address
- Pour Valeur, saisissez
=turn.activity.value.Address
. - Sélectionnez à nouveau Ajouter une nouvelle pour ajouter une autre Propriété et Valeur.
- Pour Propriété, saisissez
user.weeks
. - Pour Valeur, saisissez
=turn.activity.value.Weeks
.
Dans le canevas de création , sélectionnez Ajouter (+), puis sélectionnez Envoyer une réponse.
Dans l’éditeur de réponse, copiez et collez ce qui suit :
${user.name} - thanks for starting a ${user.weeks} week trial with us! Your meals will be delivered to this address: ${user.address}.
Dans le canevas de création , sélectionnez Ajouter (+), puis Commencer une rubrique Microsoft Copilot Studio.
Dans le volet des propriétés, sous Nom de la boîte de dialogue, sélectionnez Fin de la conversation.
Tester votre bot
Publiez votre contenu Composer pour le rendre disponible dans votre copilote Copilot Studio.
Important
La sélection de Publier dans Composer rend les modifications disponibles à des fins de test, mais ne publie pas automatiquement votre bot.
Publiez votre bot dans Microsoft Copilot Studio pour mettre à jour votre bot dans tous les canaux auxquels il est connecté.
Accédez à la page Rubriques de Copilot Studio pour voir votre nouvelle rubrique StartTrial.
Ouvrez le volet Tester le bot, et assurez-vous que Suivi des rubriques est activé. Saisissez le message
How do I sign up for a trial?
pour démarrer votre conversation.