Exposición de comandos de barra diagonal desde agentes y aplicaciones

Los comandos de barra diagonal ayudan a los usuarios a detectar y usar la funcionalidad de comandos con nombre en las aplicaciones y agentes de Teams.

Si el agente o la aplicación tienen funcionalidad que los usuarios deben poder invocar con comandos con nombre, puede agregar una configuración que haga que esos comandos se puedan detectar rápidamente y sean accesibles desde el cuadro de redacción de mensajes de Teams. Los comandos de barra diagonal con nombre pueden ayudar a los usuarios a acceder a la guía, crear tareas de seguimiento personales o administrar opciones de personalización.

¿Qué es un comando de barra diagonal?

Los comandos de barra diagonal en Teams son accesos directos basados en texto que permiten a los usuarios realizar acciones desde el cuadro de redacción en las conversaciones. Cuando un usuario escribe en un / cuadro de redacción vacío, Teams muestra un menú autocompletar que contiene comandos integrados para tareas comunes que se pueden invocar inmediatamente seleccionándolos.

La característica de comandos de barra diagonal permite a las aplicaciones y agentes agregar sus propios comandos a esta lista para ayudar a los usuarios a detectarlos y usarlos.

Tipos de comandos de barra diagonal

Las aplicaciones y los agentes pueden exponer tres tipos de comandos a través de su configuración:

• Mensajería de destino: los usuarios envían mensajes de destino a los agentes escribiendo el nombre de un agente como comando de barra diagonal, cambiando el cuadro de redacción al modo de mensaje de destino
• Comandos de barra diagonal del agente: comandos con nombre de Surface para los usuarios en el menú de autocompletar de comandos de barra diagonal
• Comandos de barra diagonal de extensión de mensaje: permitir que los usuarios activen las extensiones de mensaje de la aplicación o del agente con un comando de barra diagonal

Los tres tipos se admiten en todas las plataformas cliente, incluido el móvil.

Mensajería dirigida

Los usuarios envían mensajes de destino a los agentes escribiendo el nombre de un agente como un comando de barra diagonal.

En canales, chats de grupo y chats de reunión, el menú autocompletar de comandos de barra diagonal incluye comandos con el nombre de cada agente de la conversación apto para recibir mensajes de destino.

Al activar uno de estos comandos, se cambia el cuadro de redacción al modo de mensaje de destino para el agente. Una vez que el usuario redacta un mensaje y selecciona Enviar, el mensaje resultante se dirigirá al agente y otros participantes no podrán verlo en la conversación.

Para obtener más información, consulte Envío y recepción de mensajes de destino en conversaciones de grupo.

Comandos de barra diagonal del agente

Los comandos de barra diagonal del agente permiten a los agentes exponer comandos con nombre que los usuarios pueden invocar de forma privada en canales, chats de grupo y chats de reuniones. Los comandos de barra diagonal son útiles para la funcionalidad a la que los usuarios necesitan acceder de forma rápida y privada en las conversaciones en grupo.

En canales, chats de grupo y chats de reunión, el menú autocompletar de comandos de barra diagonal incluye todos los comandos registrados por los agentes en la conversación actual. Cada comando se muestra con su descripción y el nombre y el icono de su agente, lo que hace que se puedan detectar y distinguir entre comandos con el mismo nombre.

Al invocar un comando desde el menú, el cuadro de redacción cambia al modo de mensajería de destino para el agente e inserta el nombre del comando como texto del mensaje. Al seleccionar Enviar , se envía el mensaje de destino al agente.

Comandos de barra diagonal de extensión de mensaje

Las aplicaciones que implementan extensiones de mensaje de tipo acción pueden exponerlas como comandos de barra diagonal. Cuando un usuario activa uno desde el menú autocompletar, Teams abre inmediatamente el cuadro de diálogo o módulo de tareas asociado. Al activar un comando de barra diagonal de extensión de mensaje, solo se abre el módulo de tareas o el cuadro de diálogo y no se envía un mensaje. Las extensiones de mensaje de tipo de búsqueda no se pueden exponer como comandos.

Los comandos de barra diagonal de extensión de mensaje se pueden configurar para que aparezcan como entradas de autocompletar tanto en el cuadro de redacción como en el cuadro de comandos de Teams.

Agregar comandos

Los comandos de mensajería y barra diagonal de destino se configuran a través del manifiesto de la aplicación o del agente.

Mensajería dirigida

Consulte Recepción de mensajes de destino para obtener más información sobre cómo habilitar un agente para recibir mensajes de destino.

Comandos de barra diagonal del agente

