Verwenden von Schaltflächen für die EingabeUse button for input

gilt für: SDK v4APPLIES TO: SDK v4

Schaltflächen verbessern die Konversationserfahrung, indem der Benutzer eine Frage beantworten oder die gewünschte Schaltfläche auswählen kann, anstatt eine Antwort mit einer Tastatur eingeben zu müssen.Buttons enhance the conversational experience by letting the user answer a question or select the desired button, rather than having to type a response with a keyboard. Im Gegensatz zu Schaltflächen, die auf Rich Cards angezeigt werden (die auch nach der Auswahl sichtbar und für den Benutzer zugänglich bleiben), werden Schaltflächen, die im Bereich der vorgeschlagenen Aktionen angezeigt werden, nicht mehr angezeigt, nachdem der Benutzer eine Auswahl getroffen hat.Unlike buttons that appear within rich cards (which remain visible and accessible to the user even after being selected), buttons that appear within the suggested actions pane will disappear after the user makes a selection. Dadurch wird verhindert, dass der Benutzer veraltete Schaltflächen innerhalb einer Konversation auswählt, und vereinfacht die Botentwicklung, da Sie dieses Szenario nicht berücksichtigen müssen.This prevents the user from selecting stale buttons within a conversation and simplifies bot development since you won't need to account for that scenario.

Vorschlagen einer Aktion mithilfe von SchaltflächenSuggest action using button

Vorgeschlagene Aktionen ermöglichen Ihrem Bot das Anzeigen von Schaltflächen.Suggested actions enable your bot to present buttons. Sie können eine Liste mit vorgeschlagenen Aktionen (auch als Schnelle Antworten bezeichnet) erstellen, die dem Benutzer für einen einzelnen Durchkn.You can create a list of suggested actions (also known as quick replies) that will be shown to the user for a single turn of the conversation.

Der hier angegebene Quellcode basiert auf dem Beispiel zum Vorschlagen von Aktionen.The source code shown here is based on the Suggested actions sample.

// Creates and sends an activity with suggested actions to the user. When the user
/// clicks one of the buttons the text value from the "CardAction" will be
/// displayed in the channel just as if the user entered the text. There are multiple
/// "ActionTypes" that may be used for different situations.
private static async Task SendSuggestedActionsAsync(ITurnContext turnContext, CancellationToken cancellationToken)
{
    var reply = MessageFactory.Text("What is your favorite color?");

    reply.SuggestedActions = new SuggestedActions()
    {
        Actions = new List<CardAction>()
        {
            new CardAction() { Title = "Red", Type = ActionTypes.ImBack, Value = "Red", Image = "https://via.placeholder.com/20/FF0000?text=R", ImageAltText = "R" },
            new CardAction() { Title = "Yellow", Type = ActionTypes.ImBack, Value = "Yellow", Image = "https://via.placeholder.com/20/FFFF00?text=Y", ImageAltText = "Y" },
            new CardAction() { Title = "Blue", Type = ActionTypes.ImBack, Value = "Blue", Image = "https://via.placeholder.com/20/0000FF?text=B", ImageAltText = "B"   },
        },
    };
    await turnContext.SendActivityAsync(reply, cancellationToken);
}

Zusätzliche RessourcenAdditional resources

Sie können auf den vollständigen Quellcode für das Beispiel für vorgeschlagene Aktionen in C#, JavaScript, Java und Python zugreifen.You can access the complete source code for the Suggested actions sample in C#, JavaScript, Java and Python.

Nächste SchritteNext steps