Cortana

Wenn Sie einen Cortana-Kanal einrichten, können Benutzer mit Ihrem digitalen Assistenten (oder einem Standalone-Skill) über die Cortana-Benutzeroberfläche chatten.

Gehen Sie wie folgt vor, um einen Kanal einzurichten:

  1. Erstellen Sie eine Botregistrierung in Azure, die Sie mit Ihrem digitalen Assistenten integrieren können.
  2. Erstellen Sie mit der App-ID und dem Kennwort aus der Botregistrierung einen Kanal in Digital Assistant.
  3. Kopieren Sie die Webhook-URL, die bei der Kanalerstellung generiert wird, und fügen Sie sie zur Botregistrierung hinzu.
  4. Testen Sie Ihren digitalen Assistenten über das Chatfenster in der Cortana-Benutzeroberfläche.

Schritt 1: Botkanalregistrierung in Azure erstellen

Um Ihren digitalen Assistenten (oder einen Standalone-Skill) in Cortana zur Verfügung zu stellen, müssen Sie ihn über Azure Bot Service registrieren.

Bevor Sie diese Registrierung erstellen, benötigen Sie einen Microsoft-Account.

So erstellen Sie die Registrierung:

  1. Gehen Sie zu https://portal.azure.com/, und melden Sie sich mit Ihrem Microsoft-Account an.

  2. Suchen Sie im Suchfeld nach der Option Bot Channels Registration, und wählen Sie sie aus.

  3. Geben Sie auf der Seite Bot Channels Registration im Feld Bot Name den Text ein, den Sie beim Aufrufen Ihres digitalen Assistenten über den Cortana-Kanal als Aufrufname verwenden möchten.

  4. Füllen Sie die restlichen Pflichtfelder aus.

  5. Scrollen Sie nach unten, und wählen Sie Auto create App ID and password aus. Klicken Sie dann im geöffneten Fensterbereich auf die Schaltfläche für Auto create App ID and password.

  6. Klicken Sie auf Erstellen.

  7. Warten Sie 1-2 Minuten, bis die Botregistrierung erstellt und bereitgestellt wurde.

    Wenn der Vorgang abgeschlossen ist, erhalten Sie eine Benachrichtigung, dass das Deployment erfolgreich war.

  8. Klicken Sie in der Benachrichtigung auf Go to resource.

    Wenn die Benachrichtigung ausgeblendet wird, bevor Sie auf sie geklickt haben, können Sie sie erneut öffnen, indem Sie oben auf der Seite auf das Symbol "Benachrichtigungen" klicken.
    Eine Beschreibung von azure-notification.png folgt
    Beschreibung der Abbildung azure-notification.png

  9. Wählen Sie in der linken Navigationsleiste unter "Bot Management" die Option Settings aus.
  10. Kopieren Sie den Wert unter Microsoft App ID, und speichern Sie ihn an einem sicheren Ort.

  11. Generieren und speichern Sie ein Client Secret. Gehen Sie dazu wie folgt vor:
    1. Klicken Sie auf die Schaltfläche Manage neben der App-ID.

      Dadurch gelangen Sie zur Microsoft Bot Framework-Konsole.

    2. Klicken Sie auf View this app in the Azure portal.

      Dadurch kehren Sie zu Azure zurück.

    3. Klicken Sie in der linken Navigationsleiste auf Certificates & secrets.
    4. Klicken Sie auf + New Client Secret.
    5. Klicken Sie auf Add.
    6. Kopieren Sie das Client Secret, und speichern Sie es an einem sicheren Ort im System.

    Sie benötigen sowohl die App-ID als auch das Client Secret, um den Kanal in Digital Assistant zu konfigurieren.

  12. Nachdem Sie das Client Secret kopiert haben, schließen Sie das Dialogfeld Certificates & secrets.
  13. Lassen Sie das Azure-Portal in Ihrem Browser geöffnet.

    Sie schließen die Registrierung später mit einer Webhook-URL ab, die Sie beim Erstellen des Kanals in Digital Assistant erhalten.

Schritt 2: Kanal in Digital Assistant erstellen

  1. Klicken Sie in Digital Assistant im linken Menü auf Kanäle, und wählen Sie Benutzer aus.

  2. Klicken Sie auf + Kanal, um das Dialogfeld "Kanal erstellen" zu öffnen.

  3. Geben Sie einen Namen für Ihren Kanal ein.

  4. Wählen Sie Cortana als Kanaltyp aus.

  5. Geben Sie unter Microsoft-Bot-ID die Microsoft-App-ID ein, die Sie beim Erstellen der Botregistrierung in Azure erhalten haben.

  6. Geben Sie unter Microsoft Bot-Kennwort (Client Secret-Wert) den Client Secret-Wert ein, den Sie bei der Botregistrierung abgerufen haben.

  7. Klicken Sie auf Erstellen.

  8. Kopieren Sie die WebHook-URL auf der Seite "Kanäle", und fügen Sie sie an einer geeigneten Stelle in Ihrem System ein.

  9. Klicken Sie auf Symbol für die Dropdown-Liste "Weiterleiten an...", und wählen Sie den digitalen Assistenten oder Skill aus, den Sie mit dem Kanal verknüpfen möchten.

  10. Aktivieren Sie das Steuerelement Kanal aktiviert.

