Microsoft Agent 365 SDK y CLI

¿Es nuevo en Agent 365?

Primero, elige la opción de integración. Si la integración integrada o la sincronización del registro ofrecen las capacidades que necesitas, no necesitas añadir el SDK solo para registrar a tu agente. Para los agentes Google Vertex AI y Amazon Bedrock, consulta Registrar Google Vertex AI y Amazon Bedrock agentes.

Si tu agente necesita integración a nivel de código, elige un camino basado en tu punto de partida y el resultado que deseas:

Punto de partida	Comience aquí	Primer resultado	Antes de empezar
Tienes un agente y quieres el onboarding asistido por IA.	Inicio rápido: Conecta un agente existente a Agent 365, usando Agent 365 Skills.	Registra al agente, añade las capacidades que elijas y valida la integración.	Revisa las stacks compatibles, los asistentes de programación, el acceso a los tenants, los roles y los requisitos de licencias.
Tienes un agente y quieres ejecutar los comandos CLI tú mismo.	Crea una plantilla de agente.	Crea la plantilla que define la identidad y los permisos de tu agente.	Revisa la CLI, el rol del tenant y los requisitos de suscripción a Azure, luego usa la identidad del Agente para elegir el modelo de identidad.
Quieres aprender con un proyecto de muestra en lugar de cambiar tu propio agente.	Elige una muestra en Python, Node.js o .NET.	Configura una muestra y obtén una primera respuesta en Agents Playground.	Revisa los requisitos previos seleccionados para inicio rápido o ejemplo de README, incluyendo entorno de ejecución, acceso al modelo y configuración de autenticación.

Para la ruta de muestra, el catálogo enlaza con las guías de inicio rápido de Python + Microsoft Agent Framework, Node.js + LangChain y Node.js + Claude Agent SDK, además de una muestra de .NET. Elige tu lenguaje en el catálogo para ver los frameworks disponibles.

Note

Una respuesta local no es prueba de que las herramientas, notificaciones o telemetría en vivo de Microsoft 365 funcionen. Para las capacidades respaldadas por el tenant, revisa los requisitos de tenant, consentimiento y licencias , así como la configuración de la autenticación de pruebas.

SDK de Agent 365

Utiliza el Agent 365 SDK para extender agentes construidos usando cualquier SDK o plataforma de agentes con identidad, notificaciones, seguridad y acceso regulado a los datos de Microsoft 365. Utiliza Microsoft OpenTelemetry para la observabilidad.

Tip

¿Buscas agentes precompilados? Consulte los agentes asociados del ecosistema disponibles en el Agente 365 para los agentes que están integrados previamente al lanzamiento.

Los agentes tienen identidades únicas. Los usuarios los invocan mediante gestos comunes (como @mentions) en aplicaciones en las que los usuarios empresariales suelen funcionar (como Teams, Word, Outlook, etc.). Demuestran comportamientos observables que generan confianza, toman acciones auditables y lo hacen mediante acceso seguro a herramientas y datos.

Con el SDK Agent 365, los agentes pueden:

• Utiliza la Identidad de Agente respaldada por Entra con sus propios recursos de usuario, como su buzón, para autenticación segura y acceso controlado a las herramientas y datos.
• Reciba y responda a las notificaciones de Teams, Outlook, comentarios Word y correos electrónicos, al igual que un participante humano en Microsoft 365 aplicaciones.
• Obtén observabilidad completa mediante Telemetría Abierta, permitiendo interacciones auditadas y rastreables con agentes, eventos de inferencia y uso de herramientas.
• Invoque servidores regulados del Protocolo de contexto de modelo (MCP) para acceder a las cargas de trabajo de Microsoft 365 (por ejemplo, Correo, Calendario, SharePoint, Teams) bajo el control de administración.
• Operar dentro de un sistema de plantillas aprobado por TI, asegurando que cada instancia de agente herede políticas de cumplimiento, gobernanza y seguridad.

Revisa la visión general del SDK de Agent 365.

Agente 365 CLI

Agent 365 CLI es la infraestructura de línea de comandos para Agent 365 durante todo el ciclo de vida de desarrollo del agente; automatiza la instalación, la identidad, la configuración, la integración con MCP, la publicación y la implementación en Azure para agentes preparados para la empresa.

Con la CLI de Agent 365, los desarrolladores pueden:

