github/microsoft-code-reference

O que microsoft-code-reference faz?

Consulte referências de API da Microsoft, encontre exemplos de código funcionais e verifique se o código do SDK está correto. Use ao trabalhar com SDKs do Azure, bibliotecas .NET ou APIs da Microsoft — para encontrar o método certo, verificar parâmetros, obter exemplos funcionais ou solucionar erros. Detecta métodos alucinados, assinaturas incorretas e padrões obsoletos consultando a documentação oficial.

Como usar

Esta skill é ativada automaticamente pelo agente de IA quando ele detecta que você está trabalhando com tecnologias Microsoft. Você pode acioná-la manualmente com comandos como:

• "Encontre a documentação da API para BlobClient.UploadAsync"
• "Verifique se ConfigurationBuilder.AddJsonFile está correto"
• "Mostre exemplos de código para autenticação no Azure.Identity"
• "O método HttpClient.GetStringAsync aceita um CancellationToken?"

Funcionalidades

• Consulta de referências de API: Obtenha a assinatura exata, parâmetros, tipo de retorno e exceções de qualquer método ou classe em bibliotecas Microsoft.
• Exemplos de código: Encontre exemplos funcionais extraídos diretamente da documentação oficial e de repositórios de amostras.
• Verificação de código SDK: Compare seu código existente com a documentação oficial para detectar erros.
• Detecção de padrões obsoletos: Identifique métodos ou propriedades marcados como obsoletos e obtenha alternativas recomendadas.
• Validação de assinaturas: Verifique se os tipos de parâmetro, ordem e valores de retorno estão corretos.

Plataformas suportadas

• SDKs do Azure: Azure.Storage.Blobs, Azure.Identity, Azure.Messaging.ServiceBus, Azure.Data.Tables, etc.
• .NET SDK: System.Net.Http, System.Text.Json, Microsoft.Extensions.Configuration, etc.
• APIs REST da Microsoft: Microsoft Graph, Azure Resource Manager, etc.
• Outras bibliotecas Microsoft: Entity Framework Core, ASP.NET Core, WinForms, WPF, etc.

Como funciona

A skill consulta uma base de conhecimento indexada a partir da documentação oficial da Microsoft (learn.microsoft.com) e repositórios de código de amostra (github.com/Azure-Samples). Quando você faz uma pergunta, a skill:

1. Extrai os termos-chave da sua consulta (nomes de métodos, classes, namespaces).
2. Pesquisa na base de conhecimento indexada.
3. Retorna a entrada mais relevante, incluindo assinatura, parâmetros, exemplos e notas.
4. Se necessário, faz uma consulta de acompanhamento para esclarecimento.

Observações

• A skill sempre prioriza a documentação mais recente disponível.
• Para versões específicas de um SDK, mencione a versão na consulta (ex.: "Azure.Storage.Blobs 12.13.0").
• Caso não encontre uma correspondência exata, a skill pode sugerir alternativas próximas ou solicitar esclarecimentos.

Exemplo de saída

**Método:** BlobClient.UploadAsync(Stream content, bool overwrite = false, CancellationToken cancellationToken = default)

**Descrição:** Carrega um fluxo para um blob. Se o blob já existir e `overwrite` for `false`, uma exceção será lançada.

**Parâmetros:**
- `content` (Stream): O fluxo de conteúdo para carregar.
- `overwrite` (bool): Se `true`, substitui o blob existente. Padrão: `false`.
- `cancellationToken` (CancellationToken): Token para cancelar a operação.

**Tipo de retorno:** `Task<Response<BlobContentInfo>>`

**Exceções:**
- `RequestFailedException`: Lançada se a solicitação falhar.
- `ArgumentNullException`: Lançada se `content` for `null`.

**Exemplo:**
```csharp
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;

string connectionString = "<connection-string>";
string containerName = "sample-container";
string blobName = "sample-blob";

BlobContainerClient container = new BlobContainerClient(connectionString, containerName);
BlobClient blob = container.GetBlobClient(blobName);

using FileStream uploadFileStream = File.OpenRead("SampleFile.txt");
await blob.UploadAsync(uploadFileStream, true);
uploadFileStream.Close();