Desplegar agentes en Microsoft Teams

Microsoft Teams presenta desafíos de implementación únicos para los agentes de Copilot Studio debido a su entorno de conversación persistente. A diferencia de las implementaciones basadas en web en las que las sesiones se restablecen automáticamente, Teams mantiene los subprocesos de conversación indefinidamente, lo que puede provocar contexto obsoleto, expiración de tokens y contenido almacenado en caché obsoleto.

En este artículo se proporcionan instrucciones para implementar agentes de Copilot Studio en Teams de forma eficaz. Aprenderá a administrar sesiones persistentes, a implementar estrategias de depuración y a garantizar un rendimiento confiable en los ciclos de vida de conversación extendidos.

Consideraciones clave cubiertas:

• Administración del ciclo de vida de la sesión y control de inactividad
• Técnicas de depuración para conversaciones persistentes
• Estrategias de implementación de control de versiones y actualización
• Patrones de implementación específicos de Teams

Siga estos procedimientos para crear agentes sólidos que se realicen de forma coherente en el entorno de Teams, a la vez que se proporcionan comentarios claros a los usuarios sobre los cambios de estado y el comportamiento del sistema.

¿Por qué la implementación de Teams es diferente?

Las conversaciones en Teams persisten durante varios días sin restablecimiento automático. A diferencia de Chat en web sesiones, el evento ConversationStart se activa solo la primera vez que se agrega un agente. La reinstalación de la aplicación no vuelve a activar este evento.

La persistencia de Teams crea varios riesgos:

• Contexto obsoleto: el historial de conversaciones permanece a menos que se borre.
• Expiración del token: los conectores pueden expirar durante sesiones largas.
• Límites de contexto: los mensajes acumulados pueden superar los límites del modelo.
• Caché de actualizaciones: Los usuarios pueden seguir interactuando con una lógica obsoleta.

La administración proactiva del estado y las instrucciones claras del usuario son esenciales.

Administración del ciclo de vida de la sesión

Administre el ciclo de vida de la sesión con la gestión de la inactividad.

Implementación de restablecimientos de inactividad

Cree un nuevo tema y seleccione el desencadenante "El usuario está inactivo durante un tiempo" para iniciar un flujo de restablecimiento después de un período de inactividad del usuario.

1. Agregue el desencadenador de inactividad y establezca un tiempo de espera (por ejemplo, 15 minutos).
2. Agregue uno o más nodos de Clear variable values para eliminar las variables de sesión y el historial de conversaciones y así evitar el desbordamiento de contexto.
3. Finalice la conversación y marque la sesión como resuelta.

Este enfoque evita el desbordamiento del contexto y garantiza un comportamiento predecible cuando un usuario vuelve.

Proporcionar instrucciones después del restablecimiento

Después de borrar el estado, envíe un mensaje que explique lo que ha ocurrido. Por ejemplo: "Parece que nuestra conversación se ha quedado inactiva, así que voy a borrar el contexto anterior por seguridad. Diga "hello" para reiniciar".

Dado que solo se activa una vez, la primera vez que se agrega un agente, el tema Greeting se convierte en el punto de inicialización efectivo. Pedir al usuario que diga "hello" garantiza que la lógica de inicio se ejecute correctamente.

Ofrecer un comando de autoservicio de restablecimiento

Agregue mensajería que informe a los usuarios de que pueden escribir un comando específico: "Si algo parece incorrecto, intente escribir para actualizar mi estado".

Este comando fuerza un restablecimiento completo de la conversación.

• Borra el estado de la conversación
• Quita la información del conector almacenado en caché.
• Volver a autenticar conectores
• Carga la versión más reciente del agente

Use este comando cuando:

• El bot parece "bloqueado" con información obsoleta
• La autenticación del conector ha expirado
• Después de actualizar la lógica del bot
• Cuando el comportamiento parece incoherente

Aumento de la transparencia y mejora de la depuración

Para aumentar la transparencia y mejorar la depuración de los agentes implementados en Teams, use el desencadenador.

Uso de OnKnowledgeRequested para mostrar consultas reescritas

Copilot Studio vuelve a escribir preguntas de usuario antes de realizar la recuperación. Si habilita el desencadenador, puede hacer lo siguiente:

• Diagnóstico de errores de coincidencia de intenciones
• Descripción de cómo se reescribirán las consultas
• Aumento de la confianza del usuario durante la depuración

Agregue un mensaje que muestre las consultas semánticas y de palabra clave generadas. Por ejemplo:

