Avanzado: uso del kit de herramientas de Microsoft 365 Agents
En la mayoría de los escenarios, la publicación directamente desde el portal de Foundry es la ruta de acceso más sencilla para que los agentes entren en Microsoft Teams y Microsoft 365 Copilot. Sin embargo, algunos escenarios empresariales complejos requieren control adicional sobre la capa de integración. El kit de herramientas de agentes de Microsoft 365 proporciona un enfoque alternativo para estas situaciones.
En esta unidad se trata el Kit de herramientas de agentes desde una perspectiva de alto nivel. Siga los vínculos a la documentación al final para obtener una explicación más detallada.
Nota:
En esta unidad se trata un tema avanzado. Si está empezando con la integración del agente Foundry, puede omitir esta unidad y volver a ella más adelante si encuentra escenarios que requieren el enfoque del Kit de Herramientas de Agentes.
Cuándo se debe tener en cuenta el Kit de herramientas de agentes
"Microsoft 365 Agents Toolkit es un conjunto de herramientas de desarrollo disponibles en forma de extensiones para Visual Studio Code y Visual Studio." Considere la posibilidad de usarlo cuando el agente requiera una configuración de inicio de sesión único (SSO) personalizada más allá de la configuración predeterminada de Entra ID, o cuando necesite agregar lógica de middleware para el procesamiento personalizado, el registro o la transformación entre Teams y el agente de Foundry.
El kit de herramientas también es útil para las organizaciones que requieren implementación de varios entornos con configuraciones de desarrollo, ensayo y producción independientes. Proporciona capacidades de depuración avanzadas con seguimiento detallado más allá de lo que ofrece el portal de Foundry, y se integra con los pipelines de CI/CD a través de GitHub Actions o Azure DevOps.
Funcionamiento del enfoque del Kit de herramientas de agentes
En lugar de publicar directamente desde Foundry, se crea una aplicación proxy mediante agents Toolkit que se encuentra entre Microsoft 365 y el agente de Foundry:
Teams/Copilot → Proxy App (Agents Toolkit) → Foundry Agent
Esta aplicación proxy recibe mensajes de Teams o Copilot a través de Azure Bot Service, los procesa a través de cualquier middleware personalizado que haya configurado, reenvía la solicitud al agente foundry y devuelve la respuesta a través de la misma ruta de acceso. El enfoque de proxy proporciona control sobre cada paso del flujo de mensajes, pero agrega complejidad a la implementación.
Comenzando con el Toolkit de agentes
Si determina que el Toolkit de Agentes es adecuado para su escenario, aquí hay una visión general del proceso de instalación.
Comience instalando la extensión Microsoft 365 Agents Toolkit desde el marketplace de Visual Studio Code. Una vez instalado, abra el panel de extensión y seleccione Create a New Agent/App, elija Custom Engine Agent como tipo de project. El asistente le guía por las opciones de configuración, incluido el origen del modelo de IA.
La plantilla de proyecto crea una estructura para un agente independiente. Para conectarse a un agente de Foundry existente, configure el proyecto para llamar al endpoint del agente de Foundry, configure la autenticación mediante las credenciales del agente e implemente cualquier lógica de middleware que necesite.
Agents Toolkit incluye el Microsoft 365 Agents Playground, un entorno de prueba local que simula Teams. Ejecute el proyecto en modo de depuración para abrir el playground en su navegador, donde puede enviar mensajes de prueba para comprobar que la conexión funciona correctamente. Una vez completada la prueba, use el kit de herramientas para aprovisionar Azure recursos, implementar la aplicación proxy y registrarla en Teams.
Resumen de comparación
| Aspecto | Publicación de Direct Foundry | Proxy del kit de herramientas de agentes |
|---|---|---|
| Tiempo preparación | Minutos | Horas a días |
| Código necesario | Ninguno | Aplicación proxy |
| Customization | Limitado | Extenso |
| Depuración | Portal de fundición | Depuración de IDE completa |
| Más adecuado para | Implementaciones estándar | Necesidades empresariales complejas |
Aprende más
Para obtener una guía detallada sobre el Agents Toolkit, consulte:
- Documentación de Microsoft 365 Agents Toolkit
- Crear agentes de motor personalizados con Agents Toolkit
- Información general sobre Microsoft 365 Agents SDK
El enfoque de publicación directa descrito en la unidad anterior controla la mayoría de los escenarios de integración. Reserve el Kit de herramientas de agentes para situaciones en las que haya identificado requisitos específicos que aborda.