Resumen del SDK de Microsoft Agent 365

El SDK Microsoft Agent 365 conecta un agente que ya posees y ejecuta con Microsoft Agent 365. Úsalo para acceder a nivel de código a capacidades como la identidad del agente, herramientas Work IQ gobernadas o notificaciones.

Dónde encaja el SDK

Agent 365 reúne agentes de diferentes fuentes en un solo plano de control donde las organizaciones pueden descubrirlos, gobernarlos y protegerlos a gran escala. El camino de integración depende de dónde y cómo construyas el agente:

Origen del agente Ruta de integración
Plataformas y agentes de Microsoft, y agentes de terceros compatibles Utiliza la integración nativa de Agent 365 de la plataforma. Estos agentes pueden aparecer en el inventario del Agente 365 sin añadir el SDK del Agente 365.
Agentes construidos con un SDK o framework, como SDK de agentes de Microsoft 365, OpenAI Agents SDK, Microsoft Agent Framework, LangChain, CrewAI o LlamaIndex Añade el SDK Agent 365 a tu código de agente para capacidades integradas por desarrolladores, como las herramientas de Work IQ o las notificaciones.
Plataformas de agentes conectados, como Vertex AI o AWS Bedrock Configura la sincronización de registros para cada plataforma para importar sus agentes al inventario de Agent 365.

Las tres vías conectan a los agentes con Agent 365 y sus integraciones con Microsoft Entra, Microsoft Defender, Microsoft Purview y Microsoft Intune. La integración nativa y la sincronización del registro no proporcionan necesariamente las mismas capacidades a nivel de código que el SDK del Agente 365. Las integraciones de plataformas evolucionan, así que confirma la guía actual de la plataforma antes de cambiar una integración. Consulta Elige tu opción de integración.

Cómo encajan las capacidades de Agent 365

La integración para desarrolladores de Agent 365 ofrece cuatro capacidades. El SDK del Agente 365 proporciona identidad, herramientas y notificaciones. Microsoft OpenTelemetry proporciona observabilidad:

Capacidad Description
Identity Utiliza una identidad de agente respaldada por Microsoft Entra para una autenticación segura y acceso controlado a herramientas y datos. Los agentes que necesitan su propia cuenta de usuario y buzón solo están disponibles para los inquilinos que participan en el programa de versión preliminar de Frontier.
Observabilidad Utiliza la Microsoft OpenTelemetry Distro independiente para emitir telemetría que produzca interacciones auditadas y rastreables, eventos de inferencia y uso de herramientas.
Herramientas Invocar servidores gobernados de Protocolo de contexto del modelo (MCP) de Work IQ para acceder a cargas de trabajo de Microsoft 365, como Correo, Calendario, Word, SharePoint y Teams bajo control del administrador.
Notificaciones Recibe y responde a mensajes de Teams, Outlook, comentarios de Word y correo electrónico, como un participante humano en las aplicaciones de Microsoft 365. Esta capacidad requiere la cuenta de usuario de un agente y está disponible solo para los clientes que participan en el programa de vista previa de Frontier.

Importante

No uses el obsoleto SDK de observabilidad Agent 365 para nuevas integraciones de observabilidad. Usa la distribución OpenTelemetry de Microsoft. Sigue utilizando los paquetes del SDK Agent 365 para identidad, herramientas y notificaciones.

Elige las capacidades que se ajusten a los requisitos de tu agente en lugar de adoptar toda la funcionalidad del SDK. Identidad, herramientas y notificaciones utilizan un plano técnico de identidad del agente como su base de Entra. Las notificaciones también requieren una cuenta de usuario de agente. Microsoft OpenTelemetry puede utilizar tanto el blueprint de identidad del agente como un registro estándar de la app Microsoft Entra.

El SDK se entrega en paquetes específicos de cada lenguaje para Python, JavaScript y .NET. Instala el paquete o paquetes para las capacidades que selecciones, luego configura la identidad correspondiente, los permisos y la integración en tiempo de ejecución. Para los paquetes disponibles, véase paquetes del SDK del Agente 365. Instala Microsoft OpenTelemetry por separado para nuevas integraciones de observabilidad.

