Conexión y configuración de un agente para Teams y Microsoft 365

Después de publicar tu agente, ponlo a disposición de los usuarios en Teams y Microsoft 365. De esta manera, usted, sus compañeros de equipo y su organización en general podrán interactuar con él. Debe publicar el agente al menos una vez antes de que los usuarios puedan interactuar con el agente en Teams y Microsoft 365.

Ustedes pueden:

• Personaliza la apariencia de tu agente en Teams y Microsoft 365 Copilot.
• Instala el agente por ti mismo en Teams y Microsoft 365 Copilot.
• Comparte el enlace de instalación del agente con otros usuarios.
• Mostrar el agente en la tienda de aplicaciones de Teams.
  • Muestre el agente a usuarios compartidos agregándolo a la sección Generado por Power Platform de la tienda de aplicaciones de Teams.
  • Comparta el agente con la organización enviando el agente para aprobación del administrador para que aparezca en la sección Creado por su organización de la tienda de aplicaciones de Teams.
• Añadir el agente a un canal del equipo.
• Descargar el manifiesto de la aplicación de su agente para distribuirlo dentro de su entorno de Teams.

Cuando agregue un agente a Teams, algunos de sus datos, como el contenido del agente y el contenido del chat del usuario, se compartirán con Teams. Sus datos podrían fluir fuera del cumplimiento y límites geográficos o regionales de su organización. Para más información, vea Comprender los permisos y la información a la que acceden las aplicaciones de Teams.

Prerequisites

• Todos los usuarios del agente de su organización pueden usar Microsoft 365 Copilot.

• Los desarrolladores de agentes tienen permisos para crear y acceder a un entorno de Copilot Studio.

• Compartir el agente con otros usuarios para que puedan instalar y chatear con el agente en Teams y Microsoft 365 Copilot.

• Tu organización debe permitir que las aplicaciones de Power Platform se añadan a Teams antes de que tú u otros usuarios puedan:

  • Instalar directamente un agente en Teams, o
  • Encuentra un agente en la sección Construido con Power Platform en la tienda de aplicaciones de Teams.

  Trabaje con su administrador para poder Administrar aplicaciones Microsoft Power Platform en el Centro de administración de Microsoft Teams si está deshabilitada para su organización.

• Los administradores gestionan agentes que aparecen en la sección Construido para tu organización (aprobados por un administrador) por separado en la página de Gestionar aplicaciones del centro de administración de Teams.

• Antes de instalar un agente para ti mismo o compartirlo con otros, publícalo al menos una vez.

Conexión de un agente a los canales de Teams y Microsoft 365 Copilot

Después de publicar tu agente al menos una vez, puedes conectarlo a los canales de Teams y Microsoft 365 Copilot para que los usuarios puedan chatear con él tanto en Teams como en Microsoft 365 Copilot.

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Si quiere que el agente esté disponible en ambos, Microsoft 365 Copilot y Teams, en Activar Microsoft 365, asegúrese de que está seleccionada la opción de Hacer que el agente esté disponible en Microsoft 365 Copilot.

   Note

   Si no selecciona Hacer que el agente esté disponible en Microsoft 365 Copilot, el agente solo estará disponible en Teams.

3. Seleccione Agregar canal.

   

Personalizar la apariencia de un agente para Teams y Microsoft 365 Copilot

Antes de poner un agente a disposición de otros usuarios, proporciona la descripción y apariencia adecuadas. Esta información ayuda a los usuarios a comprender el propósito y la imagen de marca del agente.

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Editar detalles para cambiar el icono, el color y las descripciones del agente. Estos atributos son visibles en la tienda de aplicaciones de Teams y en la pestaña Acerca de de la aplicación después de que el usuario instale el agente. Revise las directrices de formato de iconos de aplicaciones para Teams.

   Importante

   Los usuarios que ya instalaron el agente desde un enlace compartido o desde la sección Built with Power Platform de la tienda de aplicaciones de Teams no ven cambios en los datos de un agente. Los usuarios deben reinstalar el agente para recibir las actualizaciones.

   Para los agentes ya aprobados por un administrador, debes enviar al agente de nuevo para su aprobación.

3. Seleccione Más para agregar la información siguiente:

   • Nombre del desarrollador
   • Sitio web
   • Declaración de privacidad
   • Términos de uso

   Proporciona esta información para informar a los usuarios sobre tu agente. Para obtener más información, consulte Crear una declaración de privacidad y términos de uso en Microsoft Teams.

