Información general sobre el SDK de Microsoft Agent 365

El SDK de Microsoft Agent 365 amplía el agente de IA existente basado en cualquier pila de agentes con identidad de nivel empresarial, observabilidad, herramientas y gobernanza.

Con el SDK del Agent 365, los desarrolladores pueden usar opcionalmente la identidad del agente para recibir y responder a las notificaciones de las aplicaciones de productividad. El SDK también permite a los agentes invocar servidores regulados y observables del Protocolo de contexto de modelos (MCP) desde Microsoft. Además, los agentes pueden emitir telemetría para proporcionar a los administradores de TI información sobre la funcionalidad y el rendimiento del agente.

¿Qué es el SDK de Agent 365?

El SDK del Agent 365 es un kit de desarrollo de software completo que amplía los agentes para adaptarse sin problemas a los flujos de trabajo existentes, a la vez que sigue funcionando de manera independiente cuando sea necesario. Los agentes pueden tener identidades únicas, se pueden invocar mediante gestos comunes (por ejemplo, @mentions) en aplicaciones en las que los usuarios suelen operar (como Teams, Word, Outlook, etc.), demostrar comportamientos observables, crear confianza, realizar acciones auditables y lograrlo todo a través del acceso seguro a herramientas y datos.

La identidad del agente permite el control de acceso cerrado y supervisado a un administrador, a la vez que proporciona al agente el poder que necesita para prosperar. Los agentes adquieren una identidad a través del proceso de adquisición. Durante el ciclo de vida de desarrollo, los desarrolladores pueden obtener un plano técnico de aplicaciones de Microsoft Entra con los servidores MCP necesarios mediante la CLI del Agent 365 y crear la plantilla para todas las instancias de agente creadas a partir de ese plano técnico.

Con las notificaciones, acercamos los patrones de interacción de los agentes a un ser humano. Los agentes pueden responder a los usuarios en contexto dentro de aplicaciones de productividad, como Teams, o a comentarios en Word. Los agentes también pueden responder a los correos electrónicos enviados al buzón del agente, que se entregan a un punto de conexión de notificación hospedado por el agente. El agente también puede participar en operaciones de ciclo de vida, como Adquirir y No adquirir, y elegir configurar y limpiar ciclos durante ese tiempo para una identidad del agente.

Basado e integrado con Open Telemetry, el SDK de Agents 365 captura telemetría detallada para la actividad de cada agente, incluidos eventos de inferencia, uso de herramientas y notificaciones. Los administradores obtienen visibilidad completa de cómo funcionan los agentes e interactúan con usuarios, sistemas y datos mediante Purview y Defender.

Los agentes pueden usar los servidores MCP de Microsoft para llevar a cabo varios escenarios, como enviar correo electrónico, buscar documentos en SharePoint y responder a los comentarios de un documento con cambios mínimos en el código del Agente. Los administradores controlan estos servidores MCP y la creciente lista de herramientas permiten al agente prosperar en el espacio de productividad.

Agent 365 funciona con agentes basados en Microsoft Agent Framework, Copilot Studio, Fundición de IA de Azure, Kernel semántico, SDK de agentes de OpenAI, SDK de código Claude y LangGraph.

¿Cómo es de diferente el SDK de Agent 365?

• El SDK de Agent 365 no es una pila de agentes. No es la manera de crear u hospedar un agente y no viene con ningún orquestador o administración de flujos de trabajo contrario a Microsoft Agent Framework o Microsoft Copilot Studio o Microsoft Foundry.
• No reemplaza el SDK del Agente de Microsoft 365 y la funcionalidad que proporciona para hospedar, protocolo de actividad e identidad. Por el contrario, el SDK de Agent 365 usa paquetes para el SDK de Agent de Microsoft 365 para entregar notificaciones a través del protocolo de actividad y usa los paquetes de identidad del agente para obtener el token de agente para un agente cuando corresponda.
• Agent 365 pide a los desarrolladores que empiecen con un agente existente cuando estén disponibles desde un marco de agente de su elección. Después, pueden ampliar su agente para proporcionar más funcionalidad que hace que sus agentes sean controlables, observables y más productivos en el mundo digital.