Comparar Microsoft Agent 365 SDK y el SDK de agentes de Microsoft 365

El SDK de Microsoft Agent 365 y el SDK de agentes de Microsoft 365 son productos diferentes.

Microsoft Agent 365 SDK (Este SDK) SDK de agentes de Microsoft 365
No crea agentes.
Extiende un agente que ya existe para añadir identidad, herramientas y notificaciones. Usa Microsoft OpenTelemetry para añadir observabilidad.		 Un marco para construir agentes conversacionales.
Se encarga de la entrega de mensajes a través de canales como Teams y Microsoft Copilot, y gestiona el estado de la conversación.

Estos SDKs trabajan juntos. Puedes construir un agente con el SDK de agentes de Microsoft 365, usar el SDK Agent 365 para identidad, herramientas y notificaciones, y usar Microsoft OpenTelemetry para observabilidad.

Qué es y qué no es

Sigues siendo dueño de las tres capas que hacen que el agente funcione:

Nivel Description
Modelo El modelo de lenguaje o motor de razonamiento al que llama tu agente. El SDK no llama ni selecciona modelos.
Marco o runtime LangChain, Microsoft Agent Framework, Kernel semántico, el SDK OpenAI Agents, el SDK Claude Agent o código personalizado. El SDK no compila agentes, no planifica ni orquesta pasos, ni ejecuta herramientas.
Host Donde sea que el agente opere hoy en día, como Azure, AWS, Google Cloud o en las instalaciones. El SDK no aloja ni despliega tu agente.

El SDK Microsoft Agent 365 se ejecuta junto con estas capas. No construye, aloja, despliega, orquesta ni ejecuta al agente.

Note

El SDK de Microsoft Agent 365 registra servidores MCP gobernados para que tu agente pueda alcanzar cargas de trabajo de Microsoft 365, pero tu runtime sigue ejecutando las llamadas a la herramienta.

El flujo de incorporación

La integración consta de cuatro etapas:

Stage Description
1. Registrar Crea el blueprint de identidad del agente y la identidad del agente en Microsoft Entra.
2. Ampliar Añade las capacidades que tu agente necesita. Utiliza el SDK Agent 365 para herramientas o notificaciones de Work IQ, y usa Microsoft OpenTelemetry para la observabilidad.
3. Validar Ejecuta el agente como antes y confirma su identidad, telemetría, acceso a la herramienta y manejo de mensajes.
4. Operar Utiliza los controles del Agente 365 para gobernar y auditar al agente conectado.

Puedes completar estos pasos manualmente o usar Agent 365 Skills con un asistente de programación compatible. Las habilidades guían la configuración, realizan los cambios necesarios y validan el resultado.

Cómo fluye una solicitud

Una sola interacción puede usar las cuatro capacidades. Cuando alguien @mentions a tu agente en un comentario de Word:

  1. Las notificaciones entregan la mención a tu agente.
  2. La identidad y la autenticación determinan si el agente actúa como él mismo, en nombre de un usuario iniciado sesión o a través de una cuenta de usuario agente. El modo seleccionado, permisos, consentimiento y objeto del token definen qué datos y acciones están disponibles.
  3. Las herramientas proporcionan al agente acceso controlado a los datos de Microsoft 365 que necesita.
  4. La observabilidad registra la invocación, las llamadas a herramientas y la inferencia del modelo.

Tu agente responde entonces en el hilo de comentarios.

Paquetes SDK de Agent 365

Encuentra los paquetes del SDK Agent 365 en los gestores de paquetes de los lenguajes compatibles.

Importante

Los paquetes de observabilidad en las siguientes tablas están obsoletos. No los uses para nuevas integraciones. Utiliza la Microsoft OpenTelemetry Distro, o revisa la documentación obsoleta del Agent 365 Observability SDK antes de migrar una integración existente.

Puedes encontrar los paquetes Agent 365 SDK para Python en el Python Package Index (PYPI).