4. Haga clic en Guardar. Sus cambios en el color, el icono y la breve descripción ahora son visibles en el panel de configuración.

Instalación de un agente en Teams y Microsoft 365 Copilot

Después de publicar tu agente, puedes agregarlo a tu perfil de Teams directamente desde Copilot Studio.

Añade primero a tu agente a tu propio perfil en Teams, antes de compartirlo con otros.

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Ver agente en Teams.

   Si configuró el agente para que esté disponible en Microsoft 365 Copilot cuando agregó por primera vez el canal, al seleccionar Ver agente en Teams se instalará el agente tanto en Teams como en Microsoft 365 Copilot. Si no configuraste tu agente para Microsoft 365 Copilot, tu agente solo instala en Teams.

3. Selecciona Agregar.

   

   El agente aparece en la lista de agentes de la izquierda.

4. Para hacerle una pregunta a tu nuevo agente en Microsoft 365 Copilot, introduce @, selecciona a tu agente en la lista que aparece, introduce tu pregunta y selecciona Enter.

Compartir un vínculo para que otros puedan instalar un agente

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Opciones de disponibilidad.

3. Seleccione Copiar vínculo.

4. Comparta el vínculo con los usuarios para que puedan instalar el agente en Teams.

Mostrar un agente en la App Store de Teams o en la Microsoft 365 Agent Store

Una vez que publiques tu agente, puedes mostrarlo en la App Store de Teams o en la Microsoft 365 Agent Store para que los usuarios puedan encontrarlo e instalarlo.

Mostrar a usuarios compartidos en Teams

Puede compartir su agente añadiéndolo a la sección Generado por Power Platform de la tienda de aplicaciones de Teams. Solamente los usuarios compartidos pueden encontrar el agente allí.

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Opciones de disponibilidad.

3. Seleccione Mostrar a mis compañeros de equipo y usuarios compartidos y revise quién tiene acceso al agente.

4. Confirma que la casilla de Mostrar en Construido por tus compañeros está seleccionada y selecciona Actualizar.

   El agente estará disponible en la sección Generado por Power Platform de la tienda de aplicaciones de Teams y aparecerá una etiqueta verde Agregado a Teams en la página de opciones de disponibilidad.

   

Eliminar un agente de la sección Creado con Power Platform

Puede eliminar un agente de la sección Creado con Power Platform. Eliminar el agente de esta sección no afecta a los usuarios que lo tienen instalado.

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Opciones de disponibilidad.

3. Selecciona Mostrar a mis compañeros y usuarios compartidos y desmarca la casilla Mostrar en Desarrollado por tus colegas.

4. Seleccione Compartir. El agente ya no aparece en la sección Creado con Power Platform de la tienda de aplicaciones de Teams.

Mostrar a toda la organización

Puede compartir un agente con la organización enviándolo para que el administrador lo apruebe para que aparezca en la sección Generado para su organización de la tienda de aplicaciones de Teams. Si también publicas tu agente en Microsoft 365, enviarlo para la aprobación del administrador se aplica igualmente a Microsoft 365 Agent Store. Incluir tu app en la tienda de aplicaciones de Teams y en la Microsoft 365 Agent Store es una excelente forma de distribuir ampliamente tu agente al asociarte con tu administrador para desplegarla a todos en la organización o a un subconjunto de usuarios.

Los administradores también pueden usar directivas de configuración de aplicaciones para instalar y anclar automáticamente un agente para los usuarios de la organización, de modo que puedan acceder a él directamente desde la barra de aplicaciones en Teams.

Antes de enviar un agente a su organización, asegúrese de que:

• Su agente está listo para su lanzamiento y cumple con las normas, reglas y políticas de la empresa.
• Coordina con otros responsables de agentes. Una vez enviado un agente, otro usuario no puede volver a enviarlo hasta que un administrador apruebe o rechace el envío anterior.
• Elimine el agente, si procede, de la sección Creado con Power Platform de la tienda de aplicaciones de Teams. De lo contrario, si envía su agente para la aprobación del administrador, podría terminar apareciendo en dos lugares.

Presenta un agente para la aprobación del administrador

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Opciones de disponibilidad.

3. Confirme que el agente no se muestra a compañeros de equipo ni a usuarios compartidos. Quítelo si dice Agregado a Teams.

4. Seleccione Mostrar a todas las personas de mi organización.