• Crea planos de agentes y todos los recursos de apoyo que requieran.
• Administre herramientas de Work IQ predeterminadas y personalizadas, permisos y configuraciones para agentes.
• Implemente el código del agente en Azure.
• Publicar los paquetes de aplicaciones agente en el centro de administración de Microsoft.
• Limpie los planos técnicos del agente, las identidades y otros recursos de Azure creados por la CLI.

Obtenga más información sobre el CLI de Agent 365

Ciclo de vida del desarrollo de Agent 365

El Agente 365 funciona con agentes construidos sobre cualquier SDK o plataforma de agentes. Esto incluye plataformas de código bajo, como Copilot Studio y Fundición de IA de Azure. También soporta opciones de pro-code como Microsoft Agent Framework, Microsoft Agents SDK, OpenAI Agents SDK, Claude Code SDK y LangChain SDK. El agente 365 también funciona con el código del agente hospedado en cualquier punto de conexión, ya sea Azure, Amazon Web Services (AWS), Google Cloud Platform (GCP) o cualquier otro proveedor de nube.

El quickstart del agente existente cubre el registro, las capacidades seleccionadas y la validación. Despliegue, publicación y limpieza tienen guías separadas. Continúa con las fases que se adaptan a tu situación:

Phase	Guide
Valida la integración antes del despliegue.	Lista de verificación de validación del SDK del Agente 365 y prueba a tu agente.
Despliega el código del agente.	Azure, AWS o Google Cloud Platform.
Empaqueta y publica el agente.	Publicar el agente al centro de administración de Microsoft.
Crea y verifica una instancia de agente desplegada.	Crea instancias de agentes y prueba tu agente desplegado.
Elimina los recursos que ya no necesitas.	Referencia de limpieza de CLI, incluyendo limpieza granular y opciones de ensayo en seco.

Plano del agente Agente 365

Antes de trabajar con instancias de Agente 365, es útil entender qué queremos decir por el esquema de un agente de Agente 365. Esto procede de Microsoft Entra plano técnico del agente y es una definición preconfigurada aprobada por TI de un tipo de agente, básicamente la "plantilla" empresarial a partir de la cual se pueden crear agentes compatibles. Define las funcionalidades del agente, el acceso a herramientas de Work IQ, 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 para su uso en un inquilino, los usuarios pueden solicitar a sus administradores las nuevas instancias de agente creadas a partir del plano técnico del agente en el centro de administración de Microsoft 365. Cada instancia del agente hereda las reglas de su plantilla, lo que garantiza una gobernanza coherente entre correo, calendario, Teams, acceso a SharePoint y cualquier otra carga de trabajo de Microsoft 365 con la que el agente interactúa. Esto previene agentes sombra/rebeldes, impone la observabilidad y ancla a cada agente en un modelo seguro de identidad y permisos respaldado por Entra.

¿En qué se diferencia el SDK del Agente 365?

El SDK de Agent 365 se diferencia de frameworks de agentes como Microsoft Agent Framework o Microsoft Copilot Studio porque no crea ni aloja agentes. En cambio, mejora los agentes que ya has construido, independientemente de la pila subyacente, añadiendo capacidades empresariales como la identidad de agente basada en Entra, acceso a la herramienta Work IQ gobernada, notificaciones a través del protocolo Activity y gobernanza basada en ID de agente. Utiliza Microsoft OpenTelemetry para la observabilidad.

Aunque es muy similar en nombre, no reemplaza el SDK de agentes de Microsoft 365 y la funcionalidad que proporciona para hospedar, protocolo de actividad e identidad. Al contrario, el SDK del Agente 365 lo complementa superponiendo controles de gobernanza, cumplimiento y ciclo de vida sobre agentes construidos con él u otras plataformas.

SDK del Agente 365 y el ecosistema del agente

Esta tabla resume la arquitectura de agentes en capas, mostrando cómo el SDK de Agent 365 añade capacidades empresariales por encima de la lógica de tu agente y el runtime del orquestador LLM proporcionado por el framework elegido.

Nivel	Role	Proporcionado por
Funcionalidades empresariales	Identidad, notificaciones y herramientas del SDK de Agent 365; observabilidad de Microsoft OpenTelemetry	SDK Agent 365 y Microsoft OpenTelemetry
Lógica del agente	Avisos, flujos de trabajo, razonamiento	Tu implementación en código
Duración del LLM Orchestrator	Invocación de modelos y orquestación de herramientas	SDK/Framework de agente de su elección

Pasos siguientes

Conectar un agente existente con Agent 365