Configure o ambiente do laboratório de Copilot SDK

O Copilot SDK incorpora um runtime de agente na sua aplicação. Não é uma biblioteca para enviar sugestões de conclusão de código ao editor VS Code. Identidade da aplicação, ferramentas, permissões e ciclo de vida são sua responsabilidade.

Resumo do laboratório

[!NOTE] O acesso do editor e a autenticação do runtime do SDK são fronteiras separadas.

Conceitos · Primeira tarefa · Lista de evidências · Redefinir

Objetivos de aprendizagem

• Prepare testes locais sem invocar um modelo.
• Identifique as versões do runtime/pacote para a linguagem selecionada.
• Separe a autenticação do VS Code, da CLI e da aplicação.

Antes de começar

Use a configuração da unidade de trabalho e habilite o Copilot. O exercício integrado usa Node 24. Uma adaptação para .NET é opcional; LocalDB, SQL Server, Blazor, recursos de nuvem e migrações de banco de dados não são necessários.

Conceitos e casos de uso

Cenário do exercício

Você vai preparar um pequeno assistente de suporte. Ele pode ler apenas registros sintéticos de status de pedidos pertencentes ao ator de fixture confiável. Ele não deve executar comandos de shell, ler arquivos arbitrários, fazer compras ou fingir que uma ferramenta com falha teve sucesso.

Tarefa 1 - Prepare a fixture selecionada

1. A partir da raiz do currículo:

   node scripts/prepare-hands-on.js --lab 16-sdk --destination /Volumes/T9/Dev/oss/workshop-runs/16-sdk
   

2. Abra o diretório impresso como raiz do workspace.

3. Inspecione seu README, o manifesto de pacotes, o limite da aplicação e os testes.

4. Execute o comando offline documentado ali antes de instalar o pacote opcional do SDK. Registre os testes descobertos e seu código de saída.

5. Não instale pacotes globalmente para resolver um erro local de importação.

Tarefa 2 - Planeje uma execução real do SDK

1. Leia as páginas oficiais de configuração e autenticação do SDK vinculadas abaixo.
2. Registre a versão do pacote declarada pela fixture; não a substitua silenciosamente por latest ou por outro SDK.
3. Se escolher o exercício real opcional, instale esse pacote na cópia descartável, usando o cache da unidade de trabalho.
4. Verifique a autenticação pelo fluxo documentado da CLI/SDK. Na CLI interativa, inicie copilot e use /login quando solicitado; registre somente sucesso/falha.
5. Confirme os modelos disponíveis em vez de presumir um modelo mostrado em uma captura de tela.
6. Revise o manipulador de permissões antes de fazer uma solicitação. Não use aprovação irrestrita para fazer um exemplo parecer funcional.

Ponto de verificação: indique se você validou a lógica offline da aplicação, a inicialização do SDK, a autenticação ou a inferência real. São quatro resultados diferentes.

Verifique seu trabalho

• Os testes offline podem ser executados sem credenciais ou rede.
• Dependências e logs ficam no workspace descartável/na unidade de trabalho.
• Os dados e as operações permitidos da aplicação são explícitos.
• O acesso real, se tentado, usa a conta pretendida e registra falhas.
• Nenhuma chave de API ou token de acesso aparece em arquivo, prompt, captura de tela ou commit.

Solução de problemas

Prática independente

Projete o mesmo limite para .NET: tempo de vida da sessão, cancelamento, argumentos de ferramentas, decisões de permissão e propagação de erros. Registre as diferenças em relação à API do Node; não alegue que as assinaturas da API de uma linguagem são portáveis.

Restauração

Pare a aplicação em seu próprio terminal, feche sua sessão e revogue quaisquer credenciais exclusivas do exercício. Mantenha o currículo original intacto. Remova a cópia descartável somente após salvar evidências com informações sensíveis ocultadas.

Referências oficiais

• Primeiros passos com o Copilot SDK
• Configuração do SDK
• Autenticação do SDK
• Instalar o Copilot CLI