Descripción de las opciones de publicación del agente de Foundry
Al compilar un agente en Microsoft Foundry, se ejecuta dentro de la infraestructura del servicio Foundry Agent. La publicación promueve al agente desde un recurso de desarrollo a un recurso de Azure administrado con un punto de conexión dedicado, una identidad independiente y funcionalidades de gobernanza.
Comprensión de las aplicaciones del agente
Al publicar un agente, Microsoft Foundry crea un recurso de aplicación del agente con:
- URL de invocación dedicada: un punto de conexión estable que se mantiene constante a medida que actualiza las versiones del agente
- Agent identity: una identidad de Microsoft Entra distinta e independiente de tu proyecto de desarrollo
- Aislamiento de datos de usuario: las entradas e interacciones de un usuario no están disponibles para otros usuarios
La aplicación agente actúa como una capa de enrutamiento. Al publicar una nueva versión del agente, el tráfico se enruta automáticamente a la implementación actualizada sin cambiar el punto de conexión público.
Publicación en Microsoft 365
El enfoque principal de este módulo es la integración de Microsoft 365, lo cual permite que tu agente aparezca en Teams y Copilot. Publicación en Microsoft 365:
- Crea un recurso de Azure Bot Service que enruta los mensajes entre Microsoft 365 y el agente
- Genera un paquete de publicación de Microsoft 365 para la distribución
- Registra una aplicación de Microsoft Entra ID para la autenticación
- Permite que su agente sea descubierto en la tienda de agentes de Teams
Publicación directa desde el portal de Foundry
El enfoque más sencillo es publicar directamente desde el portal de Foundry. El asistente de publicación:
- Crea un recurso de Azure Bot Service en la suscripción
- Registra una aplicación de Microsoft Entra ID
- Genera un paquete de publicación de Microsoft 365
- Prepara el agente para la distribución
Este enfoque es ideal cuando desea implementar rápidamente o mantener la lógica del agente completamente dentro de Foundry.
Kit de herramientas de agentes de Microsoft 365
En escenarios complejos, puede usar Microsoft 365 Agents Toolkit para crear una aplicación proxy que se conecte al agente de Foundry. Tenga en cuenta este enfoque cuando necesite inicio de sesión único (SSO) personalizado, lógica avanzada de middleware o pipelines de implementación en varios entornos. El Kit de herramientas de agentes se trata más adelante en este módulo como un tema avanzado opcional.
Publicar alcances
Al publicar en Microsoft 365, elija entre dos ámbitos de distribución:
| Ámbito | Description | Más adecuado para |
|---|---|---|
| compartido | Disponible inmediatamente sin aprobación de administrador. Aparece en Tus agentes en Teams. | Pruebas personales, pilotos de equipos pequeños |
| Organización | Disponible para todos los usuarios en su entorno bajo Creado por su organización. Requiere aprobación del administrador. | Implementaciones de producción |
Otros canales de publicación
Aunque este módulo se centra en Microsoft 365, los agentes de Foundry también pueden publicar en:
- Vista previa de aplicaciones web: interfaz basada en explorador para demostraciones y pruebas de partes interesadas
- Punto de conexión de API estable: API REST para insertar en aplicaciones personalizadas
- Azure Bot Service canales: Slack, Telegram, Twilio (SMS), Facebook y otros
Estas opciones son útiles cuando necesita llegar a los usuarios fuera de Microsoft 365 o insertar el agente en aplicaciones personalizadas.
Identidad y permisos del agente
Al publicar un agente, el sistema crea una identidad de agente distinta. Esto es importante porque:
- El agente se autentica a los recursos de Azure utilizando su propia identidad.
- Los permisos de tiempo de desarrollo en la identidad de su proyecto no se transfieren automáticamente
- Las herramientas que acceden a los servicios de Azure necesitan que se reconfiguren los permisos después de publicar.
Si el agente usa herramientas que se conectan a servicios como Azure AI Search, conceda a la identidad del agente publicado los permisos adecuados.
Requisitos previos para la publicación
Antes de publicar un agente en Microsoft 365, asegúrese de que tiene:
- rol Azure AI Project Manager en el proyecto Foundry
- Usuario de Azure IA en el nivel de la aplicación del agente
- Una suscripción de Azure en la que puede crear recursos de Azure Bot Service
- Permisos para registrar aplicaciones en Microsoft Entra ID
- Un inquilino de Microsoft 365 que permite aplicaciones y bots personalizados