Habilidades Microsoft 365 Agents SDK (Python)
📦

Microsoft 365 Agents SDK (Python)

Seguro 🔑 Variables de entorno

Construir Agentes de IA para Microsoft 365 con Python

Las organizaciones necesitan agentes de IA que se integren perfectamente con Microsoft 365. Esta habilidad proporciona patrones listos para producción para construir bots de Teams y agentes de Copilot Studio usando el SDK oficial de Microsoft Agents.

Soporta: Claude Codex Code(CC)
📊 70 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "Microsoft 365 Agents SDK (Python)". Configurar un bot básico de Teams que haga eco de los mensajes del usuario

Resultado esperado:

  • Agent application initialized with aiohttp CloudAdapter
  • Message handler registered for activity type: message
  • Conversation update handler registered for: membersAdded
  • Server running on localhost:3978 with JWT authorization middleware

Usando "Microsoft 365 Agents SDK (Python)". Agregar autenticación OAuth para acceso a Microsoft Graph

Resultado esperado:

  • MsalConnectionManager configured with Azure AD settings
  • Auth handler 'GRAPH' registered for protected routes
  • Token acquisition flow ready for interactive or silent auth
  • Protected endpoint /me returns user profile with Bearer token

Auditoría de seguridad

Seguro
v1 • 2/25/2026

This is a prompt-only instructional skill that provides code examples for building Microsoft 365 agents. Static analysis detected no security issues. The skill contains legitimate SDK usage patterns for aiohttp hosting, MSAL authentication, and Copilot Studio integration. Environment variable usage follows security best practices.

0
Archivos escaneados
0
Líneas analizadas
1
hallazgos
1
Auditorías totales

Factores de riesgo

🔑 Variables de entorno (1)
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
34
Comunidad
100
Seguridad
74
Cumplimiento de la especificación

Lo que puedes crear

Desarrollo de Bots de Teams Empresarial

Construir bots internos de empresa para Teams que manejen consultas de RRHH, tickets de soporte de TI o flujos de incorporación con integración de Graph API.

Integración de Agentes de Copilot Studio

Crear agentes de IA personalizados que se conecten a motores de Copilot Studio para conocimiento de dominio especializado y acceso a datos empresariales.

Despliegue de Agentes Multi-Canal

Desplegar una única aplicación de agente que sirva a múltiples canales incluyendo Teams, chat web y clientes personalizados a través de enrutamiento estandarizado.

Prueba estos prompts

Configuración Básica del Agente
Crear un agente de Microsoft 365 con alojamiento aiohttp que responda a mensajes de 'hola' y 'ayuda'. Incluir manejadores básicos de actualización de conversación y manejo de errores.
Manejador de Mensajes Protegido con OAuth
Agregar una ruta protegida con autenticación que recupere el perfil de Microsoft Graph del usuario y muestre su nombre. Usar el administrador de conexiones de MSAL para adquisición de tokens.
Respuesta de Streaming con Azure OpenAI
Implementar un manejador de respuestas de streaming que use Azure OpenAI para generar contenido creativo. Incluir etiquetas de sensibilidad y configuración de bucle de retroalimentación.
Integración de Cliente de Copilot Studio
Crear un script independiente que se conecte a Copilot Studio usando el SDK del cliente. Incluir adquisición de tokens y gestión de conversaciones.

Mejores prácticas

  • Usar MemoryStorage solo para desarrollo. Cambiar a BlobStorage o CosmosDB para despliegues en producción para asegurar la persistencia de datos.
  • Mantener todos los secretos en variables de entorno usando dotenv. Nunca confirmar credenciales en el control de versiones.
  • Llamar a end_stream() en bloques finally al implementar respuestas de streaming para asegurar una limpieza adecuada de la conexión.

Evitar

  • No usar la sintaxis de importación antigua de microsoft.agents. Siempre usar microsoft_agents con guiones bajos para las versiones actuales del SDK.
  • Evitar codificar IDs de cliente, secretos o IDs de tenant directamente en el código fuente. Usar exclusivamente variables de entorno.
  • No omitir el middleware de autorización JWT en producción. Siempre incluir jwt_authorization_middleware en la configuración de Application de aiohttp.

Preguntas frecuentes

¿Qué versión de Python se requiere para el SDK de Microsoft Agents?
El SDK de Microsoft Agents para Python requiere Python 3.8 o superior. Se recomienda Python 3.10+ para la mejor compatibilidad con todas las características.
¿Cómo registro mi aplicación de agente en Azure AD?
Ve a Azure Portal > Azure Active Directory > Registros de aplicaciones. Crea un nuevo registro, anota el ID de aplicación (cliente) y el ID de tenant. Agrega URIs de redirección para los endpoints de tu agente.
¿Puedo usar esta habilidad solo con Microsoft Teams?
Sí. Aunque el SDK soporta múltiples canales, puedes configurar tu agente específicamente para Teams configurando los manejadores de actividad apropiados y middleware específico de Teams.
¿Cuál es la diferencia entre AgentApplication y CloudAdapter?
CloudAdapter maneja los ciclos de solicitud/respuesta HTTP y el enrutamiento de mensajes. AgentApplication gestiona el estado de la conversación, los manejadores de mensajes y la lógica a nivel de aplicación. Trabajan juntos en el pipeline de alojamiento.
¿Cómo habilito las respuestas de streaming en mi agente?
Usa los métodos de streaming_response del contexto: set_feedback_loop(True), set_generated_by_ai_label(True), queue_text_chunk() para actualizaciones incrementales, y end_stream() para finalizar.
¿Es esta habilidad compatible con Claude, Codex y Claude Code?
Sí, esta habilidad está diseñada para usar con Claude, Codex y Claude Code. Todas las plantillas de prompt y ejemplos de código funcionan en estas plataformas de asistente de IA.

Detalles del desarrollador

Estructura de archivos

📄 SKILL.md