Compartir a través de


Mostrar un formulario con un botón Enviar en Copilot Studio

Nota

Este artículo se aplica únicamente a los chatbots clásicos . Para ampliar los copilotos creados en Copilot Studio, no es necesario utilizar Bot Framework Composer. Todas las funciones descritas en este artículo están disponibles para los copilotos, directamente en Copilot Studio.

Mejora tu chatbot desarrollando diálogos personalizados con Bot Framework Composer y luego agregándolos a un copiloto creado en Copilot Studio.

En este ejemplo, aprenderá cómo mostrar un formulario con un botón Enviar en Copilot Studio mediante Composer.

Importante

La integración de Composer no está disponible para los usuarios que solo tengan la licencia de Teams Microsoft Copilot Studio Debe tener una licencia de prueba o completa de Microsoft Copilot Studio.

Requisitos previos

Creación de un nuevo desencadenador

  1. En Copilot Studio, abra el copiloto del Ejemplo 3. Si aún no ha completado el Ejemplo 3, consulte Usar Bing Search como alternativa en Copilot Studio.

  2. Abra su bot en Composer. Para obtener instrucciones sobre cómo hacerlo, consulte Comenzar a usar Bot Framework Composer.

  3. En el explorador de bots, vaya al cuadro de diálogo principal. Seleccione Más opciones (...) y luego seleccione Administrar nuevo desencadenador.

  4. En la ventana Crear un desencadenador:

    1. Para ¿Cuál es el tipo de este desencadenador?, seleccione Intención reconocida.

    2. Para ¿Cuál es el nombre de este desencadenador?, ingrese StartTrial.

    3. Para Frases desencadenadoras, copie y pegue lo siguiente:

      - start trial
      - sign up to try
      - register to try service
      
    4. Seleccione Enviar.

    Captura de pantalla de la ventana Crear un desencadenador.

  5. Vaya a la página Respuestas de bot, seleccione Servicio de entrega de comidas de Contoso, luego seleccione Mostrar código.

  6. Copie y pegue lo siguiente en la vista de código:

    # adaptivecardjson_StartTrialForm()
    - ```
    {
        "type": "AdaptiveCard",
        "body": [
            {
                "type": "TextBlock",
                "size": "Medium",
                "weight": "Bolder",
                "text": "Register for a meal plan trial:"
            },
            {
                "type": "Input.Text",
                "placeholder": "Please enter your Name",
                "id": "Name"
            },
            {
                "type": "Input.Text",
                "placeholder": "Please enter your Address",
                "id": "Address",
                "isMultiline": true
            },
            {
                "type": "Input.Number",
                "placeholder": "How many weeks",
                "id": "Weeks"
            },
            {
                "type": "ActionSet",
                "actions": [
                    {
                        "type": "Action.Submit",
                        "title": "Submit",
                        "style": "positive"
                    }
                ]
            }
        ],
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.2"
    }
    ```
    

    Cada campo de entrada de esta tarjeta adaptable tiene Id. único: Nombre, Dirección, y Semanas.

    Captura de pantalla de la Tarjeta adaptable JSON agregada a las respuestas del bot.

  7. Copie y pegue el siguiente código en la misma vista de código:

    # AdaptiveCard_StartTrialForm()
    [Activity
        Attachments = ${json(adaptivecardjson_StartTrialForm())}
    ]
    

    Captura de pantalla de la actividad agregada a las respuestas del bot.

Agregar lógica de conversación

  1. Vaya a la pestña Crear y seleccione el desencadenador StartTrial.

  2. En el lienzo de creación, seleccione Agregar (+), Formular una pregunta y Texto.

  3. En el panel de propiedades, bajo la sección Actividad, seleccione Mostrar código.

    Advertencia

    Al agregar la siguiente expresión en el siguiente paso al editor de respuesta en lugar de al editor de código, el bot responderá con JSON sin formato en lugar de una tarjeta adaptable.

  4. Copie y pegue la expresión siguiente:

    - ${AdaptiveCard_StartTrialForm()}
    

    Captura de pantalla del mensaje para respuesta de texto.

  5. Seleccione la pestaña Entrada de usuario en el panel de propiedades, luego haga lo siguiente:

    1. Para Propiedad, ingrese user.name.
    2. Para Valor, introduzca =turn.activity.value.Name.

    Captura de pantalla de la acción de entrada de usuario.

  6. En el lienzo de creación, seleccione Agregar (+), Administrar propiedades y Establece propiedades.

  7. En el panel de propiedades, realice las siguientes acciones:

    1. En Asignaciones, seleccione Agregar nuevo para agregar un cuadro Propiedad y un cuadro Valor.
    2. Para Propiedad, ingrese user.address
    3. Para Valor, introduzca =turn.activity.value.Address.
    4. Seleccione Agregar nuevo otra vez para agregar otra Propiedad y Valor.
    5. Para Propiedad, ingrese user.weeks.
    6. Para Valor, introduzca =turn.activity.value.Weeks.

    Captura de pantalla de la acción Establecer propiedades.

  8. En el lienzo de creación, seleccione Agregar (+) y luego seleccione Enviar una respuesta.

  9. En el editor de respuesta, copie y pegue lo siguiente:

    ${user.name} - thanks for starting a ${user.weeks} week trial with us! Your meals will be delivered to this address: ${user.address}.
    

    Captura de pantalla de la respuesta de confirmación.

  10. En el lienzo de creación, seleccione Agregar (+) y luego seleccione Comenzar un tema de Microsoft Copilot Studio.

  11. En el panel de propiedades, para Nombre del diálogo, seleccione Fin de la conversación.

    Captura de pantalla de la acción Comenzar un tema de Microsoft Copilot Studio.

Probar su bot

  1. Publica tu contenido de Composer para que esté disponible en tu copiloto. Copilot Studio

    Importante

    Si selecciona Publicar en Composer, los cambios estarán disponibles para pruebas, pero no se publica automáticamente su bot.

    Publica tu bot en Microsoft Copilot Studio para actualizar tu bot en todos los canales a los que está conectado.

  2. Vaya a la página de Copilot Studio Temas para ver su nuevo StartTrial tema.

    Captura de pantalla del nuevo tema visible en Copilot Studio.

  3. Abra el Panel de bot de prueba y asegúrese de que Seguimiento entre temas está activado. Introduzca el mensaje How do I sign up for a trial? para iniciar su conversación.

    Captura de pantalla del panel Probar bot. Copilot Studio