Compartir agentes con otros usuarios y creadores (GitHub Copilot)

Note

El entorno utilizado para construir este agente utiliza facturación basada en el uso. Usar, construir, probar y evaluar agentes pueden consumir créditos de Copilot. Más información en Resumen de la facturación basada en el uso.

Puedes compartir a tus agentes con otros en tu organización para que puedan verlos, probar y usar a tus agentes. Para cada agente, puede compartir con:

  • Usuarios individuales usando su correo electrónico o nombre de usuario
  • Todos los miembros de los grupos de seguridad que especifique
  • Toda la organización

Caution

Este artículo describe cómo compartir agentes que crees utilizando la experiencia de nuevo agente. Si usas la experiencia clásica del agente, consulta Compartir agentes con otros creadores. Cuando usas la nueva experiencia de compartir, solo puedes conceder derechos de visualización a los agentes que compartes. Para otorgar derechos de edición:

  1. Accede a los agentes de arnés estándar y flujos de agentes para habilitar la edición al compartir.
  2. Añadir usuarios al entorno del agente y luego asignar derechos de edición a los usuarios a través de los roles de seguridad del entorno. Aprende más en Control sobre cómo se comparten los agentes y Asigna roles de seguridad a los usuarios.

Prerequisites

  • La autenticación de usuario para el agente está configurada para Autenticar con Microsoft.
  • Los usuarios con los que compartes tienen una licencia de Microsoft Copilot Studio por usuario. Los usuarios que no tengan licencia pueden registrarse para una prueba.
  • Los agentes que quieres compartir se publican en Teams + Microsoft 365, con el agente Make disponible en Microsoft Copilot activado. Si tu agente no está publicado, se te pedirá que lo guardes y lo publiques antes de compartirlo.

Compartir un agente para visualización y pruebas

Note

  • Al compartir un agente para visualización y prueba, no puede compartirlo con grupos de Microsoft 365 con SecurityEnabled establecido en false. Para cambiar esta configuración, consulte Compartir una aplicación con grupos de Microsoft 365 en la documentación de Power Apps.

  • Cuando un agente compartido invoca un flujo de trabajo que utiliza un nodo agente para llamar a otro agente con la conexión del usuario, el usuario debe tener acceso al entorno del flujo de trabajo. Compartir el agente inicial no concede este acceso. Sin ella, la acción del nodo agente falla antes de llamar al segundo agente.

Importante

Compartir agentes de Copilot Studio que tienen conexiones a servicios externos como Azure Databricks Genie puede ser complicado porque las conexiones están ligadas a la identidad de cada usuario agente individual. Esto significa que un agente puede funcionar para ti, pero no para otros usuarios.

Para abordar este comportamiento, utiliza uno de los siguientes enfoques:

  • Utiliza un principio de servicio para la autenticación, si es compatible.
  • Configura las conexiones a nivel de entorno para que el agente se ejecute usando una identidad compartida y no específica de usuario.
  • Exigir a los usuarios que se autentiquen individualmente cuando se requiera autenticación basada en OAuth.

Para compartir un agente:

  1. Abra el agente desde la página de Agentes.
  2. Selecciona el icono de Compartir ( ) cerca de Publicar en la barra superior del menú.

    Note

    Si no ha publicado el agente, se le pedirá que lo haga antes de continuar.

  3. En el panel Compartir que se muestra, introduzca el nombre de usuario, las direcciones de correo electrónico de usuarios individuales o los grupos de seguridad con los que desea compartir el agente.
    • Los usuarios y grupos aparecen en el campo Personas que pueden usar el agente a medida que los seleccionas con el estado Pendiente.
  4. Selecciona Compartir para compartir el agente.

Los usuarios con acceso de visualización pueden ver el agente en su lista de agentes, abrirlo para ver detalles y probarlo, pero no pueden editar el agente ni su contenido.

Para permitir que otros editen el agente, puedes acceder a agentes y flujos de agentes estándar para habilitar la edición al compartir, o asignar roles de editor a los usuarios en el entorno.

Si solo quieres compartir el agente para que otras personas lo usen, sin verlo ni probar, en Organización, abre el menú desplegable y selecciona Acceso de usuario final. Esta acción permite que cualquiera de tu organización encuentre y use al agente, pero no pueden ver ni editar los datos del agente.

