技能 Microsoft 365 Agents SDK (Python)
📦

Microsoft 365 Agents SDK (Python)

安全 🔑 环境变量

Construir Agentes de IA para Microsoft 365 com Python

As organizações precisam de agentes de IA que se integrem perfeitamente com o Microsoft 365. Esta habilidade fornece padrões de produção prontos para usar para construir bots do Teams e agentes do Copilot Studio usando o SDK oficial de Agentes da Microsoft.

支持: Claude Codex Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“Microsoft 365 Agents SDK (Python)”。 Configurar um bot básico do Teams que ecoa mensagens do usuário

预期结果:

  • Aplicação de agente inicializada com CloudAdapter aiohttp
  • Manipulador de mensagens registrado para tipo de atividade: mensagem
  • Manipulador de atualização de conversa registrado para: membersAdded
  • Servidor executando em localhost:3978 com middleware de autorização JWT

正在使用“Microsoft 365 Agents SDK (Python)”。 Adicionar autenticação OAuth para acesso ao Microsoft Graph

预期结果:

  • MsalConnectionManager configurado com configurações do Azure AD
  • Manipulador de auth 'GRAPH' registrado para rotas protegidas
  • Fluxo de aquisição de token pronto para auth interativa ou silenciosa
  • Endpoint protegido /me retorna perfil do usuário com token Bearer

安全审计

安全
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
已扫描文件
0
分析行数
1
发现项
1
审计总数

风险因素

🔑 环境变量 (1)
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
74
规范符合性

你能构建什么

Desenvolvimento de Bot do Teams Empresarial

Construa bots internos para o Teams que lidam com consultas de RH, tickets de suporte de TI ou fluxos de trabalho de integração com integração da Graph API.

Integração de Agente do Copilot Studio

Crie agentes de IA personalizados que se conectam aos mecanismos do Copilot Studio para conhecimento de domínio especializado e acesso a dados empresariais.

Implantação de Agente Multi-Canal

Implanta uma única aplicação de agente que atende vários canais incluindo Teams, chat web e clientes personalizados através de roteamento padronizado.

试试这些提示

Configuração Básica do Agente
Crie um agente Microsoft 365 com hospedagem aiohttp que responda às mensagens 'hello' e 'help'. Inclua manipuladores básicos de atualização de conversa e tratamento de erros.
Manipulador de Mensagens Protegido por OAuth
Adicione uma rota protegida que recupera o perfil do Microsoft Graph do usuário e exibe seu nome. Use o gerenciador de conexão MSAL para aquisição de token.
Resposta de Streaming com Azure OpenAI
Implemente um manipulador de resposta de streaming que usa Azure OpenAI para gerar conteúdo criativo. Inclua rótulos de sensibilidade e configuração de loop de feedback.
Integração de Cliente do Copilot Studio
Crie um script autônomo que se conecte ao Copilot Studio usando o SDK do cliente. Inclua aquisição de token e gerenciamento de conversa.

最佳实践

  • Sempre use MemoryStorage apenas para desenvolvimento. Alterne para BlobStorage ou CosmosDB para implantações de produção para garantir persistência de dados.
  • Mantenha todos os segredos em variáveis de ambiente usando dotenv. Nunca comprometa credenciais no controle de código-fonte.
  • Chame end_stream() em blocos finally ao implementar respostas de streaming para garantir limpeza adequada da conexão.

避免

  • Não use a sintaxe de importação antiga do microsoft.agents. Sempre use microsoft_agents com sublinhados para versões atuais do SDK.
  • Evite codificar client IDs, segredos ou tenant IDs diretamente no código-fonte. Use exclusivamente variáveis de ambiente.
  • Não pule o middleware de autorização JWT em produção. Sempre inclua jwt_authorization_middleware na configuração do Application aiohttp.

常见问题

Qual versão do Python é necessária para o SDK de Agentes da Microsoft?
O SDK de Agentes da Microsoft para Python requer Python 3.8 ou superior. Python 3.10+ é recomendado para melhor compatibilidade com todos os recursos.
Como registro meu aplicativo de agente no Azure AD?
Vá para Azure Portal > Azure Active Directory > Registros de aplicativos. Crie um novo registro, anote o ID do Aplicativo (cliente) e o ID do locatário. Adicione URIs de redirecionamento para seus endpoints de agente.
Posso usar esta habilidade apenas com o Microsoft Teams?
Sim. Embora o SDK suporte vários canais, você pode configurar seu agente especificamente para o Teams definindo os manipuladores de atividade apropriados e o middleware específico do Teams.
Qual é a diferença entre AgentApplication e CloudAdapter?
CloudAdapter manipula ciclos de requisição/resposta HTTP e roteamento de mensagens. AgentApplication gerencia estado da conversa, manipuladores de mensagens e lógica de nível de aplicativo. Eles trabalham juntos no pipeline de hospedagem.
Como habilito respostas de streaming no meu agente?
Use métodos context.streaming_response: set_feedback_loop(True), set_generated_by_ai_label(True), queue_text_chunk() para atualizações incrementais, e end_stream() para finalizar.
Esta habilidade é compatível com Claude, Codex e Claude Code?
Sim, esta habilidade foi projetada para uso com Claude, Codex e Claude Code. Todos os modelos de prompt e exemplos de código funcionam nessas plataformas de assistente de IA.

开发者详情

文件结构

📄 SKILL.md