Publicar agentes en Microsoft 365 Copilot y Microsoft Teams en el portal de Foundry

Después de crear y probar un agente, a menudo querrá compartirlo con otras personas en los entornos donde ya trabajan. Al publicar un agente de Microsoft Foundry en Microsoft 365 Copilot y Teams, usted y otros usuarios pueden interactuar con el agente y detectarlo a través de la interfaz de usuario de Microsoft 365 Copilot y Teams. Publique el punto de conexión estable del agente, por lo que los usuarios finales siempre interactúan con un agente coherente mientras implementa sin problemas nuevas versiones de agente que reciben tráfico a través del punto de conexión.

En este artículo se explica cómo publicar agentes desde el portal de Foundry.

Requisitos previos

• Acceso al portal de Microsoft Foundry.

• Un proyecto de Foundry con una versión del agente que ha probado y desea publicar.

• Las siguientes asignaciones de roles:

  • Permiso para crear un recurso de Azure Bot Service (Microsoft.BotService/botServices/write) y configurar sus canales (Microsoft.BotService/botServices/channels/write) en el grupo de recursos donde se publica. El rol de colaborador de Azure Bot Service concede exactamente estos permisos. Los roles de colaborador o propietario más amplios también funcionan. Los roles de Foundry no conceden estos permisos. Para obtener más información, consulte configuración de Azure Bot Service.

  • Rol de usuario de Foundry en el ámbito del proyecto de Foundry para crear, administrar y publicar agentes.

    Importante

    Recientemente se cambió el nombre de los roles RBAC de Foundry. Foundry User, Foundry Owner, Foundry Account Owner y Foundry Project Manager se llamaban anteriormente Usuario de Azure AI, Propietario de Azure AI, Propietario de la cuenta de Azure AI y Administrador de proyectos de Azure AI. Es posible que siga viendo los nombres anteriores en algunos lugares mientras se implementa el cambio de nombre. El cambio de nombre no modifica los identificadores de rol y los permisos principales.

  • Para obtener más información, consulte Control de acceso basado en rol en el portal de Foundry.

• Prueba tu agente exhaustivamente en el portal Foundry antes de publicarlo. Confirme que responde correctamente y las herramientas funcionan según lo previsto.

• Seleccione la versión del agente activo con la que desea que los consumidores interactúen en Microsoft 365 y Teams.

• Compruebe que los proveedores de recursos de Azure necesarios están registrados en la suscripción. El proceso de publicación crea un recurso de Azure Bot Service, que requiere el proveedor Microsoft.BotService.

  Si usa la CLI de Azure, puede registrar el proveedor con:

  az provider register --namespace Microsoft.BotService
  

Selección de una versión del agente activo

La versión activa es la versión que el endpoint estable de tu agente ofrece a los consumidores, así que confírmala antes de publicarla. Para obtener más información sobre las versiones del agente y otras opciones, consulte Configuración del punto de conexión y la configuración del agente.

PATCH {{endpoint}}/agents/{{agent_name}}?api-version=v1
Authorization: ******
Content-Type: application/merge-patch+json

{
  "agent_endpoint": {
    "version_selector": {
      "version_selection_rules": [
        {
          "type": "FixedRatio",
          "agent_version": "2",
          "traffic_percentage": 100
        }
      ]
    }
  }
}

¿Qué ocurre al publicar?

Al publicar un agente, Foundry realiza los pasos siguientes:

• Valida las propiedades que envíe, como el nombre para mostrar, la descripción y la versión.
• Compila un manifiesto de aplicación de Teams como un .zip paquete. Para obtener más información, consulte Esquema de manifiesto de aplicación para Microsoft Teams.
• Envía el manifiesto a los catálogos de agentes de Microsoft 365 Copilot y Teams en su nombre.
• Habilita el activity protocolo, que el agente necesita intercambiar mensajes con Microsoft 365 y Teams.
• Habilita un esquema de autorización, ya sea BotServiceRbac o BotServiceTenant, que controla quién puede llamar al agente, en función del ámbito que seleccione.

Quién puede ver y llamar al agente

El ámbito que seleccione controla la visibilidad — quién puede encontrar el agente en las tiendas de Microsoft 365 Copilot y Teams. Foundry establece el esquema de autorización coincidente, que controla quién puede llamar al agente:

• Solo tú (Foundry portal) o publishScope establecido en Shared (REST API): Habilita BotServiceRbac y no requiere la aprobación de un administrador. El agente aparece en las tiendas solo para ti. Si lo agrega a un chat de Teams, los participantes que tengan los permisos de Foundry necesarios en el proyecto pueden usarlo.
• Personas de la organización (portal de Foundry) o publishScope establecido en Tenant (API REST): Habilita BotServiceTenant y requiere la aprobación de un administrador en el Centro de administración de Microsoft 365. Tras la aprobación, el agente aparece para todos los usuarios de tu inquilino en Creado por tu organización, y cualquier persona del inquilino puede encontrarlo y utilizarlo.

Publicar en Microsoft 365 y Teams

La publicación desde el portal invoca la API de publicación de Microsoft 365 de Foundry y crea el paquete de la aplicación de Teams por usted. Para publicar mediante la API REST en su lugar, por ejemplo, para automatizar la publicación o publicar desde un proyecto que deshabilita el acceso a la red pública, consulte Publicación de agentes en Microsoft 365 Copilot y Microsoft Teams mediante la API REST. En ese artículo también se muestra cómo habilitar la ruta del protocolo de actividad pública filtrada por IP de origen para un agente de red privada.

Puede abrir el cuadro de diálogo publicar desde la pestaña Detalles (en la sección Canales, seleccione Teams & Microsoft 365 Copilot) o desde el botón Publicar. Estos pasos usan el botón Publicar .

1. En el portal Microsoft Foundry, seleccione Publicar y, a continuación, seleccione Teams y Microsoft 365 Copilot.

   Resultado esperado: se abre el cuadro de diálogo Publicar en Teams y Microsoft 365 .

2. Un recurso de Azure Bot Service se crea automáticamente o se muestra como de solo lectura si ya existe uno.

3. Complete los metadatos necesarios:

   Campo	Descripción
   Nombre	Nombre visible del agente (aparece en la tienda de agentes)
   Publicar versión	Número de versión de tres partes (major.minor.patch)
   Descripción breve	Descripción de una frase de lo que hace el agente
   Descripción	Descripción más larga de las responsabilidades del agente y las acciones que puede realizar
   Desarrollador	Nombre o nombre de la organización (en Autor)

   Para agregar metadatos opcionales, expanda Más y complete los campos siguientes:

   Campo	Descripción
   Sitio web para desarrolladores	Dirección URL al sitio web (se requiere HTTPS)
   Términos de uso	Dirección URL a los términos de uso (se requiere HTTPS)
   Declaración de privacidad	Dirección URL a la directiva de privacidad (se requiere HTTPS)

   Advertencia

   No incluya secretos, claves de API ni información confidencial en ningún campo de metadatos. Estos campos son visibles para los usuarios.

4. Seleccione Siguiente: Opciones de publicación.

5. Elija cómo publicar. Puede publicar el agente directamente desde Foundry o descargar y personalizar el manifiesto del agente y, a continuación, transferirlo manualmente en Teams.

Publicación directa

1. En Opciones de publicación, seleccione la pestaña Publicación directa .

   Resultado esperado: aparece la sección Elegir quién puede usar este agente .

2. En Elegir quién puede usar este agente, seleccione un ámbito:

   Opción	Comportamiento	Aprobación del administrador	Más adecuado para
   Sólo tú	Disponible inmediatamente. El agente aparece en Tus agentes en el almacén del agente. Envíe el vínculo del representante para compartirlo con otros.	No es necesario	Pruebas personales, equipos pequeños, pilotos
   Personas de su organización	El agente se envía para la aprobación del administrador. El administrador de Microsoft 365 revisa la solicitud y asigna acceso. Una vez aprobado, el agente aparece en Generado por su organización para todos los usuarios del inquilino.	Obligatorio	Distribución en toda la organización, implementaciones de producción

   Sólo tú:

   • Disponible inmediatamente después de la publicación: no se requiere ninguna aprobación de administrador.
   • Solo verá el agente inicialmente en Sus agentes en la tienda de agentes.
   • Comparta con usuarios específicos enviando el enlace del agente.

   Personas de su organización:

   • Después de publicar, un administrador de Microsoft 365 debe revisar y aprobar la solicitud en el Centro de administración de Microsoft 365.

   • Una vez aprobado, el agente aparece en Generado por su organización en la tienda de agentes para todos los usuarios del inquilino.

   • Las directivas de aplicación en su entorno determinan qué usuarios tienen acceso al agente.

   • Para comprobar el estado de aprobación, vaya al Centro de administración de Microsoft 365 y busque el agente en Solicitudes.

     