Descripción del plano técnico de un agente en Agent 365

Antes de crear una instancia del agente, resulta útil comprender lo que queremos decir con el plano técnico de un agente de Agent 365. Un plano técnico es una definición preconfigurada aprobada por TI de un tipo de agente, básicamente la "plantilla" empresarial a partir de la cual se crean todos los agentes compatibles. Define las funcionalidades del agente, el acceso a las herramientas MCP requeridas, las restricciones de seguridad y cumplimiento, los requisitos de auditoría, los metadatos del ciclo de vida y las plantillas de directivas de gobernanza vinculadas, como DLP, restricciones de acceso externo o reglas de registro. Cuando se activa un plano técnico, se convierte en contratable, lo que significa que los administradores pueden crear instancias de nuevos agentes desde él en el Centro de administración de Microsoft 365. Cada instancia del agente hereda las reglas de su plano técnico, lo que garantiza una gobernanza coherente entre correo, calendario, mensajería de Teams, acceso a SharePoint y cualquier otra carga de trabajo de Microsoft 365 que el agente toque. Esto evita que "agentes de sombras" aplica observabilidad y delimita a cada agente en un modelo seguro de permisos e identidades respaldados por Entra.

Paquetes del SDK de Agent 365

Busque los paquetes del SDK de Agent 365 en los administradores de paquetes para los idiomas admitidos.

Flujo de alto nivel de un agente de Agent 365

En el siguiente diagrama de flujo se muestra el flujo de desarrollador para agentes

Comienza con un agente que ya ha creado con un lenguaje de programación y el marco de trabajo del agente que prefiera. A continuación, puede usar el SDK de Agent 365 para ampliar los agentes que ya ha creado, agregando las funcionalidades especializadas, como las notificaciones, la observabilidad y las conexiones del servidor de herramientas que necesitan para ejecutarse dentro de la plataforma. Si quiere ejemplos de cómo se estructuran los agentes existentes, los inicios rápidos le guiarán por los agentes de ejemplo incluidos en el Kit de herramientas de agentes de Microsoft 365 para VS Code. Consulte los inicios rápidos de Agent 365 disponibles para obtener ejemplos:

• Inicio rápido: Configurar y ejecutar el agente de ejemplo LangChain de JavaScript
• Inicio rápido: Configurar y ejecutar el agente de ejemplo del agente de Python
• Inicio rápido: Configurar y ejecutar el agente de ejemplo del SDK de agente de Claude para JavaScript

Determine en qué servidores MCP de Microsoft se basa el agente, configure esas conexiones e integre los componentes de Agent 365: observabilidad, notificaciones y conexiones de servidor de herramientas mediante los patrones proporcionados en los ejemplos de GitHub.

Después, genere un plano técnico de Agent 365 que defina cómo se representa y conecta el agente a la plataforma. Con el plano técnico implementado, pruebe el agente en el área de juegos de agentes. Esto le proporciona un espacio para validar las notificaciones, probar las interacciones de MCP e inspeccionar la telemetría antes de implementar en cualquier lugar.

Cuando todo parezca correcto, publique el agente en un inquilino. Desde allí, los administradores pueden habilitarlo y administrarlo en el Centro de administración de Microsoft 365.

¿Cuándo necesita el SDK de Agent 365?

Use el SDK de Agent 365 cuando necesite:

• Integrar con datos o herramientas de Microsoft 365 a través de conectores MCP seguros
• Controlar y auditar varios agentes en toda la organización
• Proporcionar telemetría y supervisión de nivel empresarial
• Habilitar notificaciones para interacciones del agente
• Implementar en entornos regulados que requieren rastreabilidad y administración del ciclo de vida

Cómo se ajusta el SDK de Agent 365 en el ecosistema del agente

Beneficios de un vistazo

• Identidad unificada y gobernanza en todos los agentes
• Telemetría y seguimiento predefinidos
• Protección y control del acceso a las herramientas de Microsoft 365
• Compatibilidad con varios orquestadores y multinube
• Ruta de actualización simplificada para agentes existentes

Pasos siguientes

• Más información acerca del plano técnico del agente y la configuración de instancias
• Agregar observabilidad a su agente
• Agregar y administrar herramientas