{"meta":{"title":"Trabalhando com extensões do canvas no aplicativo GitHub Copilot","intro":"Use telas no GitHub Copilot app para criar artefatos e interfaces compartilhados orientados por agentes para a colaboração entre humanos e agentes.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/pt/enterprise-cloud@latest/copilot/how-tos","title":"Instruções"},{"href":"/pt/enterprise-cloud@latest/copilot/how-tos/github-copilot-app","title":"GitHub Copilot app"},{"href":"/pt/enterprise-cloud@latest/copilot/how-tos/github-copilot-app/working-with-canvas-extensions","title":"Extensões do Canvas"}],"documentType":"article"},"body":"# Trabalhando com extensões do canvas no aplicativo GitHub Copilot\n\nUse telas no GitHub Copilot app para criar artefatos e interfaces compartilhados orientados por agentes para a colaboração entre humanos e agentes.\n\n## Sobre extensões de tela\n\nUma 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.\n\nUma extensão de tela pode ser incluída em um plug-in junto com outros recursos, como habilidades ou servidores MCP.\n\nEmbora 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.\n\nAs 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.\n\nPor 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.\n\n## Por que usar uma tela\n\nAs 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.\n\nAs 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.\n\nAs telas são úteis quando você precisa:\n\n* Baseie o trabalho do agente em um artefato ou ambiente real que se adapte ao seu fluxo de trabalho.\n* Direcione ou corrija o trabalho diretamente na superfície compartilhada e, em seguida, deixe o agente continuar com essas alterações.\n* Inspecione o progresso e os resultados como alterações visíveis em um artefato compartilhado, não apenas respostas de chat.\n* Mantenha o trabalho contínuo entre turnos, sessões e entregas.\n\n## Exemplos de casos de uso\n\nAs extensões do Canvas podem ser personalizadas para atender às suas necessidades ou às da sua equipe em diversos cenários. Por exemplo:\n\n* **Quadros kanban baseados em agentes:** permita que humanos e agentes adicionem cards, movam o trabalho adiante e iniciem tarefas.\n* **Emitir painéis de triagem:** Resumir os principais problemas, temas recorrentes e pontos de dor do usuário para um repositório.\n* **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.\n* **Telas de documento:** Abra, edite e colabore em documentos, planilhas, slides e outros artefatos diretamente no aplicativo.\n\n## Descobrindo telas\n\nA visualização **Canvas** fornece uma seleção de canvases em destaque. Algumas telas são entregues por meio de plug-ins, que você deve instalar antes de poder usar a tela em uma sessão. Por exemplo, a instalação do plug-in do Azure DevOps dá acesso a uma área de trabalho para planejar e gerenciar o trabalho no Azure DevOps.\n\n1. Na barra lateral do aplicativo, clique em **Personalizar**.\n2. Clique em **Canvas**.\n3. Navegue pelas telas em destaque.\n4. Se uma tela exigir um plug-in, clique **em Instalar plug-in**.\n5. Clique em **Nova sessão** para abrir uma sessão com a área de desenho.\n\nVocê também pode clicar **em Instalado** para exibir todas as personalizações instaladas, incluindo as telas disponíveis para uso.\n\n## Criando uma tela\n\nVocê pode criar uma nova tela em uma sessão usando a habilidade `/create-canvas`.\n\n1. Abra ou inicie uma sessão de agente.\n2. 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.\n   Por exemplo, você pode pedir ao agente para:\n\n   * `Create an agentic kanban canvas with actions to create, assign, and move cards.`\n   * `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.`\n3. Você pode escolher se o canvas deve ser compartilhado com sua equipe ou mantido como pessoal:\n   * **Escopo do projeto:**`.github/extensions` para canvases compartilhados pela equipe com controle de versão no repositório.\n   * **Escopo do usuário:**`~/.copilot/extensions` para telas pessoais em seu computador.\n\nO 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.\n\n## Como as extensões de tela são estruturadas\n\nAs extensões do Canvas que você cria no aplicativo ou instala diretamente ficam em seu próprio diretório, em `.github/extensions` (escopo do projeto) ou `~/.copilot/extensions` (escopo do usuário).\n\nEmbora as implementações possam variar, uma extensão de tela geralmente inclui:\n\n* Um arquivo `package.json` para os metadados e as dependências de uma extensão.\n* Um arquivo de entrada de extensão, como `extension.mjs`, que define o comportamento e os recursos da tela.\n* Artefatos JSON opcionais (por exemplo, arquivos em um diretório `artifacts`) para dados e estado de tela persistentes.\n\nQuando 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.\n\n## Trabalhando em uma tela\n\nQuando a tela estiver aberta, você poderá fazer iterações rapidamente com o agente.\n\n* Adicione ou revise as funcionalidades da tela de desenho.\n* Use controles de canvas (como botões, cartões ou filtros) para atualizar diretamente a área.\n* Peça ao agente para chamar os recursos expostos pela tela para atualizar dados ou executar ações.\n\n## Leitura adicional\n\n* [Trabalhando com sessões de agente no GitHub aplicativo Copilot](/pt/enterprise-cloud@latest/copilot/how-tos/github-copilot-app/agent-sessions).\n* [Personalizando a aplicativo Copilot do GitHub](/pt/enterprise-cloud@latest/copilot/how-tos/github-copilot-app/customize-github-copilot-app)."}