Usar botão para inserir

APLICA-SE A: SDK v4

Os botões melhoram a experiência de conversação, permitindo que o usuário responda a uma pergunta ou selecione o botão desejado, em vez de ter que digitar uma resposta com um teclado. Ao contrário dos botões que aparecem dentro de cartões ricos (que permanecem visíveis e acessíveis ao usuário mesmo depois de selecionados), os botões que aparecem dentro do painel de ações sugeridas desaparecerão depois que o usuário fizer uma seleção. Isso impede que o usuário selecione botões obsoletos dentro de uma conversa e simplifica o desenvolvimento do bot, já que você não precisará levar em conta esse cenário.

Nota

Para criar agentes com sua escolha de serviços, orquestração e conhecimento de IA, considere usar o SDK de agentes do Microsoft 365. O SDK de agentes tem suporte para C#, JavaScript ou Python. Você pode saber mais sobre o SDK de agentes em aka.ms/agents. Se você estiver procurando por uma plataforma de agente baseada em SaaS, considere o Microsoft Copilot Studio. Se você tiver um bot existente criado com o SDK do Bot Framework, poderá atualizar seu bot para o SDK de agentes. Você pode revisar as principais alterações e atualizações nas diretrizes de migração do SDK do Bot Framework para o SDK de agentes. Os tíquetes de suporte para o SDK do Bot Framework não serão mais atendidos a partir de 31 de dezembro de 2025.

Sugerir ação usando o botão

As ações sugeridas permitem que seu bot apresente botões. Você pode criar uma lista de ações sugeridas (também conhecidas como respostas rápidas) que serão mostradas ao usuário para um único turno da conversa.

C#

Aqui está um exemplo do exemplo de ações sugeridas.

// 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

Aqui está um exemplo do exemplo de ações sugeridas.

        }
    }
}

/**
 * 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'
        }
    ];

Java

Aqui está um exemplo do exemplo de ações sugeridas.

Advertência

Parece que a amostra que você está procurando se moveu! Podem ter a certeza de que estamos a trabalhar para resolver este problema.

Píton

Aqui está um exemplo do exemplo de ações sugeridas.

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)

Recursos adicionais

Você pode acessar o código-fonte completo para o exemplo de ações sugeridas em C#, JavaScript, Java e Python.

Próximos passos

Save user and conversation data (Guardar dados da conversação e do utilizador)