Los comandos de barra diagonal del agente requieren que un agente opte por recibir mensajes de destino; consulte Recepción de mensajes de destino.

Declare los comandos configurando la bots[].commandLists[] sección del manifiesto como se muestra en el ejemplo siguiente.

{
    "bots": [
        {
            "botId": "{{BOT_ID}}",
            "scopes": ["personal", "team", "groupChat"],
            "supportsTargetedMessages": true,
            "commandLists": [
                {
                    "scopes": ["personal", "team", "groupChat"],
                    "triggers": ["mention"],
                    "commands": [
                        { "title": "Summarize", "description": "Summarize a document" },
                        { "title": "Draft", "description": "Draft a document" }
                    ]
                },
                {
                    "scopes": ["team", "groupChat"],
                    "triggers": ["slash"],
                    "commands": [
                        { "title": "Review", "description": "Review a document" }
                    ]
                }
            ]
        }
    ]
}

Use el ejemplo siguiente para configurar el manifiesto de aplicación para admitir un agente o un bot que haga que los mismos comandos estén disponibles para los desencadenadores de @mention barra diagonal y .

{
    "bots": [
        {
            "botId": "{{BOT_ID}}",
            "scopes": ["personal", "team", "groupChat"],
            "supportsTargetedMessages": true,
            "commandLists": [
                {
                    "scopes": ["team", "groupChat"],
                    "triggers": ["mention", "slash"],
                    "commands": [
                        { "title": "Ask privately", "description": "Send a private question to the bot" },
                        { "title": "Help", "description": "Get help using this bot" }
                    ]
                }
            ]
        }
    ]
}

Comandos de barra diagonal de extensión de mensaje

Use la triggers propiedad de composeExtensions[].commands[] para exponer extensiones de mensaje como comandos de barra diagonal.

{
    "composeExtensions": [
        {
            "botId": "{{BOT_ID}}",
            "commands": [
                {
                    "id": "summarizeCommand",
                    "type": "action",
                    "title": "Summarize",
                    "description": "Summarize a document",
                    "context": ["compose", "commandBox"]
                },
                {
                    "id": "draftCommand",
                    "type": "action",
                    "title": "Draft",
                    "description": "Draft a document",
                    "context": ["compose", "commandBox"],
                    "triggers": ["slash"]
                },
                {
                    "id": "reviewCommand",
                    "type": "action",
                    "title": "Review",
                    "description": "Review a document",
                    "context": ["compose", "commandBox"],
                    "triggers": ["slash"]
                }
            ]
        }
    ]
}

Implementación del control de comandos de barra diagonal del agente

La configuración de comandos de barra diagonal del agente solo los expone a los usuarios del cliente de Teams, lo que no ayuda con su implementación.

Cuando un usuario activa un comando de barra diagonal del agente, Teams cambia el cuadro de redacción al modo de mensaje de destino e inserta el nombre del comando y, a continuación, devuelve el control al usuario para permitirle escribir más texto y enviar el mensaje. El controlador de mensajes del agente es responsable de usar el contenido del mensaje para determinar si se debe interpretar como una invocación de comandos y controlarlo correctamente.

Consulte Procedimientos recomendados e instrucciones de diseño para obtener otras instrucciones de control de mensajes.

Procedimientos recomendados e instrucciones de diseño

Ofrezca comandos de barra diagonal para las acciones comunes a las que los usuarios necesitan acceder de forma rápida y repetida. Son especialmente útiles para acciones que deben permanecer privadas o que proporcionan resultados específicos del usuario, como ver la configuración, crear tareas de seguimiento o comprobar el estado personal. Los comandos funcionan mejor para las acciones que es probable que los usuarios invoquen con frecuencia y se beneficien de ser fáciles de detectar y reutilizar.

Al igual que con toda la actividad basada en mensajes, el diseño de comportamientos de comandos de barra diagonal debe considerar cuidadosamente si el usuario espera un mensaje público o privado como respuesta en las conversaciones de grupo. Para obtener instrucciones generales sobre la visibilidad de la respuesta del agente, consulte Procedimientos recomendados de mensajería dirigida e Instrucciones de diseño.

Mantenga los comandos de barra diagonal cortos y orientados a la acción, y considere la posibilidad de agregar nombres cortos o alias para comandos populares. Considere la posibilidad de usar los inicios de aviso para solicitudes más largas.

Proporcione descripciones de comandos claras para mejorar la detectabilidad, incluidas las entradas esperadas más allá del nombre del comando.

Contenido relacionado

• Envío y recepción de mensajes de destino en conversaciones grupales
• Inicios de aviso
• Generar extensiones de mensaje