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

Después de publicar el agente, haga que esté disponible para los usuarios de 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.

Usted puede:

• Personalice la apariencia del agente en Teams y Microsoft 365 Copilot.
• Instale el agente usted 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.
• Agregar el agente a un canal de equipo.
• Descargar el manifiesto de la aplicaciones para su agente para distribuirlo en su inquilino 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.

Requisitos previos

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

• Los creadores 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 el agente al menos una vez, puede conectarlo a los canales 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.

   Nota

   Si no selecciona Hacer que el agente esté disponible en Microsoft 365 Copilot, el agente solo está 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
   • Condiciones 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 hacer una pregunta al nuevo agente en Microsoft 365 Copilot, escriba @, seleccione el agente en la lista que aparece, escriba la pregunta y seleccione 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 tienda de Teams o en la tienda de agentes de Microsoft 365

Una vez que publique el agente, puede mostrarlo en la tienda de aplicaciones de Teams o en el almacén del agente de Microsoft 365 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.

   

Quitar un agente de la sección Generado por Power Platform

Puede quitar un agente de la sección Generado por 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. Seleccione Mostrar a mis compañeros de equipo y usuarios compartidos y borre la casilla Mostrar en Generado por sus compañeros.

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 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 publica su agente en Microsoft 365, enviarlo para la aprobación del administrador incluye también el proceso de Microsoft 365 Agent Store. Destacar tu aplicación en la tienda de aplicaciones de Teams y en la tienda de agentes de Microsoft 365 es una excelente manera de distribuir ampliamente tu agente colaborando con tu administrador para desplegarlo 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:

• El agente está listo para su lanzamiento y que cumple los estándares, reglas y directivas de la empresa.
• Te coordinas con otros gerentes de agente. Una vez envía un agente, no puede reenviarse por un usuario distinto hasta que un administrador apruebe o rechace el envío anterior.
• Elimine el agente, si corresponde, en la sección Generado por 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.

Enviar un agente para la aprobación de 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.

   Nota

   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 enviará a su administrador para su aprobación, y verá una nota que indica el estado de su envío.

   Nota

   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.

   Al establecer el acceso para menos usuarios que todos, los usuarios de la organización no pueden chatear con el agente después de instalarlo desde la tienda de aplicaciones de Teams o desde 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 un agente está disponible para un equipo, los miembros del equipo pueden "@mencionar" el copiloto en cualquier canal del equipo y todos los compañeros de equipo verán la respuesta 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:

• Agregar el agente a un canal de equipo
• Agregar el agente a chats de grupos y 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 Teams de un agente (avanzado)

Puede descargar el manifiesto de la aplicación Teams del agente para realizar cambios detallados en el manifiesto directamente y compartirlo con su administrador o usuarios en el inquilino. 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 tu 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 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 de autoría unificado mejorado no admiten la configuración de saludo privada.

• 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. Según las necesidades de su negocio, es posible que desee mantener el contenido de su agente conciso para los agentes que publique 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.

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.

Solución alternativa

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

1. En el centro de administración de Microsoft Teams, busque la aplicación del agente, deshabilite, espere unos segundos y vuelva a habilitarla.
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, póngase en contacto con Microsoft Support y proporcione el identificador de Conversation, Agent ID y el time cuando se produjo 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 hacer 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
  • Adaptive Cards 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)

  Nota

  Puede usar Adaptive Cards 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