Beispiel 4: Formular mit einer Schaltfläche zum Senden in Microsoft Copilot Studio anzeigen

Artikel
04/01/2024

Wichtig

Power Virtual Agents-Fähigkeiten und -Funktionen sind jetzt Teil von Microsoft Copilot Studio nach erheblichen Investitionen in generative KI und verbesserte Integrationen in Microsoft Copilot.

Einige Artikel und Screenshots beziehen sich möglicherweise auf Power Virtual Agents während wir Dokumentation und Schulungsinhalte aktualisieren.

Anmerkung

Microsoft Copilot Studio unterstützt diese Funktion jetzt ohne Composer.

Verbessern Sie Ihren Bot, indem Sie benutzerdefinierte Dialoge mit Bot Framework Composer entwickeln und sie dann Ihrem Microsoft Copilot Studio Bot hinzufügen.

In diesem Beispiel lernen Sie, wie Sie mit dem Composer ein Formular mit einer Schaltfläche „Senden“ in Microsoft 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

Erstellen eines neuen Auslösers

Öffnen Sie den Bot aus Beispiel 3 in Microsoft Copilot Studio. Wenn Sie Beispiel 3 noch nicht abgeschlossen haben, lesen Sie Bing-Suche in Microsoft Copilot Studio als Ausweichmöglichkeit verwenden.
Öffnen Sie Ihren Bot in Composer. Anleitungen dazu finden Sie unter Erste Schritte mit Bot Framework Composer.
Gehen Sie im Bot-Explorer zum Hauptdialog. Wählen Sie Mehr Optionen (...) und dann Neuen Trigger hinzufügen aus.
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.
Gehen Sie zur Seite Bot-Antworten, wählen Sie Contoso Meal Delivery Service und dann Code anzeigen aus.

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.

Screenshot des JSON für adaptive Karten die den Bot-Antworten hinzugefügt wurde.

Kopieren Sie den folgenden Code in die gleiche Codeansicht:

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

Screenshot der Aktivität, die den Bot-Antworten hinzugefügt wurde.

Unterhaltungslogik hinzufügen

Gehen Sie auf die Seite Erstellen und wählen Sie den Trigger StartTrial.
Wählen Sie im Erstellungsbereich Hinzufügen (+), Frage stellen und dann Text aus.
Wählen Sie im Eigenschaftenbereich unter Bot-AntwortenCode 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.
Kopieren Sie den folgenden Ausdruck hinein:
```
- ${AdaptiveCard_StartTrialForm()}
```
Wählen Sie im Eigenschaftenbereich in der Registerkarte Benutzereingabe und dann Folgendes aus:
1. Geben Sie für Eigenschaftuser.name ein.
2. Geben Sie als Wert=turn.activity.value.Name ein.
Wählen Sie im Erstellungsbereich Hinzufügen (+), Eigenschaften verwalten und schließlich Eigenschaften festlegen aus.
Führen Sie im Eigenschaftenbereich Folgendes aus:
1. Wählen Sie unter ZuweisungenNeue hinzufügen aus, um ein Feld Eigenschaft und ein Feld Wert hinzuzufügen.
2. Geben Sie für Eigenschaftuser.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 Eigenschaftuser.weeks ein.
6. Geben Sie als Wert=turn.activity.value.Weeks ein.
Wählen Sie im Erstellungsbereich Hinzufügen (+) und dann Eine Antwort senden aus.

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}.

Screenshot der Bestätigungsantwort.

Wählen Sie im Erstellungsbereich Hinzufügen (+) und dann Ein Microsoft Copilot Studio Thema beginnen aus.
Wählen Sie im Eigenschaftenbereich für DialognameEnde der Unterhaltung aus.

Ihren Bot testen

Veröffentlichen Sie Ihre Composer-Inhalte, um sie in Ihrem Microsoft Copilot Studio-Bot 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.
Gehen Sie zur Seite Microsoft Copilot Studio Themen, um Ihr neues StartTrial-Thema anzeigen zu lassen.
Ö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.

Teilen über