Usare pulsanti per l'input

SI APPLICA A: SDK v4

I pulsanti migliorano l'esperienza di conversazione consentendo all'utente di rispondere a una domanda o selezionare il pulsante desiderato, invece di dover digitare una risposta con una tastiera. A differenza dei pulsanti visualizzati all'interno di schede avanzate (che rimangono visibili e accessibili all'utente anche dopo essere stati selezionati), i pulsanti visualizzati all'interno del riquadro azioni suggeriti scompariranno dopo che l'utente effettua una selezione. Ciò impedisce all'utente di selezionare pulsanti non aggiornati all'interno di una conversazione e semplifica lo sviluppo di bot perché non è necessario tenere conto di tale scenario.

Importante

Bot Framework SDK e Bot Framework Emulator sono stati archiviati in GitHub. Il progetto non viene più aggiornato o mantenuto. I ticket di supporto per Bot Framework SDK non verranno più gestiti a partire dal 31 dicembre 2025.

Per creare agenti con la scelta di servizi di intelligenza artificiale, orchestrazione e conoscenze, è consigliabile usare Microsoft 365 Agents SDK. Agents SDK include il supporto del linguaggio per C#, JavaScript o Python. Per altre informazioni su Agents SDK , vedere aka.ms/agents. Se si dispone di un bot esistente compilato con Bot Framework SDK, è possibile aggiornare il bot ad Agents SDK. Esaminare le modifiche e gli aggiornamenti di base nelle linee guida per la migrazione da Bot Framework SDK verso Agents SDK.

Se si sta creando un agente collaborativo progettato per funzionare all'interno di Microsoft Teams, è consigliabile usare Teams SDK. Fornisce API specifiche di Teams, supporto per schede adattive e orchestrazione di intelligenza artificiale predefinita per gli agenti eseguiti nell'ambiente Teams. Per altre informazioni, vedere Teams SDK (Libreria di intelligenza artificiale di Teams).

Se si sta cercando una piattaforma agente basata su SaaS, prendere in considerazione Microsoft Copilot Studio.

Suggerire le azioni con il pulsante

Le azioni suggerite consentono al bot di presentare pulsanti. È possibile creare un elenco di azioni suggerite (note anche come risposte rapide) che verranno visualizzate all'utente per un singolo turno della conversazione.

C#

Di seguito è riportato un esempio dell'esempio di azioni suggerite.

// 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);
}

JavaScript

Di seguito è riportato un esempio dell'esempio di azioni suggerite.

        }
    }
}

/**
 * Send suggested actions to the user.
 * @param {TurnContext} turnContext A TurnContext instance containing all the data needed for processing this conversation turn.
 */
async sendSuggestedActions(turnContext) {
    const cardActions = [
        {
            type: ActionTypes.PostBack,
            title: 'Red',
            value: 'Red',
            image: 'https://placehold.co/20/red/red?text=R',
            imageAltText: 'R'
        },
        {
            type: ActionTypes.PostBack,
            title: 'Yellow',
            value: 'Yellow',
            image: 'https://placehold.co/20/yellow/yellow?text=Y',
            imageAltText: 'Y'
        },
        {
            type: ActionTypes.PostBack,
            title: 'Blue',
            value: 'Blue',
            image: 'https://placehold.co/20/blue/blue?text=B',
            imageAltText: 'B'
        }
    ];

Giava

Di seguito è riportato un esempio dell'esempio di azioni suggerite.

/**
 * 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 CompletableFuture<Void> sendSuggestedActions(TurnContext turnContext) {
    Activity reply = MessageFactory.text("What is your favorite color?");

    CardAction redAction = new CardAction();
    redAction.setTitle("Red");
    redAction.setType(ActionTypes.IM_BACK);
    redAction.setValue("Red");
    redAction.setImage("https://via.placeholder.com/20/FF0000?text=R");
    redAction.setImageAltText("R");

    CardAction yellowAction = new CardAction();
    yellowAction.setTitle("Yellow");
    yellowAction.setType(ActionTypes.IM_BACK);
    yellowAction.setValue("Yellow");
    yellowAction.setImage("https://via.placeholder.com/20/FFFF00?text=Y");
    yellowAction.setImageAltText("Y");

    CardAction blueAction = new CardAction();
    blueAction.setTitle("Blue");
    blueAction.setType(ActionTypes.IM_BACK);
    blueAction.setValue("Blue");
    blueAction.setImage("https://via.placeholder.com/20/0000FF?text=B");
    blueAction.setImageAltText("B");

    SuggestedActions actions = new SuggestedActions();
    actions.setActions(Arrays.asList(redAction, yellowAction, blueAction));
    reply.setSuggestedActions(actions);
    return turnContext.sendActivity(reply).thenApply(sendResult -> null);
}

Pitone

Di seguito è riportato un esempio dell'esempio di azioni suggerite.

async def _send_suggested_actions(self, turn_context: TurnContext):
    """
    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.
    """

    reply = MessageFactory.text("What is your favorite color?")

    reply.suggested_actions = SuggestedActions(
        actions=[
            CardAction(
                title="Red",
                type=ActionTypes.im_back,
                value="Red",
                image="https://via.placeholder.com/20/FF0000?text=R",
                image_alt_text="R",
            ),
            CardAction(
                title="Yellow",
                type=ActionTypes.im_back,
                value="Yellow",
                image="https://via.placeholder.com/20/FFFF00?text=Y",
                image_alt_text="Y",
            ),
            CardAction(
                title="Blue",
                type=ActionTypes.im_back,
                value="Blue",
                image="https://via.placeholder.com/20/0000FF?text=B",
                image_alt_text="B",
            ),
        ]
    )

    return await turn_context.send_activity(reply)

Risorse aggiuntive

È possibile accedere al codice sorgente completo per l'esempio di azioni suggerite in C#, JavaScript, Java e Python.

Passaggi successivi

Salvare i dati dell'utente e della conversazione