kind: AdaptiveDialog
beginDialog:
  kind: OnKnowledgeRequested
  id: main
  actions:
    - kind: SendActivity
      id: sendActivity_debug
      activity: |-    
        **Debug**: sending this lexical query "{System.KnowledgeSearchQuery}"
        **Debug**: sending this semantic query "{System.SearchQuery}"
inputType: {}
outputType: {}

Esta consulta proporciona acceso de solo lectura a la consulta de búsqueda refinada (reescritura de la consulta) que generó el orquestador a partir de la pregunta del usuario.

Ventajas:

• Ayuda a identificar discrepancias en la intención.
• Muestra a los usuarios lo que busca el agente.
• Crea confianza en las acciones del agente.
• Ayuda a los creadores durante las pruebas.

Control de versiones y confiabilidad de actualizaciones

Administrar las versiones del agente y garantizar que los usuarios interactúen con la lógica más reciente es especialmente importante en un entorno persistente, como Teams.

Muestra la versión del bot en mensaje de bienvenida o en un tema específico

Incluya un identificador de versión mediante el tema Greeting o un tema de versión dedicada:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Actualice este valor con cada publicación para ayudar a los usuarios y a los equipos de soporte técnico a comprobar qué compilación está activa. La actualización de los metadatos de versión también actualiza el contenido almacenado en caché. Cambiar el nombre o la descripción del agente solicita a Teams que lo cargue como una nueva actualización.

Habilitar "Forzar la versión más reciente" al publicar

La configuración Forzar versión más reciente garantiza que Teams cargue la lógica del agente más reciente la próxima vez que el usuario envíe un mensaje. Esta configuración también ayuda a invalidar las versiones almacenadas en caché. Sin embargo, forzar una actualización interrumpe cualquier conversación en curso.

Captura de pantalla del cuadro de diálogo de publicación del agente con advertencias sobre las credenciales, el modelo de versión preliminar y Forzar la versión más reciente habilitada.

Consideraciones de implementación específicas de Teams

Teams tiene comportamientos únicos que requieren atención especial.

Trata el saludo como parte de la lógica de inicialización.

Puesto que solo se activa una vez, la primera vez que se agrega un agente:

• Coloque la lógica de inicialización en Greeting.
• Agregue instrucciones claras en la descripción de la aplicación teams.
• Recuerde a los usuarios: "Después de un tiempo de espera, escriba "hello" para iniciar una nueva conversación".

Optimizar desencadenadores y alternativas

Los usuarios de Teams interactúan de forma natural e imprevisible. Asegúrese de que el bot:

• Controla varias variaciones de saludo.
• Incluye gestión de despedida.
• Proporciona varias expresiones de ejemplo.
• Ofrece respuestas alternativas amigables y útiles.
• Usa palabras clave para guiar a los usuarios a temas relevantes.
• Usa para ayudar a diagnosticar intenciones perdidas.
• Redirige a temas relevantes basados en palabras clave.
• Pide a los usuarios que reformulen si el bot está realmente bloqueado.

Validación del comportamiento de la autenticación del conector

Al usar conectores (ServiceNow, Outlook y otros), pruebe:

• Comportamiento de la tarjeta de inicio de sesión inicial.
• Qué ocurre cuando expira el token y cómo se renueva automáticamente.
• Funcionamiento de los flujos de invalidación y nuevo consentimiento forzados.

Prueba en condiciones reales

Dado que Teams conserva el estado entre sesiones, las pruebas deben reflejar la experiencia real del usuario:

1. Implemente con Mostrar solo para mí.
2. Probar escenarios prolongados (revisar después de algunas horas).
3. Publique actualizaciones y confirme que el agente cambia de versión.
4. Valide la representación de tarjetas adaptables en el escritorio y en los dispositivos móviles.
5. Probar acciones en contextos conversacionales variados.

Lista de comprobación de la implementación

Conclusiones clave

• Administre el ciclo de vida de la sesión mediante la configuración de desencadenadores de inactividad y el uso de opciones de borrado de estado cuando corresponda.
• Aumente la transparencia al mostrar la actividad del sistema mediante la reescritura de consultas y mensajes relacionados con el estado.
• Tenga en cuenta los comportamientos específicos de Teams, como controlar saludos manuales y administrar la memoria persistente.
• Mantenga la confiabilidad del agente mediante la implementación de prácticas de control de versiones y la aplicación de actualizaciones cuando sea necesario.
• Admita la autonomía del usuario proporcionando comandos de solución de problemas de autoservicio y opciones de recuperación guiadas.

Información relacionada

• Connect y configure un agente para Teams y Microsoft 365
• Conceptos clave: Publicar e implementar su agente