Cambie la opción a Sin permisos, a menos que se especifiquen para dejar de compartir el agente con todos en su organización. Los usuarios y los miembros de los grupos con los que compartió el agente seguirán teniendo acceso al agente.

Compartir un agente autónomo para que los usuarios lo ejecuten (vista previa)

Puedes compartir un agente publicado que tenga desencadenantes con usuarios que necesiten ejecutar el agente usando sus propias credenciales. Antes de compartir, configura los disparadores y herramientas del agente para la autenticación de usuarios. Los usuarios completan las conexiones requeridas en la página del agente compartido y solo pueden cambiar las opciones de activación que usted permita.

Note

El uso del agente autónomo de cada usuario final se suma y se factura a través del entorno subyacente donde se aloja el agente. Descubre más en Resumen de la facturación para agentes impulsados por el arnés GitHub Copilot.

  1. Abra el agente desde la página de Agentes.

  2. Selecciona el icono de Compartir ( ) cerca de Publicar en la barra superior del menú.

    Note

    Si no ha publicado el agente, se le pedirá que lo haga antes de continuar.

  3. En el panel Compartir que aparece, selecciona la barra de búsqueda. Introduce el nombre de usuario, las direcciones de correo electrónico de usuarios individuales o grupos de seguridad con los que quieres compartir el agente. Asegúrese de que Can use aparezca junto a la barra de búsqueda.

  4. Si ya compartiste el agente con los usuarios, cambia su permiso a Puede usar.

    Captura de pantalla del menú desplegable de permisos del panel de Compartir con Puede usar seleccionado y resaltado, junto con las opciones de Puede editar, Puede ver analíticas y Eliminar acceso.

  5. Selecciona Copiar el enlace para compartir y luego Copiar el enlace para configurarlo.

  6. Envía el enlace a los usuarios finales con los que compartiste el agente autónomo.

Los destinatarios pueden usar el enlace para activar al agente por sí mismos, conectarlo con sus propias credenciales y gestionar la configuración de disparadores permitidos. Aprende más en Configurar un agente autónomo compartido.

Limitations

Compartir agentes autónomos tiene las siguientes limitaciones:

  • Credenciales de flujo de trabajo como herramienta: Si tu agente llama a un flujo de trabajo como herramienta, ese flujo solo puede aceptar credenciales de usuario final para autenticación. No se soportan flujos de trabajo que usan credenciales exclusivas del maker para agentes autónomos.

  • Invocación de herramientas para usuarios: Los usuarios de un agente autónomo compartido no pueden especificar ni modificar parámetros de herramientas. Las llamadas a herramientas se invocan y ejecutan completamente con IA, según las especificaciones del creador.

  • Portal de gestión de agentes: Los usuarios finales deben guardar la URL de gestión de agentes en favoritos para comprobar la salud de su agente, arreglar el agente, dar su consentimiento para las actualizaciones del creador para el agente y otras tareas de gestión.

  • Visibilidad del uso compartido: Los usuarios no reciben notificación cuando un creador comparte un agente con ellos. Los fabricantes deben copiar y enviar el enlace para usar la lata a los usuarios finales.

Dejar de compartir un agente

Puede dejar de compartir un agente con usuarios individuales, un grupo de seguridad o con todos los miembros de su organización.

Para dejar de compartir un agente:

  1. Abra el agente desde la página de Agentes.

  2. Selecciona el icono de Compartir ( ) cerca de Publicar en la barra superior del menú.

  3. En el panel de Compartir , en Personas que puedan usar el agente, selecciona el icono de eliminar ("X") junto a cada grupo o usuario. Puedes deshacer el borrado si es necesario.

  4. Para dejar de compartir con todos en tu organización, en Toda la organización selecciona No permisos, salvo que se especifique. Los usuarios y miembros de grupos con los que compartiste el agente individualmente siguen teniendo acceso al agente.

  5. Selecciona Compartir para dejar de compartir con tu organización o con los usuarios o grupos eliminados.

Próximos pasos después de compartir un agente

Además de compartir tu agente, también puedes:

  • Se actualizó por última vez el