3. Seleccione Publicar.

   Resultado esperado: cuando aparece el cuadro de diálogo Publicación completada, se confirma que el agente se ha publicado correctamente.

Descarga y personalización

Si desea personalizar el manifiesto del agente antes de distribuirlo:

1. En Opciones de publicación, seleccione la pestaña Descargar y personalizar .

   Resultado esperado: la pestaña muestra instrucciones para después de descargar y un botón Descargar ZIP .

2. Seleccione Descargar ZIP.

   Resultado esperado: un .zip archivo que contiene el manifiesto del agente se descarga en el equipo local.

3. Personalice el manifiesto en el paquete descargado según sea necesario.

4. En Microsoft Teams, cargue el paquete que descargó.

   1. Vaya a Aplicaciones>Administrar las aplicaciones>Cargue una aplicación.
   2. Seleccione Cargar una aplicación personalizada o Enviar una aplicación a la organización y elija el archivo descargado .zip .

Actualizar un agente publicado en M365/Teams

Actualiza la versión del agente activo

Para implementar una nueva versión del agente, actualice el selector de versiones del agente en el portal de Foundry. La dirección URL del punto de conexión estable permanece igual, no es necesario volver a publicar en M365/Teams.

Actualizar los metadatos del usuario final en M365/Teams

Para actualizar los metadatos visibles en Teams y M365 (nombre para mostrar, descripciones, direcciones URL), en la lista desplegable Publicar, seleccione Actualizar las propiedades de visualización de Teams del agente y Microsoft 365 Copilot. Los campos actualizados sobrescriben los valores existentes. Los campos sin cambios se conservan. La versión se incrementa automáticamente si no la incrementa manualmente.

Limitaciones

Para conocer las limitaciones de publicación del agente, incluidos los requisitos cuando el proyecto deshabilita el acceso a la red pública, consulte Limitaciones.

Solucionar problemas de publicación

Use la tabla siguiente para resolver los errores que se producen al publicar desde el portal. Para obtener una solución de problemas más extensa, incluida la búsqueda de un agente publicado en el almacén y la resolución de errores al chatear con él, consulte Solución de problemas.

Si el portal muestra Este agente usa un formato anterior que ya no se puede publicar en Teams y Microsoft 365 Copilot. Actualice al nuevo formato para publicar. El agente usa el formato de aplicación del agente anterior, que el flujo de publicación disponible con carácter general no admite la nueva publicación. Actualice el agente al nuevo formato y, a continuación, publíquelo. Los agentes existentes en el formato anterior siguen funcionando y todavía se pueden actualizar. Consulte Migración de aplicaciones de agente al nuevo modelo de agente.

Preguntas más frecuentes

Si selecciono el alcance de la organización, ¿dónde apruebo al agente?

Apruebe el agente en el Centro de administración de Microsoft 365. Tras la aprobación, el agente aparece en Creados por tu organización en la tienda de agentes.

Si publico mi agente en ámbito individual (anteriormente denominado Ámbito compartido), ¿cómo puedo compartirlo con otros usuarios de mi organización?

El agente aparece en Tus agentes en la tienda de agentes de Microsoft 365 Copilot. Para compartirlo, envíe el vínculo del agente a los usuarios seleccionados de su organización.

¿Qué ocurre cuando se crea una nueva versión del agente si mi agente se publica en M365?

Si el selector de versiones se establece en Usar siempre la versión más reciente (el valor predeterminado), la nueva versión sirve automáticamente en M365 y Teams. Si fija una versión específica, debe actualizar el selector de versiones para ofrecer la nueva versión.

Contenido relacionado

• Configuración del punto de conexión y la configuración del agente
• Publicación de agentes en Microsoft 365 Copilot y Microsoft Teams mediante la API REST
• Control de acceso basado en rol en el portal de Foundry
• Migrar aplicaciones de agente al nuevo modelo de agente