Habilidades Microsoft 365 Agents SDK (Python)
📦

Microsoft 365 Agents SDK (Python)

Seguro 🔑 Variáveis de ambiente

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.

Suporta: Claude Codex Code(CC)
📊 69 Adequado
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "Microsoft 365 Agents SDK (Python)". Configurar um bot básico do Teams que ecoa mensagens do usuário

Resultado esperado:

  • 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

A utilizar "Microsoft 365 Agents SDK (Python)". Adicionar autenticação OAuth para acesso ao Microsoft Graph

Resultado esperado:

  • 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

Auditoria de Segurança

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
Arquivos analisados
0
Linhas analisadas
1
achados
1
Total de auditorias

Fatores de risco

🔑 Variáveis de ambiente (1)
Auditado por: claude

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
87
Conteúdo
33
Comunidade
100
Segurança
74
Conformidade com especificações

O Que Você Pode Construir

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.

Tente Estes Prompts

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.

Melhores Práticas

  • 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.

Evitar

  • 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.

Perguntas Frequentes

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.

Detalhes do Desenvolvedor

Estrutura de arquivos

📄 SKILL.md