Uso del botón para la entrada de datos

SE APLICA A: SDK v4

Los botones mejoran la experiencia conversacional al permitir al usuario responder a una pregunta o seleccionar el botón deseado, en lugar de tener que escribir una respuesta con el teclado. A diferencia de los botones que aparecen en las tarjetas enriquecidas (que permanecen visibles y accesibles para el usuario incluso después de que se seleccionen), los botones que aparecen en el panel de acciones sugeridas desaparecerán una vez que el usuario haya hecho una selección. Esto evita que el usuario seleccione botones obsoletos dentro de una conversación y simplifica el desarrollo del bot, ya que no tendrá que tener en cuenta ese escenario.

Nota:

Para crear agentes con su elección de servicios de inteligencia artificial, orquestación y conocimientos, considere la posibilidad de usar el SDK de agentes de Microsoft 365. El SDK de agentes admite C#, JavaScript o Python. Puede obtener más información sobre el SDK de agentes en aka.ms/agents. Si busca una plataforma de agente basada en SaaS, considere Microsoft Copilot Studio. Si tiene un bot existente creado con Bot Framework SDK, puede actualizar el bot al SDK de agentes. Puede revisar los cambios principales y las actualizaciones en la guía de migración del Bot Framework SDK al SDK de Agentes. Las incidencias de soporte técnico del SDK de Bot Framework ya no se atenderán a partir del 31 de diciembre de 2025.

Acción sugerida con un botón

Las acciones sugeridas permiten al bot presentar botones. Puede crear una lista de acciones sugeridas (también conocidas como respuestas rápidas) que se mostrarán al usuario para un único turno de la conversación:

C#

Este es un ejemplo del ejemplo de acciones 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

Este es un ejemplo del ejemplo de acciones 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

Este es un ejemplo del ejemplo de acciones sugeridas.

Advertencia

¡Parece que la muestra que está buscando ha sido trasladada! Está seguro de que estamos trabajando para resolver esto.

Pitón

Este es un ejemplo del ejemplo de acciones 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 adicionales

Puede acceder al código fuente completo para el ejemplo de acciones sugeridas en C#, JavaScript, Java y Python.

Pasos siguientes

Guardar usuario y datos de conversación