Erstellen von Eingabeaufforderungsvorschlägen

Eingabeaufforderungsvorschläge sind Befehle, die den Benutzern im Microsoft Teams-Chat angezeigt werden.

Eingabeaufforderungsvorschläge schaffen eine ansprechende und aufschlussreiche Benutzererfahrung und helfen Ihrem Bot, Benutzer zu gewinnen und zu halten, indem sie ihnen den Wert Ihres Bots in eingabeaufforderungsbasierten Unterhaltungen zeigen. Sie können Eingabeaufforderungsvorschläge verwenden, um Ihren Benutzern zu helfen, Unterhaltungen mit Ihrem Bot zu initiieren und zu erfahren, wie sie mit diesem interagieren können.

Es gibt zwei Arten von Eingabeaufforderungsvorschlägen, die Sie verwenden können:

Eingabeaufforderungsstarter

Um Eingabeaufforderungsstarter zu aktivieren, definieren Sie die commands -Eigenschaft im App-Manifest Ihres Bots. Jeder Befehl enthält eine title und description. ist title die Eingabeaufforderung und beschreibt description , was die Benutzer erreichen. Wenn der Benutzer einen Eingabeaufforderungsstarter auswählt, wird die title der Eingabeaufforderung im Feld zum Verfassen aufgefüllt. Zum Definieren commands in Ihrem App-Manifest können Sie entweder das Entwicklerportal verwenden oder sie manuell im App-Manifest hinzufügen.

{
  ⋮
  "bots":[
    {
      "botId":"[Microsoft App ID for your bot]",
      "scopes": [
        "personal"
      ],
      "commandLists":[
        {
          "scopes":[
            "personal"
          ],
          "commands":[
            {
              "title":"Help",
              "description":"Displays this help message"
            },
            {
              "title":"Search Flights",
              "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm"
            },
            {
              "title":"Search Hotels",
              "description":"Search hotels in Portland tonight"
            },
            {
              "title":"Best Time to Fly",
              "description":"Best time to fly to London for a 5 day trip this summer"
            }
          ]
        }
      ]
    }
  ],
  ...
}

Im Folgenden wird ein Beispiel für Aufforderungsvorschläge veranschaulicht:

Eingabeaufforderungsstarter werden während einer Unterhaltung im Flyout Prompts anzeigen über dem Feld zum Verfassen wieder angezeigt und ermöglichen es Benutzern, die Eingabeaufforderungen während der Interaktion mit Ihrem Bot zu überprüfen.

Sie müssen Menübefehle in Ihrem Bot-Code behandeln, so wie Sie jede Nachricht von Benutzern behandeln. Sie können Menübefehle in Ihrem Botcode verarbeiten, indem Sie den @Mention Teil des Nachrichtentexts analysieren.

Handle commands in Deinem Bot

Bots in einer Gruppe oder einem Kanal antworten nur, wenn sie @mentioned sich in einer Nachricht befinden. Jede Nachricht, die von einem Bot empfangen wird, wenn er sich in einer Gruppe oder einem Kanalbereich befindet, enthält seinen Namen im Nachrichtentext. Bevor die Rückgabe des Befehls behandelt wird, muss die Nachrichten analysiert werden, die von einem Bot mit seinem Namen empfangen wurde.

// Remove recipient mention text from Text property.
// Use with caution because this function is altering the text on the Activity.
var modifiedText = turnContext.Activity.RemoveRecipientMention();

// Remove mention text from Text property, this function is altering the text on the Activity.
const modifiedText = TurnContext.removeMentionText(turnContext.activity, turnContext.activity.recipient.id);

# Remove recipient mention text from Text property, this function is altering the text on the Activity.
modified_text = TurnContext.remove_recipient_mention(turn_context.activity)

Empfohlene Maßnahmen

Vorgeschlagene Aktionen helfen Benutzern, basierend auf der vorherigen Antwort oder Unterhaltung ideen, was als Nächstes gefragt werden soll. Ihr Bot sollte dem Benutzer kontextspezifische Vorschläge statt generischer oder fester Vorschläge anbieten. Sie können das große Sprachmodell (LLM) Ihres Bots verwenden, um bis zu drei Vorschläge zusammen mit den zugehörigen Antworten zu generieren. Anschließend können Sie diese Vorschläge extrahieren und als Optionen darstellen, die der Benutzer auswählen kann.

Wenn ein Benutzer eine Schaltfläche auswählt, bleibt sie auf den Rich Cards sichtbar und zugänglich. Für vorgeschlagene Aktionen sind die Schaltflächen jedoch so konzipiert, dass sie nach der Auswahl ausgeblendet werden, um zu verhindern, dass der Benutzer veraltete Optionen auswählen kann, die möglicherweise nicht mehr relevant sind.

Um einer Nachricht vorgeschlagene Aktionen hinzuzufügen, geben Sie eine Liste von Karte Aktionsobjekten an, die die Schaltflächen darstellen, die dem Benutzer für die sugestedActions -Eigenschaft des Aktivitätsobjekts angezeigt werden sollen.

Im Folgenden finden Sie ein Beispiel zum Implementieren und Ausführen vorgeschlagener Aktionen:

{
  "type": "message",
  "from": {
    "id": "12345678",
    "name": "sender's name"
  },
  "conversation": {
    "id": "abcd1234",
    "name": "conversation's name"
  },
  "recipient": {
    "id": "1234abcd",
    "name": "recipient's name"
  },
  "text": "What are the tasks for the day.",
  "inputHint": "expectingInput",
  "suggestedActions": {
    "actions": [
      {
        "type": "imBack",
        "title": "Create a new query identifying overdue tasks",
        "value": "Create a new query identifying overdue tasks"
      },
      {
        "type": "imBack",
        "title": "Create a new work item for this feature",
        "value": "Create a new work item for this feature"
            }
        ]
    },
  "replyToId": "5d5cdc723"
}

Im Folgenden wird ein Beispiel für vorgeschlagene Aktionen veranschaulicht:

Codebeispiel

Siehe auch

• Erstellen von Bots für Teams
• App-Manifestschema für Teams
• Meldungen in Bot-Unterhaltungen
• Adaptive Karten für Botentwickler