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 cuando tu agente necesite acceso a nivel de código a capacidades de Agent 365 como identidad del agente, observabilidad, herramientas Work IQ gobernadas o notificaciones.

Dónde encaja el SDK

El modelo de integración muestra el límite entre integraciones integradas, sincronización de registros y escenarios integrados por desarrolladores del Agent 365 SDK.

Diagrama del modelo de integración del Agente 365 mostrando dónde encaja el SDK del Agente 365.

Los agentes en plataformas con integración integrada con Agent 365, y los agentes importados mediante sincronización de registro, ya pueden aparecer en el inventario de Agent 365. Añade el SDK cuando el agente necesite capacidades que la ruta de la plataforma no proporciona y que debas configurar en código, como la observabilidad o herramientas de Work IQ. Las integraciones de plataformas evolucionan, así que confirma la guía actual de la plataforma antes de decidir que el SDK es necesario. Consulta la opción Elegir tu integración.

Lo que añade el SDK

El SDK ofrece cuatro capacidades:

Capability Description
Identidad 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 vista previa de Frontier.
Observabilidad Emitir telemetría a través de OpenTelemetry, produciendo interacciones auditadas y rastreables, eventos de inferencia y uso de herramientas.
Herramientas Invoke gobernaba servidores del Protocolo de Contexto del Modelo Work IQ (MCP) para llegar a cargas de trabajo de Microsoft 365 como Mail, Calendar, Word, SharePoint y Teams bajo control administrativo.
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 inquilinos que participan en el programa de vista previa de Frontier.

Elige las capacidades que se ajusten a los requisitos de tu agente en lugar de adoptar toda la superficie del SDK. Identidad, herramientas y notificaciones utilizan un plano de identidad de agente como su base Entra. Las notificaciones también requieren una cuenta de usuario del agente, mientras que la observabilidad puede usar 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.

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

Microsoft Agent 365 SDK y 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, observabilidad, herramientas y notificaciones.		 Un marco para construir agentes conversacionales.
Se encarga de la entrega de mensajes a través de canales como Teams y Microsoft 365 Copilot, y gestiona el estado de la conversación.

Estos dos SDKs trabajan juntos, así que puedes construir un agente con el SDK de agentes de Microsoft 365 y luego usar el SDK del Agent 365 para darle identidad, observabilidad, herramientas y notificaciones.

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 que llama tu agente. El SDK no llama ni selecciona modelos.
Marco o tiempo de ejecución LangChain, Microsoft Agent Framework, Kernel semántico, el SDK OpenAI Agents, el SDK Claude Agent o código personalizado. El SDK no crea 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 se sigue en cuatro etapas:

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

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

Cómo fluye una solicitud

Una sola interacción puede usar las cuatro capacidades. Cuando alguien @mentions de 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 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.

Los paquetes SDK Agent 365 para Python están en el Índice de Paquetes de Python (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 Componentes de telemetría, seguimiento y supervisión de agentes de IA basados en 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.
microsoft-agents-a365-observability-extensions-agent-framework Extensiones de observabilidad para Microsoft Agent Framework. Proporciona integración de seguimiento de OpenTelemetry específicamente para aplicaciones basadas en Agent Framework.
microsoft-agents-a365-observability-extensions-openai Extensiones de observabilidad para el SDK de agentes de OpenAI. 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.
microsoft-agents-a365-observability-extensions-langchain Extensiones de observabilidad para el marco de 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.
microsoft-agents-a365-observability-extensions-semantic-kernel Extensiones de observabilidad para el marco 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.
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

  • Last updated on