Schritt 3: Webhook-URL konfigurieren und in Cortana bereitstellen

  1. Navigieren Sie über das Suchfeld auf der Browserregisterkarte, in der das Azure-Portal geöffnet ist, zurück zu Ihrer Botregistrierung.

  2. Wählen Sie in der linken Navigationsleiste die Option Settings aus.

  3. Fügen Sie im Feld Messaging endpoint die Webhook-URL ein, die Sie bei der Kanalerstellung in Digital Assistant erhalten haben.

  4. Speichern Sie Ihre Änderungen.
  5. Scrollen Sie in Bot Service in der linken Navigationsleiste nach unten zum Abschnitt "Bot Management", und klicken Sie auf Channels.

  6. Klicken Sie auf das Symbol für Cortana.

  7. Nachdem Sie den Kanal konfiguriert haben, klicken Sie auf Deploy on Cortana.

Schritt 4: Bot in Cortana testen

Wenn Sie den Cortana-Kanal und das Messaging konfiguriert haben, können Sie Ihren Bot (digitalen Assistenten oder Skill) in Cortana testen.

Sie können den Test mit einer der folgenden Optionen ausführen:

  • Im Azure-Portal mit dem Feature "Test in Web Chat" (unter "Bot Management").
  • Über die Cortana-App (Desktop oder Mobil) mit derselben Benutzer-ID, die Sie beim Einrichten der Botregistrierung in Azure verwendet haben.

    Wenn Sie diese Methode beim Testen verwenden, müssen Sie den Botnamen (wie im Azure-Portal registriert) bei jeder Eingabe im Chatfenster angeben. Andernfalls erkennt Cortana nicht unbedingt, dass Sie versuchen, mit dem digitalen Oracle-Assistenten zu sprechen.

Unterstützte Funktionen

Cortana-Kanäle in Digital Assistant unterstützen die folgenden Funktionen:

  • Text (Senden und Empfangen)
  • Bilder (Senden wird vollständig unterstützt, Empfangen wird nicht unterstützt)
  • Dateien (Senden wird vollständig unterstützt, Empfangen wird nicht unterstützt)
  • Emojis (Senden wird vollständig unterstützt, Empfangen wird nicht unterstützt)
  • Links
  • Benutzerdefinierte Komponenten
  • Karussellkomponenten
  • Listenkomponenten
  • Eingabeindikator

Nachrichten-Constraints

Für Cortana-Kanäle in Digital Assistant gelten die folgenden Nachrichten-Constraints:

  • Textnachrichten
    • Maximale Länge der Textaktionslabel: 1 Zeile (ca. 50 Zeichen)
    • Zulässige Textaktionen: Postback, Aufruf, URL
  • Horizontale Karten
    • Maximale Länge des Titels: 2 Zeilen (ca. 80 Zeichen)
    • Maximale Länge der Beschreibung: 25.000 Zeichen
    • Maximale Länge des Kartenaktionslabels: 1 Zeile (ca. 50 Zeichen)
    • Maximale Anzahl der Karten: 10
    • Maximale Anzahl der Kartenaktionen: 6. Wenn die Anzahl der Kartenaktionen 6 überschreitet, wird die Karte dupliziert, um die verbleibenden Kartenaktionen wiederzugeben.
    • Mindestanzahl der Kartenaktionen: 0
    • Maximale Anzahl der Kartenlistenaktionen: 6
    • Ist mindestens eine Beschreibung, ein Bild oder eine Aktion erforderlich? Nein
    • Zulässige Arten von Kartenaktionen: Postback, Aufruf, URL
    • Zulässige Arten von Kartenlistenaktionen: Postback, Aufruf, URL
  • Vertikale Karten
    • Maximale Länge des Titels: 2 Zeilen (ca. 80 Zeichen)
    • Maximale Länge der Beschreibung: 25.000 Zeichen
    • Maximale Länge des Kartenaktionslabels: 1 Zeile (ca. 50 Zeichen)
    • Maximale Anzahl der Karten: 10
    • Maximale Anzahl der Kartenaktionen: 3
    • Mindestanzahl der Kartenaktionen: 0
    • Maximale Anzahl der Kartenlistenaktionen: 6
    • Ist mindestens eine Beschreibung, ein Bild oder eine Aktion erforderlich? Nein
    • Zulässige Arten von Kartenaktionen: Postback, Aufruf, URL
    • Zulässige Arten von Kartenlistenaktionen: Postback, Aufruf, URL
  • Anhangsnachrichten
    • Unterstützt? Ja
    • Zulässige Aktionsarten: Postback, Aufruf, URL
  • Aktionsschaltflächen
    • Maximale Länge des globalen Aktionslabels: 1 Zeile (ca. 50 Zeichen)
    • Maximale Anzahl globaler Aktionen: 6
    • Zulässige Arten von globalen Aktionen: Postback, Aufruf, URL

Cortana-Kanalerweiterungen

Bei Cortana-Kanälen können Sie die Funktionalität von Common Response-Komponenten um spezifische Cortana-Funktionen erweitern.

Sie können auf die Erweiterungen zugreifen, indem Sie das Element channelCustomProperties in der Komponente verwenden und die entsprechenden Eigenschaften festlegen. Der Code hat das folgende Format:

...
            channelCustomProperties:
            - channel: "cortana"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Nachfolgend finden Sie die verfügbaren benutzerdefinierten Eigenschaften für Cortana-Kanäle:

Name Zulässige Werte Gültig für... Beschreibung
speak
  • freier Text
  • SSML (Speech Synthesis Markup Language)
Antwortelemente vom Typ text. Der Text oder die SSML, den/die Cortana dem Benutzer vorliest. Siehe https://docs.microsoft.com/en-us/azure/bot-service/nodejs/bot-builder-nodejs-cortana-skill?view=azure-bot-service-3.0.

Weitere Informationen zur Verwendung von channelCustomProperties finden Sie unter Kanalspezifische Erweiterungen.