Crear sugerencias de aviso

Las sugerencias de aviso son comandos que se presentan a los usuarios en el chat de Microsoft Teams.

Las sugerencias de aviso crean una experiencia de usuario atractiva e detallada y ayudan al bot a adquirir y conservar usuarios mostrándoles el valor del bot a través de conversaciones rápidas. Puede usar sugerencias de aviso para ayudar a los usuarios a iniciar conversaciones con el bot y aprender a interactuar con él.

Hay dos tipos de sugerencias de aviso que puede usar:

Inicios de aviso

Los inicios de aviso se admiten en chats uno a uno, chats de grupo y canales. Para habilitar los inicios de mensajes, defina la propiedad en el commands manifiesto de aplicación del bot. Cada comando contiene cuatro campos: title, description, typey prompt.

• El title campo es el texto que se muestra en el inicio del aviso. Cuando se selecciona, este texto se rellena en el cuadro de redacción.
• El description campo describe lo que realizan los usuarios.
• El type campo indica si el comando del bot es básico o un símbolo del sistema. Establézcalo type en preguntar y proporcione el texto en el campo de solicitud. Cuando se selecciona, el texto de la solicitud aparece en el cuadro de redacción en lugar del título o la descripción.
• El prompt campo especifica el texto que aparece en el cuadro de redacción de un comando del símbolo del sistema. Admite hasta 4000 caracteres.

Definir commands en el manifiesto de la aplicación

Para crear un inicio rápido, agréguelo directamente en el archivo de manifiesto de la aplicación mientras desarrolla el código fuente del bot. Para usar este método, siga estos puntos:

• La command propiedad admite hasta 10 comandos.
• Puede crear inicios de aviso que funcionen en todos los ámbitos o crear inicios de aviso diferentes para cada ámbito.

Ejemplo de manifiesto para los inicios de mensajes

El código de ejemplo de manifiesto para los inicios de mensajes es el siguiente:

{
  ⋮
  "bots":[
    {
      "botId":"[Microsoft App ID for your bot]",
      "scopes": [
        "personal"
      ],
      "commandLists":[
        {
          "scopes":[
            "personal"
          ],
          "commands":[
            {
              "title":"Help",
              "description":"Displays this help message"
            },
            {
              "title":"Search Flights",
              "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm",
              "type": "prompt",
              "prompt": "Search flights from Seattle to Phoenix May 2-5 departing after 3pm. Please show me the best options."
            },
            {
              "title":"Search Hotels",
              "description":"Search hotels in Portland tonight",
              "type": "prompt",
              "prompt": "Search hotels in Portland for tonight. Please show me available options with good ratings."
            },
            {
              "title":"Best Time to Fly",
              "description":"Best time to fly to London for a 5 day trip this summer",
              "type": "prompt",
              "prompt": "What is the best time to fly to London for a 5 day trip? I'm looking for good weather and reasonable prices."
            }
          ]
        }
      ]
    }
  ],
  ...
}

En la imagen siguiente se muestra un ejemplo de sugerencias de aviso:

Los inicios de aviso vuelven a aparecer en el control flotante Ver Consultas encima del cuadro de redacción durante una conversación. Permiten a los usuarios revisar los mensajes mientras interactúan con el bot.

Acciones recomendadas

Las acciones sugeridas ayudan a los usuarios con ideas sobre qué preguntar a continuación, en función de la respuesta o la conversación anteriores. El agente o bot debe ofrecer sugerencias específicas del contexto al usuario, en lugar de genéricas o fijas. Puede usar el modelo de lenguaje grande (LLM) del agente o bot para generar hasta tres sugerencias junto con sus respuestas. A continuación, puede extraer estas sugerencias y presentarlas como opciones para que el usuario elija. Puede crear las siguientes acciones sugeridas en el agente o bot:

• imBack: se usa imBack para agregar acciones sugeridas, establecer activity.suggestedActions en una lista de acciones de tarjeta (botones) para mostrar al usuario.
• Action.Compose: se usa Action.Compose para rellenar previamente el cuadro de redacción con un mensaje (incluidas las etiquetas, @mentionsy el contenido enriquecido, como emojis, GIF y otros objetos semánticos).
• Action.Submit: se usa Action.Submit para los botones de acción sugeridos en las respuestas del agente para los comandos de barra diagonal que desencadenan lógica del lado servidor a través de una actividad de invocación (ningún mensaje de chat visible por el usuario).

Cuando un usuario selecciona un botón, permanece visible y accesible en las tarjetas enriquecidas. Las acciones sugeridas se admiten en todos los ámbitos:

• personal: en los chats uno a uno, las acciones se muestran como respuestas inteligentes, por lo que solo aparecen las acciones del último mensaje.
• team y groupChat: en los chats y canales de grupo, las acciones siempre se guardan con el mensaje.

Estos son algunos ejemplos que muestran cómo implementar y experimentar acciones sugeridas mediante imBack, Action.Composey Action.Submit:

{
  "type": "message",
  "from": {
    "id": "12345678",
    "name": "sender's name"
  },
  "conversation": {
    "id": "abcd1234",
    "name": "conversation's name"
  },
  "recipient": {
    "id": "1234abcd",
    "name": "recipient's name"
  },
  "text": "What are the tasks for the day.",
  "inputHint": "expectingInput",
  "suggestedActions": {
    "actions": [
      {
        "type": "imBack",
        "title": "Create a new query identifying overdue tasks",
        "value": "Create a new query identifying overdue tasks"
      },
      {
        "type": "imBack",
        "title": "Create a new work item for this feature",
        "value": "Create a new work item for this feature"
            }
        ]
    },
  "replyToId": "5d5cdc723"
}

{ 
   Type: “Action.Compose”, 
   Title: “button title”, 
   Value: { 
      type: “Teams.chatMessage”, 
      data: <GraphAPI Chat Message Object> 
   } 
}

{
  "suggestedActions": {
    "actions": [{
      "type": "Action.Submit",
      "title": "Approve",
      "value": {
        "vote": "approve"
      }
    }]
  }
}

// In TeamsActivityHandler.onInvokeActivity():
case "suggestedAction/submit":
  const vote = context.activity.value;  // { vote: "approve" }
  // Process the action...
  return { status: 200 };

Ejemplo de código

Consulte también

• Crear bots para Teams
• Esquema del manifiesto de la aplicación de Teams
• Mensajes en conversaciones de bot
• Tarjetas adaptables para desarrolladores de bots