Package Description
microsoft-agentes-a365-notificaciones Extensiones de notificación y mensajería para aplicaciones del agente de IA. Proporciona utilidades para controlar las notificaciones del agente, los eventos del ciclo de vida y el enrutamiento entre diferentes canales y subcanales en aplicaciones Microsoft 365.
microsoft-agents-a365-observability-core Obsoleto: Componentes heredados de telemetría, trazado y monitorización para agentes de IA construidos sobre OpenTelemetry. Proporciona intervalos estructurados para la invocación de agentes, la ejecución de herramientas y la inferencia de LLM con propagación de contexto y exportadores conectables. Usa la distribución OpenTelemetry de Microsoft en su lugar.
microsoft-agents-a365-observability-extensions-agent-framework Obsoleto: Extensiones de observabilidad heredadas para Microsoft Agent Framework. Proporciona integración de seguimiento de OpenTelemetry específicamente para aplicaciones basadas en Agent Framework. Usa la distribución OpenTelemetry de Microsoft en su lugar.
microsoft-agents-a365-observability-extensions-openai Obsoleto: Extensiones de observabilidad heredadas para el SDK OpenAI Agents. Proporciona integración de seguimiento de OpenTelemetry para aplicaciones basadas en agentes de OpenAI con instrumentación automática para flujos de trabajo de agente e invocaciones de herramientas. Usa la distribución OpenTelemetry de Microsoft en su lugar.
microsoft-agents-a365-observability-extensions-langchain Obsoleto: Extensiones de observabilidad heredadas para el marco LangChain. Proporciona integración de seguimiento de OpenTelemetry para aplicaciones de IA basadas en LangChain con instrumentación automática para cadenas, agentes y herramientas. Usa la distribución OpenTelemetry de Microsoft en su lugar.
microsoft-agents-a365-observability-extensions-semantic-kernel Obsoleto: Extensiones de observabilidad heredadas para el framework Kernel semántico. Proporciona integración de seguimiento de OpenTelemetry para aplicaciones basadas en Kernel semántico con instrumentación automática para funciones de kernel, complementos y planificadores. Usa la distribución OpenTelemetry de Microsoft en su lugar.
microsoft-agents-a365-runtime Utilidades principales del runtime y administración del entorno para las aplicaciones del agente de IA. Proporciona la detección esencial de la API de Power Platform, la configuración del entorno y la resolución del ámbito de autenticación.
microsoft-agents-a365-tooling Funcionalidad básica de herramientas para la administración de servidores de herramientas MCP (Protocolo de contexto de modelo) en aplicaciones compiladas con el SDK de Microsoft Agent 365. Proporciona la base para detectar, registrar y administrar servidores de herramientas en diferentes marcos de inteligencia artificial.
microsoft-agents-a365-tooling-extensions-agentframework Herramientas y servicios específicos de Agent Framework para el desarrollo de agentes de IA. Proporciona el servicio de registro de herramientas MCP (Protocolo de contexto de modelo) para agregar dinámicamente servidores MCP a agentes de Agent Framework.
microsoft-agents-a365-tooling-extensions-openai Herramientas y servicios específicos del SDK de agentes de OpenAI para el desarrollo de agentes de IA. Proporciona el servicio de registro de herramientas MCP (Protocolo de contexto de modelo) para agregar dinámicamente servidores MCP a agentes basados en el SDK de OpenAI.
microsoft-agents-a365-tooling-extensions-semantickernel Kernel semántico herramientas y servicios específicos para el desarrollo de agentes de IA. Proporciona el servicio de registro de herramientas MCP (Protocolo de contexto de modelo) para agregar dinámicamente servidores MCP a agentes basados en Kernel semántico.
microsoft-agents-a365-tooling-extensions-azureaifoundry Fundición de IA de Azure herramientas y servicios específicos para el desarrollo de agentes de IA. Proporciona el servicio de registro de herramientas MCP (Protocolo de contexto de modelo) para agregar dinámicamente servidores MCP a agentes de Fundición de IA de Azure.

Contenido relacionado

  • Se actualizó por última vez el