Trabalhando com extensões do canvas no aplicativo GitHub Copilot

** Copilot Business, Copilot Enterprise, Copilot Pro e Copilot Pro+ usuários** — Baixe e instale do aplicativo GitHub Copilot repositório. Para Copilot Business e Copilot Enterprise, sua organização ou empresa deve habilitar recursos de visualização e CLI do Copilot.

* ** Copilot Gratuito usuários e usuários sem um Copilot plano** – Para solicitar acesso, ingresse na lista de espera.

Sobre extensões de tela

Uma extensão de tela é uma superfície compartilhada e interativa para um artefato de trabalho, como um plano, placa de triagem, sessão do navegador, lista de verificação de versão, painel, incidente ou planilha.

Embora o chat seja útil para definir a intenção e discutir tarefas, a maioria dos trabalhos ocorre em superfícies de trabalho, como um terminal, um navegador, um documento ou um painel. As telas permitem que você colabore com o agente diretamente nessas superfícies de trabalho.

As telas são bidirecionais: o agente pode atualizar a tela enquanto ela funciona e você pode editar nessa mesma superfície. Quando você cria um canvas, o agente gera capacidades com base no seu prompt e fluxo de trabalho. À medida que você itera, você pode pedir que ele adicione, remova ou revise esses recursos. Depois de criados, os canvases são abertos no painel lateral direito do aplicativo.

Por exemplo, você pode criar um quadro kanban com agente, em que as pessoas usam controles da interface do usuário para criar ou mover cartões, e pedir ao agente que adicione recursos que o agente pode chamar, como get_board, add_card e move_card. Isso permite que pessoas e agentes coordenem o trabalho em um quadro compartilhado.

Por que usar uma tela

As telas são úteis quando uma tarefa ou fluxo de trabalho precisa de estrutura, iteração e verificação, e um chat não é suficiente. Você pode usar o chat para instruir o agente e raciocinar diante de ambiguidades e, em seguida, usar o canvas para inspecionar, direcionar e verificar diretamente o trabalho visível, sem precisar depender apenas de prompts.

As telas fornecem dois tipos de valor: elas melhoram a parceria entre agentes humanos, dando a ambos os lados uma superfície compartilhada para trabalhar e permitem personalizar essa superfície para corresponder ao fluxo de trabalho.

As telas são úteis quando você precisa:

• Baseie o trabalho do agente em um artefato ou ambiente real que se adapte ao seu fluxo de trabalho.
• Direcione ou corrija o trabalho diretamente na superfície compartilhada e, em seguida, deixe o agente continuar com essas alterações.
• Inspecione o progresso e os resultados como alterações visíveis em um artefato compartilhado, não apenas respostas de chat.
• Mantenha o trabalho contínuo entre turnos, sessões e entregas.

Exemplos de casos de uso

As extensões do Canvas podem ser personalizadas para atender às suas necessidades ou às da sua equipe em diversos cenários. Por exemplo:

• Quadros kanban baseados em agentes: Permita que humanos e agentes adicionem cards, movam o trabalho adiante e iniciem tarefas.
• Emitir painéis de triagem: Resumir os principais problemas, temas recorrentes e pontos de dor do usuário para um repositório.
• Canvases de Markdown: Crie um arquivo Markdown persistente para planejar seu dia, priorizar problemas e pull requests, iniciar e monitorar sessões de agente e manter todo o trabalho relacionado em uma única superfície editável.
• Telas de documento: Abra, edite e colabore em documentos, planilhas, slides e outros artefatos diretamente no aplicativo.

Criando uma tela

Você pode criar uma nova tela em uma sessão usando a habilidade /create-canvas.

1. Abra ou inicie uma sessão de agente.

2. Na caixa de prompt, digite /create-canvas e, em seguida, descreva o fluxo de trabalho e as funcionalidades para os quais você deseja que a área de trabalho ofereça suporte, incluindo o que as pessoas devem ser capazes de fazer e o que o agente deve ser capaz de fazer. Por exemplo, você pode pedir ao agente para:

   • Create an agentic kanban canvas with actions to create, assign, and move cards.
   • Create a markdown canvas that combines my meetings with prioritized issues and pull requests, then lets me launch and track agent sessions from that canvas.

3. Você pode escolher se o canvas deve ser compartilhado com sua equipe ou mantido como pessoal:

   • Escopo do projeto:.github/extensions para canvases compartilhados pela equipe versionados no repositório.
   • Escopo do usuário:~/.copilot/extensions para telas pessoais em seu computador.

O agente criará a tela e a abrirá no painel lateral direito após a conclusão. Depois disso, você pode continuar iterando solicitando ao agente que altere a interface, o estado compartilhado e os recursos.

Como as extensões de tela são estruturadas

Cada extensão de tela reside em seu próprio diretório em .github/extensions (escopo do projeto) ou ~/.copilot/extensions (escopo do usuário).

Embora as implementações possam variar, uma extensão de tela geralmente inclui:

• Um arquivo package.json para os metadados e as dependências de uma extensão.
• Um arquivo de entrada de extensão, como extension.mjs, que define o comportamento e os recursos da tela.
• Artefatos JSON opcionais (por exemplo, arquivos em um artifacts diretório) para dados e estado de tela persistentes.

Quando um canvas é aberto no painel lateral do app, tanto as pessoas quanto os agentes interagem com esse mesmo estado compartilhado por meio de ações na interface do usuário e de capacidades que os agentes podem chamar.

Trabalhando em uma tela

Quando o canvas estiver aberto, você poderá fazer iterações rapidamente com o agente.

• Adicione ou revise as funcionalidades da tela de desenho.
• Use controles de canvas (como botões, cartões ou filtros) para atualizar diretamente a área.
• Peça ao agente para chamar os recursos expostos pela tela para atualizar dados ou executar ações.

Leitura adicional

• Trabalhando com sessões de agente no GitHub aplicativo Copilot.
• Personalizando a aplicativo Copilot do GitHub.