Referência de Código da Microsoft

Ferramentas

Encontrando Exemplos de Código

Use microsoft_code_sample_search para obter exemplos oficiais e funcionais:

microsoft_code_sample_search(query: "upload file to blob storage", language: "csharp")
microsoft_code_sample_search(query: "authenticate with managed identity", language: "python")
microsoft_code_sample_search(query: "send message service bus", language: "javascript")

Quando usar:

• Antes de escrever código — encontre um padrão funcional para seguir
• Após erros — compare seu código com um exemplo conhecido e correto
• Inseguro sobre inicialização/configuração — exemplos mostram o contexto completo

Buscas de API

# Verify method exists (include namespace for precision)
"BlobClient UploadAsync Azure.Storage.Blobs"
"GraphServiceClient Users Microsoft.Graph"

# Find class/interface
"DefaultAzureCredential class Azure.Identity"

# Find correct package
"Azure Blob Storage NuGet package"
"azure-storage-blob pip package"

Busque a página completa quando o método tiver várias sobrecargas ou você precisar de detalhes completos dos parâmetros.

Solução de Problemas de Erros

Use microsoft_code_sample_search para encontrar exemplos de código funcionais e comparar com sua implementação. Para erros específicos, use microsoft_docs_search e microsoft_docs_fetch:

Quando Verificar

Sempre verifique quando:

• O nome do método parece "muito conveniente" (UploadFile vs. Upload real)
• Misturando versões de SDK (v11 CloudBlobClient vs. v12 BlobServiceClient)
• Nome do pacote não segue convenções (Azure.* para .NET, azure-* para Python)
• Usando uma API pela primeira vez

Fluxo de Validação

Antes de gerar código usando SDKs da Microsoft, verifique se ele está correto:

1. Confirme se o método ou pacote existe — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
2. Busque detalhes completos (para sobrecargas/parâmetros complexos) — microsoft_docs_fetch(url: "...")
3. Encontre um exemplo funcional — microsoft_code_sample_search(query: "[task]", language: "[lang]")

Para buscas simples, apenas o passo 1 pode ser suficiente. Para uso complexo de API, complete todos os três passos.

Alternativa CLI

Se o servidor Learn MCP não estiver disponível, use a CLI mslearn de um terminal ou shell (por exemplo, Bash, PowerShell ou cmd) em vez disso:

# Run directly (no install needed)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"

Passe --json para search ou code-search para obter a saída JSON bruta para processamento posterior.