Resaltar las funcionalidades del agente con inicios de aviso

Los inicios de aviso son avisos de lenguaje natural listos para usar incluidos con un agente que resaltan el propósito y las capacidades del agente.

Los usuarios pueden detectar los inicios de aviso en el chat de Teams. Cuando un usuario selecciona uno de los inicios de aviso de un agente, Teams inserta su texto de aviso en el cuadro de redacción.

Captura de pantalla que muestra el inicio del mensaje en el escritorio.

Los inicios de aviso están disponibles en chats uno a uno, chats grupales y canales.

Experiencia del usuario

En los chats uno a uno con un agente, los inicios de aviso siempre están disponibles en el control flotante Ver Consultas situado encima del cuadro de redacción.

Captura de pantalla del control flotante del inicio del aviso abierto encima del cuadro de redacción.

En el caso de los agentes que no inician conversaciones uno a uno de forma proactiva con un mensaje de bienvenida, Teams muestra sus inicios de aviso como tarjetas en el panel de conversación hasta que el usuario envía su primer mensaje.

En los chats y canales de grupo, los inicios de aviso de un agente aparecen en un menú de autocompletar junto al cuadro de redacción de un usuario después @mentioning del agente.

Definición de inicios de aviso para un agente

Los inicios de aviso se configuran en el manifiesto de aplicación de un agente a partir commands de "type": "prompt".

{
  "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."
            }
          ]
        }
      ]
    }
  ],
  ...
}

Los comandos de inicio de aviso deben tener y type"prompt" deben definir un prompt valor de hasta 4000 caracteres.

Cada inicio del title aviso y description se presentan a los usuarios en el chat de Teams. Cuando un usuario selecciona un inicio de aviso, Teams inserta su prompt valor en el cuadro de redacción del usuario.

Los agentes pueden presentar diferentes inicios de aviso en ámbitos diferentes mediante la creación de varias commandLists. Cada commandList uno puede especificar uno o varios ámbitos y puede especificar hasta 12 comandos en su commands lista.

commandLists y commands en el manifiesto de aplicación también se usan para configurar comandos de barra diagonal del agente. Para obtener más información sobre la estructura del manifiesto de la aplicación, consulte la referencia del manifiesto de la aplicación.

Procedimientos recomendados e instrucciones de diseño

Los agentes de Teams siempre deben ayudar a los usuarios a comprender sus funcionalidades "presentándose a sí mismos" con inicios inmediatos, mensajes de bienvenida o ambos. Los agentes distribuidos a través de la Tienda Teams que se pueden instalar en el ámbito personal (conversaciones uno a uno con los usuarios) deben implementar una u otra.

Los inicios de mensajes no son dinámicos ni contextuales, y solo puede cambiarlos si vuelve a publicar el manifiesto de un agente. Para proporcionar dinámicamente a los usuarios opciones de comandos y respuestas rápidas en el chat, use acciones sugeridas y tarjetas adaptables.

Los inicios de aviso son para mostrar mensajes de agente de lenguaje natural. Para mejorar la detectabilidad y la facilidad de uso de los comandos de texto corto que expone el agente, configure los comandos de barra diagonal en su lugar.

Vea también

  • Se actualizó por última vez el