Ein Formular mit einer Schaltfläche zum Senden in Copilot Studio anzeigen

Anmerkung

Dieser Artikel gilt nur für klassische Chatbots. Um in erstellte Agenten zu erweitern, müssen Sie Copilot StudioComposer nicht verwenden. Bot Framework Alle in diesem Artikel beschriebenen Funktionen stehen Agenten direkt in zur Verfügung Copilot Studio.

Erweitern Sie Ihren Chatbot, indem Sie benutzerdefinierte Dialogfelder mit Bot Framework Composer entwickeln und sie dann einem Copilot hinzufügen, der in Copilot Studio erstellt wurde.

In diesem Beispiel lernen Sie, wie Sie mit dem Composer ein Formular mit der Schaltfläche Senden in Copilot Studio anzeigen können.

Wichtig

Die Composer-Integration ist nicht für Benutzer verfügbar, die nur über die Teams Microsoft Copilot Studio Lizenz verfügen. Sie müssen eine Test- oder normale Microsoft Copilot Studio-Lizenz haben.

Anforderungen

• Zeigen Sie eine adaptive Karte in Copilot Studio an.
• Eine Liste mit Mehrfachauswahloptionen in Copilot Studio anzeigen.
• Verwenden Sie die Bing-Suche als Fallback in Copilot Studio.

Erstellen eines neuen Auslösers

1. Öffnen Sie in Copilot Studio den Copilot aus Beispiel 3. Wenn Sie Beispiel 3 noch nicht abgeschlossen haben, lesen Sie Bing-Suche in Copilot Studio als Ausweichmöglichkeit verwenden.

2. Öffnen Sie Ihren Bot in Composer. Anweisungen hierzu finden Sie unter Erste Schritte mit Bot Framework Composer.

3. Gehen Sie im Bot-Explorer zum Hauptdialog. Wählen Sie Mehr Optionen (...) und dann Neuen Trigger hinzufügen aus.

4. Tun Sie im Fenster Einen Trigger erstellen Folgendes:

   1. Wählen Sie für Welchen Typ hat dieser Trigger? die Option Absicht erkannt aus.

   2. Geben Sie für Wie lautet der Name dieses Trigger? StartTrial ein.

   3. Kopieren Sie Folgendes als Triggerausdrücke ein:

      - start trial
      - sign up to try
      - register to try service
      

   4. Wählen Sie Übermitteln aus.

   

5. Gehen Sie zur Seite Bot-Antworten, wählen Sie Contoso Meal Delivery Service und dann Code anzeigen aus.

6. Kopieren Sie Folgendes in die Codeansicht:

   # 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"
   }
   ```
   

   Jedes Eingabefeld in dieser adaptiven Karte hat eine eindeutige ID: Name, Adresse und Wochen.

7. Kopieren Sie den folgenden Code in die gleiche Codeansicht:

   # AdaptiveCard_StartTrialForm()
   [Activity
       Attachments = ${json(adaptivecardjson_StartTrialForm())}
   ]
   

   

Unterhaltungslogik hinzufügen

1. Gehen Sie auf die Seite Erstellen und wählen Sie den Trigger StartTrial.

2. Wählen Sie im Erstellungsbereich Hinzufügen (+), Frage stellen und dann Text aus.

3. Wählen Sie im Eigenschaftenbereich unter Bot-Antworten Code anzeigen aus.

   Warnung

   Wenn Sie den folgenden Ausdruck dem Antwort-Editor anstatt dem Code-Editor hinzufügen, antwortet der Bot mit einem rohen JSON anstatt einer adaptiven Karte.

4. Kopieren Sie den folgenden Ausdruck hinein:

   - ${AdaptiveCard_StartTrialForm()}
   

5. Wählen Sie im Eigenschaftenbereich in der Registerkarte Benutzereingabe und dann Folgendes aus:

   1. Geben Sie für Eigenschaft user.name ein.
   2. Geben Sie als Wert =turn.activity.value.Name ein.

6. Wählen Sie im Erstellungsbereich Hinzufügen (+), Eigenschaften verwalten und schließlich Eigenschaften festlegen aus.

7. Führen Sie im Eigenschaftenbereich Folgendes aus:

   1. Wählen Sie unter Zuweisungen Neue hinzufügen aus, um ein Feld Eigenschaft und ein Feld Wert hinzuzufügen.
   2. Geben Sie für Eigenschaft user.address ein
   3. Geben Sie als Wert =turn.activity.value.Address ein.
   4. Wählen Sie noch einmal Neu hinzufügen aus, um eine weitere Eigenschaft und einen weiteren Wert hinzuzufügen.
   5. Geben Sie für Eigenschaft user.weeks ein.
   6. Geben Sie als Wert =turn.activity.value.Weeks ein.

8. Wählen Sie im Erstellungsbereich Hinzufügen (+) und dann Eine Antwort senden aus.

9. Kopieren und fügen Sie im Antwort-Editor Folgendes ein:

   ${user.name} - thanks for starting a ${user.weeks} week trial with us! Your meals will be delivered to this address: ${user.address}.
   

10. Wählen Sie im Erstellungsbereich Hinzufügen (+) und dann Ein Microsoft Copilot Studio Thema beginnen aus.

11. Wählen Sie im Eigenschaftenbereich für Dialogname Ende der Unterhaltung aus.

Ihren Bot testen

1. Veröffentlichen Sie Ihre Composer-Inhalte , um sie in Ihrem Copilot Studio Copilot verfügbar zu machen.

   Wichtig

   Wählen Sie Veröffentlichen in Composer stellt die Änderungen zum Testen zur Verfügung, veröffentlicht jedoch nicht automatisch Ihren Bot.

   Veröffentlichen Sie Ihren Bot in Microsoft Copilot Studio, um ihn auf allen Kanälen, mit denen er verbunden ist zu aktualisieren.

2. Gehen Sie zur Seite Copilot Studio Themen, um Ihr neues StartTrial-Thema anzeigen zu lassen.

3. Öffnen Sie den Testbot-Bereich und stellen Sie sicher, dass Nachverfolgen der Themenverläufe eingeschaltet ist. Geben Sie die Nachricht ein How do I sign up for a trial? ein, um Ihre Unterhaltung zu beginnen.