5. Revise los requisitos para el envío y seleccione Enviar para aprobación del administrador.

   Note

   Asegúrese de revisar el contenido y de que esté listo para que lo revise un administrador. Deberá enviar una solicitud de aprobación nueva para actualizar el icono y las descripciones de los agentes que se han aprobado anteriormente.

   Una vez aprobado un agente, todos los usuarios nuevos y existentes del agente en Teams y en Microsoft 365 Copilot reciben la actualización.

   Solo se requiere una nueva aprobación si modifica los detalles del agente. Puede realizar actualizaciones de contenido para su agente y publicarlas con la frecuencia que desee. No es necesario que vuelva a enviar su agente para su aprobación después de publicar dichos cambios de contenido.

   Aparecerá un mensaje de confirmación final.

6. Seleccione Sí para continuar. El agente se envía a tu administrador para su aprobación, y puedes ver un aviso que indica el estado de tu solicitud.

   Note

   Después de enviar al agente para la aprobación del administrador, no cambies la configuración de acceso del agente para que sea inferior a la de todos en tu organización.

   Configurar el acceso para menos de todos los usuarios provoca que los miembros de la organización no puedan chatear con el agente después de instalarlo desde la tienda de aplicaciones de Teams o la tienda de agentes de Microsoft 365.

   Trabaje con el administrador en la directiva de aplicación Microsoft Teams para determinar quién puede encontrar e instalar el agente.

7. Espere la aprobación de su administrador. Puede comprobar el estado más reciente seleccionando Actualizar o abriendo la ventana Poner el agente a disposición de otros usuarios en la página Publicar.

8. Después de que su administrador apruebe el agente, el estado se actualiza a Aprobado. Puede abrir directamente el agente y compartir el enlace de la versión aprobada con otros usuarios.

9. Opcionalmente, pídale a su administrador que use directivas de configuración de aplicaciones para instalar y anclar automáticamente un agente para que los usuarios de la organización puedan acceder a él directamente desde la barra de aplicaciones en Teams.

Permitir que los usuarios agreguen un agente a un equipo en Teams

En Teams, los usuarios pueden agregar un agente a un equipo específico. Una vez que un agente esté disponible para un equipo, los miembros del equipo pueden mencionarlo con @ en cualquiera de los canales del equipo, y todos los compañeros del equipo verán las respuestas del agente. Esta característica es útil para situaciones como las siguientes:

• La colaboración de su agente puede resultar útil, por ejemplo, para compartir la información más reciente del informe de ventas con el resto del equipo de ventas.
• Desea permitir que todos los miembros del equipo interactúen con el agente en un canal de equipo o a través de un chat privado sin necesidad de instalar manualmente el agente.

Dos opciones determinan si los usuarios pueden agregar un agente a cualquier equipo del que formen parte o a chats grupales y de reuniones en Teams. Cuando seleccionas estas opciones, el agente accede al historial de conversaciones desde el canal del equipo, el chat grupal o el chat de reuniones, lo que ayuda al agente a proporcionar respuestas más adecuadas al contexto de la conversación.

Cuando los usuarios instalan un agente desde la tienda de aplicaciones de Teams o mediante el vínculo de instalación, pueden ver uno de las siguientes opciones, según el alcance de colaboración que haya establecido para el agente:

• Añadir el agente a un canal de un equipo
• Agregar el agente a los chats grupales y de reuniones en Teams

Los miembros del equipo también pueden quitar un agente de un equipo.

Para permitir que los usuarios agreguen un agente a un equipo:

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Editar detalles.

3. Seleccione Permitir que los usuarios agreguen este agente a un equipo.

4. Haga clic en Guardar.

Teams almacena información en caché, por lo que podría pasar un tiempo antes de que los usuarios vean la opción de agregar el agente a un equipo o un chat de grupo. Los usuarios pueden actualizar el navegador (o cerrar e iniciar sesión de nuevo en el cliente de escritorio de Teams) para ver los últimos cambios.

Si anteriormente envió el agente para la aprobación del administrador, deberá volver a enviarlo después de habilitar esta opción. El administrador debe aprobar estos cambios antes de que los usuarios puedan agregar el agente a sus equipos desde la tienda de aplicaciones de Teams en la sección Creado para su organización.

Impedir que los usuarios agreguen un agente a un equipo, chat de grupo y de reunión

Cuando desactivas esta opción, los usuarios no pueden añadir un agente a un nuevo equipo, grupo o chat de reunión. No elimina el agente para los usuarios que ya lo tienen. Debe eliminar manualmente el agente.

