Awesome CopilotAdventures

Documentação do produto verificada

Examine as configurações do Copilot e os limites de interação

Não memorize a posição de um botão. Aprenda qual controle altera o papel, qual altera o runtime e qual altera a permissão para agir.

Resumo do laboratório

Um pequeno módulo de tarefa fica em uma bancada com bandejas de contexto separadas e um controle de permissões.

Ilustração conceitual original (SVG)

Faça uma saudação remover espaços em branco sem enfraquecer erros de entrada.

Em resumo Sua rota
Nível e tempo 100; 35 minutos (estimativa de facilitação)
Ação inicial Execute os dois testes originais antes de pedir ao Copilot para alterar a função.
Materiais do aluno Baixe 01-interface.zip
Workspace Abra a raiz do kit extraído; execute a baseline de . relativa a essa raiz
Verificação inicial esperada Os testes base fornecidos passam.
Ajuda de configuração Baixe, extraia, Git local e GitHub opcional

[!NOTE] Aprovar uma resposta não é o mesmo que revisar uma mudança.

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

Objetivos de aprendizagem

  • Identifique papel, harness/destino, modelo, contexto e permissões de forma independente.
  • Compare explicação, projeto, implementação e sugestões inline.
  • Valide uma pequena alteração sem ampliar a autoridade.

Antes de começar

Conclua a configuração do Copilot e leia a referência de conceitos. Prepare 01-interface usando o procedimento da unidade de trabalho. A pequena fixture em Node não exige instalação de pacotes.

Conceitos e casos de uso

Interação Uso adequado Não comprova
Ask Rastrear comportamento e explicar código Correção de uma implementação gerada
Plan Definir uma alteração segura e verificações Que arquivos foram alterados
Agent Implementar com ferramentas permitidas Que todo comando exige aprovação manual
Conclusão inline/NES Aceitar ou rejeitar uma sugestão local durante a edição Uma refatoração completa do repositório
Renomeação semântica Renomear um símbolo em todas as referências Uma alteração em seu comportamento em tempo de execução

A aprovação de ferramentas depende da sua política, não de uma captura de tela mostrar um botão Continue. Só aprove um comando depois de ler seu destino, efeitos colaterais e escopo.

Cenário do exercício

A fixture formata uma breve mensagem de boas-vindas. A alteração solicitada é remover os espaços nas extremidades de um nome antes de formatá-lo, mantendo o erro existente para nome vazio.

Tarefa 1 - Estabeleça o comportamento inicial

  1. Abra o workspace preparado e inspecione greeting.mjs e greeting.test.mjs.

  2. Execute:

    node --test --test-concurrency=1 greeting.test.mjs
    
  3. Registre a saída e o status de saída. Um runtime ausente é uma falha do ambiente, não um teste da implementação da saudação.

  4. Inspecione destino da sessão, papel, modelo e ferramentas permitidas. Mantenha servidores MCP e sessões em segundo plano sem relação com a tarefa fora deste exercício.

Tarefa 2 - Explique com e sem contexto explícito

  1. Em Ask, solicite:

    Explain how a blank name is handled. Do not edit or run commands.
    Cite the file and branch that support your answer.
    
  2. Registre se o agente recuperou arquivos por conta própria ou não tinha evidências. Não presuma que remover um anexo torna o arquivo inacessível.

  3. Anexe greeting.mjs explicitamente e repita. Compare a correção e as evidências citadas, não o tamanho da resposta nem a confiança.

  4. Confirme que a solicitação do exercício não alterou arquivos.

Tarefa 3 - Planeje uma pequena alteração de limite com risco

  1. Selecione Plan em uma sessão com suporte.

  2. Envie:

    Trim the name before producing the greeting, without changing the error
    for blank or non-string input. Identify whitespace and wrong-type cases,
    affected files, the test command, and a one-change rollback plan. Do not edit.
    
  3. Questione qualquer caso ausente: " Ada ", "", " ", null e um número.

  4. Aprove somente o plano delimitado. Plan é útil mesmo para uma alteração de duas linhas.

Tarefa 4 - Implemente e inspecione

  1. Entregue o plano revisado a Agent.
  2. Permita somente alterações na implementação da saudação e em seus testes.
  3. Revise o diff antes de aceitá-lo. Enfraquecer testes não é uma correção aceitável.
  4. Execute pessoalmente o mesmo comando de teste e adicione o caso de espaços em branco ausente, se ainda não estiver coberto.
  5. Altere deliberadamente uma asserção esperada, verifique um resultado diferente de zero e restaure essa asserção. Isso comprova que o teste consegue rejeitar comportamento incorreto.

Tarefa 5 - Compare a assistência inline

  1. Em um arquivo experimental separado, comece a escrever uma função de saudação semelhante.
  2. Se houver sugestões inline disponíveis, aceite uma e rejeite outra. Se nenhuma aparecer, registre isso; não invente uma sugestão.
  3. Compare uma renomeação manual de símbolo com sugestões da próxima edição.
  4. Restaure qualquer preferência específica da linguagem que tenha alterado. Não modifique configurações de privacidade da conta inteira nem URLs avançadas não documentadas de mecanismos neste laboratório.

Verifique seu trabalho

  • As saídas dos testes da linha de base e após a alteração estão registradas.
  • Uma asserção negativa produz saída diferente de zero.
  • Papel, destino/harness, ambiente, modelo e permissões não são confundidos.
  • As evidências de Ask/Plan estão separadas do diff de Agent.
  • Nenhuma alteração de configuração afeta outros workspaces.

Solução de problemas

Use os nomes da Paleta de Comandos em vez das coordenadas de capturas de tela. Para contexto ausente, inspecione referências e permissões. Para um destino ausente, verifique a política e o suporte atual do cliente. Capturas antigas de Ask/Edit são históricas, não o currículo atual.

Prática independente

Repita a alteração usando outro harness disponível. Compare a lista real de ferramentas, a descoberta de instruções e a saída da validação. Não alegue ganho de velocidade com base em uma única tentativa.

Restauração

Restaure somente os dois arquivos do exercício a partir da linha de base descartável, feche o arquivo experimental e inicie uma sessão nova. Mantenha todos os arquivos originais do repositório intactos.

Referências oficiais

Buscar

Busca em português do Brasil. Os caminhos e os exemplos executáveis mantêm o texto original.