Semantic Kernel

Use esta habilidade ao trabalhar com aplicativos, plugins, fluxos de chamada de função ou integrações de IA criadas no Semantic Kernel.

Sempre baseie os conselhos de implementação na documentação e nos exemplos mais recentes do Semantic Kernel, em vez de apenas na memória.

Determine primeiro o idioma de destino

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

Consulte sempre a documentação ao vivo

• Leia primeiro a visão geral do Semantic Kernel: https://learn.microsoft.com/semantic-kernel/overview/
• Prefira a documentação oficial e os 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.

Orientação compartilhada

Ao trabalhar com o Semantic Kernel em qualquer idioma:

• Use padrões assíncronos para operações do kernel.
• Siga os padrões oficiais de plugins e chamadas de função.
• Implemente tratamento explícito de erros e registro em log.
• Prefira tipagem forte, abstrações claras e padrões de composição de fácil manutenção.
• Use conectores integrados para Azure AI Foundry, Azure OpenAI, OpenAI e outros serviços de IA, preferindo os serviços do Azure AI Foundry para novos projetos quando isso se adequar à tarefa.
• Use a memória e os recursos de gerenciamento de contexto do kernel quando eles simplificarem a solução.
• Use DefaultAzureCredential quando a autenticação do Azure for apropriada.

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 do Semantic Kernel desta habilidade.
4. Use o pacote específico do idioma, o repositório, os caminhos de exemplo e as 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.
• Os nomes dos pacotes, os caminhos do repositório e os locais dos exemplos correspondem ao ecossistema selecionado.
• A orientação reflete a documentação atual do Semantic Kernel, em vez de suposições desatualizadas.