Para evitar que los usuarios agreguen un agente a un equipo:

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Editar detalles.

3. Desmarque la casilla Usuarios pueden agregar este agente a un equipo.

4. Haga clic en Guardar.

Configurar el comportamiento de saludo privado

Los saludos privados de un agente son útiles cuando quieres que los miembros del equipo mantengan conversaciones individuales con el agente sin necesidad de instalar manualmente al agente.

Cuando configuras este comportamiento, tu agente inicia automáticamente una conversación con los miembros del equipo. Para personalizar el mensaje de saludo del agente, modifique el tema del sistema de saludo.

Considere cuán relevante es el agente para los miembros del equipo. Asegúrate de que el saludo del agente les ayude a entender qué hacer con él, describe sus limitaciones y, lo más importante, les hace sentir cómodos interactuando con él.

Para configurar cuándo un agente envía un saludo privado:

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Haga clic en Configuración.

3. Configure las opciones de saludo privado.

4. Haga clic en Guardar.

Descargar el manifiesto de la aplicación de Teams para un agente (avanzado)

Puede descargar el manifiesto de la aplicación de Teams del agente para modificar directamente el manifiesto en detalle y compartirlo con su administrador o con otros usuarios del tenant. También puede cargar directamente el manifiesto de la aplicación en Teams si la directiva de su organización le permite cargar aplicaciones personalizadas.

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Opciones de disponibilidad.

3. Seleccione Descargar .zip. El manifiesto se genera como un archivo .zip y se guarda según la configuración de tu navegador.

4. En Teams, seleccione Apps>Administrar las aplicaciones>Cargar una aplicación.

5. Seleccione Cargar una aplicación personalizada.

6. Busque el archivo .zip descargado.

Desconectar un agente de Teams

Puedes desconectar a tu agente para que los usuarios ya no puedan chatear con él en Teams. Cuando su agente está fuera de línea, no responde a nadie que intente chatear con él. Considera la necesidad de desconectar a tu agente antes de hacerlo.

Los agentes desconectados no aparecen en la sección Generado por Power Platform de la tienda de aplicaciones de Teams y no se pueden instalar desde un vínculo compartido. Si un usuario ya tiene un agente de este tipo instalado en Teams, permanece disponible hasta que el usuario lo desinstala.

Si desconectas un agente que un administrador aprobó, sigue apareciendo en la sección Construido para tu organización de la tienda de aplicaciones de Teams. Debe pedirle a su administrador que lo elimine.

1. Abrir el panel de configuración de los canales de Teams y Microsoft 365 Copilot.

2. Seleccione Quitar canal.

3. Revise la información sobre la desconexión de su agente y seleccione Desconectar para continuar.

Para volver a conectar el agente, seleccione Add channel en el panel de configuración de los canales de Teams y Microsoft 365 Copilot, vuelva a publicar y vuelva a instalar el agente en Teams.

Abra el panel de configuración para los canales de Teams y Microsoft 365 Copilot

1. Abrir su agente en Copilot Studio.

2. En la barra de menú superior, seleccione Canales.

3. Seleccione el icono de Teams y Microsoft 365 Copilot. Aparecerá el panel de configuración.

Limitaciones conocidas

Las limitaciones conocidas difieren en función de si usa Teams o Microsoft 365 Copilot.

Limitaciones conocidas en Teams

• Los agentes que usan el lienzo unificado mejorado no admiten la configuración de saludo privado.

• Los agentes aprobados por un administrador no tienen la opción de configurar el icono del avatar en la página de detalles. Estos agentes usan el icono de la app como su avatar.

• Teams aplica limitación de velocidad a los agentes. Dependiendo de las necesidades de tu negocio, quizá quieras mantener el contenido de tus agentes conciso para los agentes que publiques en Teams.

• Si tu agente soporta autenticación de usuario, el usuario no puede cerrar sesión explícitamente. Este comportamiento no cumple con la certificación del Marketplace de Teams si publicas a tu agente en el Panel de Vendedores. Esta limitación no se aplica al uso personal o del inquilino del agente. Aprende cómo publicar tu aplicación en la Tienda de Teams y sobre la política de certificación del Marketplace.

• Después de desconectar tu agente del canal de Teams, puede que pasen unos minutos antes de que los usuarios en Teams no puedan contactar con él.

