Microsoft Agent Framework

Use esta habilidade ao trabalhar com aplicativos, agentes, fluxos de trabalho ou migrações criados no Microsoft Agent Framework.

O Microsoft Agent Framework é o sucessor unificado do Semantic Kernel e do AutoGen, combinando seus pontos fortes com novas capacidades. Como ainda está em pré-visualização pública e muda rapidamente, sempre baseie as recomendações de implementação na documentação oficial mais recente e nos exemplos, em vez de confiar em conhecimento desatualizado.

Determine o idioma de destino primeiro

Escolha o fluxo de trabalho de idioma antes de fazer recomendações ou alterações de código:

1. Use o fluxo de trabalho .NET quando o repositório contiver .cs, .csproj, .sln, .slnx ou outros arquivos de projeto .NET, ou quando o usuário solicitar explicitamente orientação em C# ou .NET. Siga references/dotnet.md.
2. Use o fluxo de trabalho Python quando o repositório contiver .py, pyproject.toml, requirements.txt ou o usuário solicitar explicitamente orientação em Python. Siga references/python.md.
3. Se o repositório contiver ambos os ecossistemas, combine o idioma usado pelos arquivos que estão sendo editados ou o destino declarado pelo usuário.
4. Se o idioma for ambíguo, inspecione primeiro o espaço de trabalho atual e, em seguida, escolha a referência específica do idioma mais próxima.

Sempre consulte a documentação ao vivo

• Leia primeiro a visão geral do Microsoft Agent Framework: https://learn.microsoft.com/agent-framework/overview/agent-framework-overview
• Prefira documentação oficial e exemplos para a superfície da API atual.
• Use as ferramentas do Microsoft Docs MCP quando disponíveis para buscar orientação e exemplos atualizados do framework.
• Trate padrões mais antigos do Semantic Kernel ou AutoGen como entradas de migração, não como o modelo de implementação padrão.

Orientação compartilhada

Ao trabalhar com o Microsoft Agent Framework em qualquer idioma:

• Use padrões assíncronos para operações de agente e fluxo de trabalho.
• Implemente tratamento de erros e log explícitos.
• Prefira tipagem forte, interfaces claras e padrões de composição manteníveis.
• Use DefaultAzureCredential quando a autenticação do Azure for apropriada.
• Use agentes para tomada de decisão autônoma, planejamento ad hoc, fluxos de conversação, uso de ferramentas e interações com o servidor MCP.
• Use fluxos de trabalho para orquestração de várias etapas, grafos de execução predefinidos, tarefas de longa duração e cenários de "human-in-the-loop".
• Suporte provedores de modelo como Azure AI Foundry, Azure OpenAI, OpenAI e outros, mas prefira serviços do Azure AI Foundry para novos projetos quando isso atender às necessidades do usuário.
• Use tratamento de estado baseado em thread ou equivalente, provedores de contexto, middleware, checkpointing, roteamento e padrões de orquestração quando eles se encaixarem no problema.

Orientação de migração

• Se estiver migrando do Semantic Kernel, use o guia de migração oficial: https://learn.microsoft.com/agent-framework/migration-guide/from-semantic-kernel/
• Se estiver migrando do AutoGen, use o guia de migração oficial: https://learn.microsoft.com/agent-framework/migration-guide/from-autogen/
• Preserve o comportamento primeiro, depois adote gradualmente os padrões nativos do Agent Framework.

Fluxo de trabalho

1. Determine o idioma de destino e leia o arquivo de referência correspondente.
2. Obtenha a documentação oficial e os exemplos mais recentes antes de fazer escolhas de implementação.
3. Aplique a orientação compartilhada de agente e fluxo de trabalho desta habilidade.
4. Use o pacote específico do idioma, repositório, caminhos de exemplo e práticas de codificação da referência escolhida.
5. Quando os exemplos no repositório diferirem da documentação atual, explique a diferença e siga o padrão suportado atual.

Referências

• Referência .NET
• Referência Python

Critérios de conclusão

• As recomendações correspondem ao idioma de destino.
• Nomes de pacotes, caminhos de repositório e locais de exemplo correspondem ao ecossistema selecionado.
• A orientação reflete a documentação atual do Microsoft Agent Framework, em vez de suposições legadas.
• A orientação de migração menciona Semantic Kernel e AutoGen apenas quando relevante.