Lista de comprobación de procedimientos recomendados y características para agentes de Teams

En este artículo se proporciona una lista de procedimientos recomendados y características que los desarrolladores deben tener en cuenta al implementar agentes de Teams.

Estas prácticas y características representan las expectativas estándar del usuario para los agentes en Teams y son ampliamente aplicables. Los agentes que omitan cualquiera de ellos deben tener una razón sólida para hacerlo. Revise cada elemento para asegurarse de que su agente le proporcione una excelente experiencia en Teams.

Habilitar el acceso a todos los mensajes en las conversaciones

Los agentes modernos son más efectivos cuando pueden observar y procesar la conversación completa, en lugar de solo los mensajes que @mention ellos. Solicite los permisos adecuados de consentimiento específico del recurso (RSC) para habilitar este acceso y asegurarse de que los propietarios de la conversación den su consentimiento explícito.

Indicadores de flujo y pensamiento de mensajes

Al igual que muchas experiencias de chat de LLM, los agentes de Teams pueden transmitir mensajes en conversaciones individuales para maximizar la capacidad de respuesta. Antes de que empiece el streaming, Teams también puede mostrar un indicador de pensamiento actualizable y personalizable para indicar la vida y proporcionar información sobre cómo se genera el mensaje.

Mensajería dirigida

La mensajería dirigida permite a los agentes interactuar de forma privada con los usuarios en conversaciones grupales.

La capacidad de un agente para recibir mensajes dirigidos debe estar habilitada en su configuración de manifiesto de aplicación, pero debe considerarse una característica estándar de los agentes de Teams. Los usuarios esperarán que los agentes en conversaciones grupales usen mensajería dirigida para permitir acciones sensibles al contexto mientras mantienen la privacidad y las conversaciones enfocadas. Los agentes siempre deben considerar la visibilidad de los mensajes que reciben y usarla para informar la generación de respuestas, la visibilidad de respuestas y el comportamiento de seguimiento del contexto.

Reacciones emoji

Las reacciones son marcadores de emoji ligeros que todos los participantes en una conversación, incluidos los agentes, pueden adjuntar a los mensajes del chat. Los agentes pueden usar reacciones para comunicar reconocimiento o estado sin crear ruido adicional en una conversación.

Escritorio

Móvil

Inicios de consulta

Los iniciadores de mensajes son mensajes preescritos que ayudan a los usuarios a comprender las capacidades de un agente y a empezar a interactuar rápidamente con él. Los usuarios pueden acceder cómodamente a los iniciadores de mensajes y descubrirlos en todos los escenarios de chat. En los chats individuales, la aplicación muestra los iniciadores de mensajes de forma destacada antes de que se inicie la conversación para los agentes que no envían un mensaje de bienvenida.

Mensajes de bienvenida

Los agentes pueden enviar proactivamente mensajes de bienvenida cuando los usuarios los agregan a una conversación o instalarlos como una aplicación personal con capacidades de chat uno a uno. Los agentes deben usar los mensajes de bienvenida para explicar el valor que ofrecen, presentar instrucciones de configuración, ofrecer indicaciones de ejemplo y describir los comandos que exponen.

Los agentes distribuidos a través de la tienda de Teams y habilitados para el ámbito personal (conversaciones uno a uno) deben implementar mensajes de bienvenida, iniciadores de solicitudes o ambos.

Comandos de barra diagonal del agente

Los agentes que proporcionan funcionalidad de estilo de comando pueden hacer que sea detectable y fácilmente utilizable con comandos de barra diagonal de agente. Los usuarios pueden detectar e invocar los comandos de un agente a través del comando de barra diagonal de Teams y @mention los menús de autocompletar en el chat.

Acciones recomendadas

Las acciones sugeridas son botones en los mensajes del agente que permiten a los usuarios responder o tomar medidas rápidamente. A diferencia de los iniciadores de mensajes y los nombres de comandos, los agentes pueden generar y adjuntar acciones sugeridas dinámicamente con cada mensaje que envían, guiando a los usuarios a través de flujos de trabajo con opciones sensibles al contexto o sugiriendo de manera inteligente los próximos pasos.

Las acciones sugeridas son clave para permitir flujos de trabajo humanos en el bucle eficientes y satisfactorios, donde un agente solicita la aprobación o confirmación del usuario antes de realizar una acción, pero son útiles en cualquier escenario que se beneficie de una interacción rápida del usuario. Se pueden configurar para enviar una respuesta de chat estilo comando al agente, invocar silenciosamente un comportamiento de agente sin un mensaje de chat o insertar un mensaje prediseñado en el cuadro de redacción del usuario.

Etiquetas de contenido de IA

Usa siempre las etiquetas de contenido de IA de Teams según corresponda.

• La etiqueta generada por IA debe adjuntarse a todos los mensajes generados por IA y su uso es un requisito de directiva para los agentes distribuidos a través de la tienda de Teams
• Superficie de citas y orígenes de datos de vínculos usados para generar un mensaje
• Las etiquetas de confidencialidad indican claramente que los mensajes contienen información confidencial

Controles de comentarios de usuario

Los agentes pueden adjuntar controles de comentarios estandarizados a sus mensajes. Los usuarios pueden indicar que les gustan o no me gustan los mensajes y, opcionalmente, proporcionar comentarios detallados.

Escritorio

Móvil

Sesiones

La mayoría de los agentes deberían habilitar las sesiones para proporcionar a los usuarios una forma estructurada de organizar varias tareas o conversaciones. Las sesiones permiten a los usuarios y agentes crear conversaciones individuales independientes dentro del mismo chat, similar al modelo de conversación en los asistentes de IA modernos. Los contextos de conversación más cortos y enfocados también mejoran la calidad de las respuestas generadas por LLM. Para habilitar sesiones, establézcalo supportsSessionstrue en el manifiesto de la aplicación.