• En los chats y canales de grupo de Teams, los agentes de Copilot Studio no pueden usar orígenes de conocimiento que requieran autenticación de usuario final, como SharePoint. Esta limitación es por diseño y ayuda a evitar la exposición de datos no deseada. Estos agentes solo se admiten en chats 1:1.

• Los chats de grupo y los chats de reuniones no admiten agentes configurados para la autenticación manual con inicio de sesión único (SSO) para Teams. Dependiendo de las necesidades de su negocio, puede: autenticarse con Microsoft o eliminar SSO para Teams de su autenticación manual.

Las citas no se representan para respuestas personalizadas

Cuando un agente usa un nodo de respuestas generativas con una respuesta personalizada, las citas de la respuesta no se representan en Teams. A diferencia de las respuestas generativas estándar (no personalizadas), Teams no agrega automáticamente citas a respuestas personalizadas.

Para representar citas a partir de una respuesta generativa personalizada en Teams:

1. En el panel Crear propiedades de respuestas generativas , expanda la sección Opciones avanzadas y establezca Guardar respuesta LLM en Completado (recomendado) . Esta configuración captura la respuesta completa, incluidos los metadatos de cita.

2. En el editor de código del tema, agregue un nodo SendActivity después del nodo de respuestas generativas. Incluya los atributos citationEntities y text bajo activity, que apunten a las variables que contienen las citas y el texto de respuesta.

   - kind: SearchAndSummarizeContent
     id: search-content
     latencyMessageSettings:
       allowLatencyMessage: false
     autoSend: false
     variable: Topic.Answer
     userInput: =System.Activity.Text
     responseCaptureType: FullResponse
   
   - kind: SendActivity
     id: sendActivity_SnMFMq
     activity:
       text:
         - "{Topic.Answer.Text.Content}"
       citationEntities: =Topic.Answer.Text.CitationSources
   

Para obtener más información sobre cómo editar temas con el editor de código, obtenga más información en Editar temas con el editor de código.

SystemError tras publicar o volver a publicar un agente

Cuando los usuarios interactúan con un agente de Copilot en Teams, es posible que vean el siguiente mensaje:

Perdona, ha pasado algo inesperado. Lo estamos investigando.
Código de error: SystemError

Este problema ocurre cuando Teams sigue usando una versión previamente publicada del agente después de que lo publiques o vuelvas a publicar. En algunos casos, Teams no actualiza inmediatamente la configuración actualizada del agente. Este problema provoca un SystemError genérico durante la ejecución del agente.

Workaround

Para actualizar la configuración del agente, prueba los siguientes pasos:

1. En el centro de administración de Microsoft Teams, localiza la app del agente, desháctala, espera unos segundos y luego vuelve a activarla.
2. En Copilot Studio, desactive el canal Teams para el agente, guarde los cambios y vuelva a activar el canal.
3. Vuelve a publicar el agente para asegurarte de que la última versión esté disponible para Teams.

Si el problema persiste, contacte con el Soporte de Microsoft y proporcione el ID de conversación, el ID del agente y la hora en que ocurrió el error.

Limitaciones conocidas de Microsoft 365 Copilot

• Tema de inicio de conversación no compatible: el canal de Microsoft 365 Copilot no admite el tema Conversation Start, por lo que no es posible realizar saludos generales. En su lugar, el agente ofrece indicaciones sugeridas. Puedes establecer variables a través de temas activados por eventos de actividad, pero este método no es ideal para saludos debido a los efectos secundarios.

• Tipos de medios no soportados: No se renderizan medios como imágenes GIF.

• Direcciones URL incrustadas: Microsoft 365 Copilot podría quitar las direcciones URL incrustadas para la seguridad. Las citas de respuestas generativas deben incluir direcciones URL en la sección de citas.

• Tipos de nodo no admitidos:

  • Operaciones de voz
  • Entrega al representante del servicio de atención al cliente
  • Tarjetas adaptables con Action.Execute

• Tipos de mensajes no admitidos:

  • Tarjetas básicas (error de ContentFiltered)
  • Vídeo (error de ContentFiltered)
  • Imagen (error de ContentFiltered)
  • Archivo
  • Voz (no enviada)

  Note

  Puede usar tarjetas adaptables para mostrar imágenes.

• El desencadenador de inactividad se activa, pero no envía mensajes de vuelta a Microsoft 365 Copilot.

• Los agentes publicados en Microsoft 365 Copilot no admiten comentarios de los usuarios (reacciones).

Información relacionada

• Desplegar agentes en Microsoft Teams