Trabajar con extensiones de Canvas en la aplicación GitHub Copilot

** Copilot Business, Copilot Enterprise, Copilot Proy Copilot Pro+ usuarios** : descargue e instale desde el aplicación Copilot de GitHub repositorio. Para Copilot Business y Copilot Enterprise, la organización o la empresa deben habilitar las características en versión preliminar y CLI de Copilot.

* ** Copilot gratis usuarios y usuarios sin un Copilot plan** : para solicitar acceso, únase a la lista de espera.

Información sobre las extensiones de Canvas

Una extensión de canvas es un espacio compartido e interactivo para un recurso de trabajo, como un plan, un tablero de triaje, una sesión del navegador, una lista de comprobación de lanzamiento, un cuadro de mando, un incidente o una hoja de cálculo.

Aunque el chat es útil para definir la intención y analizar las tareas, la mayoría del trabajo se produce en superficies de trabajo como un terminal, un explorador, un documento o un panel. Los lienzos permiten colaborar directamente con el agente en esas superficies de trabajo.

Los lienzos son bidireccionales: el agente puede actualizar el lienzo mientras trabaja, y tú puedes editar sobre esa misma superficie. Al crear un lienzo, el agente genera capacidades basadas en tu instrucción y flujo de trabajo. A medida que itera, puede pedirle que agregue, quite o revise esas funcionalidades. Una vez creados, los lienzos se abren en el panel del lado derecho de la aplicación.

Por ejemplo, puede crear un lienzo kanban agente en el que los usuarios usen controles de interfaz de usuario para crear o mover tarjetas, y pedir al agente que agregue funcionalidades invocables por agente, como get_board, add_cardy move_card. Esto permite a las personas y a los agentes coordinar su trabajo desde un tablero compartido.

¿Por qué usar un lienzo?

Los lienzos son útiles cuando una tarea o flujo de trabajo necesita estructura, iteración y comprobación, y un chat no es suficiente. Puede usar el chat para dar instrucciones al agente y razonar ante la ambigüedad y, a continuación, usar el lienzo para inspeccionar, guiar y verificar directamente el trabajo visible sin depender únicamente de prompts.

Los lienzos proporcionan dos tipos de valor: mejoran la asociación entre agentes humanos, ya que proporcionan a ambos lados una superficie compartida en la que trabajar y le permiten personalizar esa superficie para que coincida con el flujo de trabajo.

Los lienzos son útiles cuando es necesario:

• Basa el trabajo del agente en un artefacto o entorno real que se adapte a tu flujo de trabajo.
• Dirigir o corregir el trabajo directamente en la superficie compartida y, a continuación, permitir que el agente continúe con esos cambios.
• Inspeccione el progreso y los resultados como cambios visibles en un artefacto compartido, no solo las respuestas de chat.
• Mantenga el trabajo continuo en turnos, sesiones y entregas.

Ejemplos de casos de uso

Las extensiones de lienzo se pueden personalizar para adaptarse a sus necesidades o a las necesidades de su equipo en una variedad de escenarios. Por ejemplo:

• Tableros kanban con agentes: Permita que las personas y los agentes añadan tarjetas, muevan el trabajo e inicien tareas.
• Paneles de triaje de incidencias: Resumen de las principales incidencias, los temas recurrentes y los puntos problemáticos para los usuarios de un repositorio.
• Lienzos de Markdown: Cree un archivo markdown persistente para planear el día, priorizar problemas y solicitudes de incorporación de cambios, iniciar y supervisar sesiones del agente y mantener el trabajo relacionado en una superficie editable.
• Lienzos de documentos: Abra, edite y colabore en documentos, hojas de cálculo, presentaciones de diapositivas y otros artefactos directamente en la aplicación.

Creación de un lienzo

Puedes crear un nuevo lienzo dentro de una sesión con la función /create-canvas.

1. Abra o inicie una sesión de agente.

2. En el cuadro de texto, escriba /create-canvas y, a continuación, describa el flujo de trabajo y las capacidades que desea que admita el lienzo, incluyendo lo que las personas deben poder hacer y lo que el agente debe poder hacer. Por ejemplo, puede pedir al agente que haga lo siguiente:

   • 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. Puede elegir si el lienzo debe compartirse con su equipo o mantenerse personal:

   • Ámbito del proyecto:.github/extensions para lienzos compartidos por el equipo subidos al repositorio.
   • Ámbito de usuario:~/.copilot/extensions para lienzos personales en la máquina.

El agente creará el lienzo y lo abrirá en el panel lateral derecho cuando termine. Después de eso, puede seguir iterando pidiendo al agente que cambie la interfaz, el estado compartido y las funcionalidades.

Cómo se estructuran las extensiones de lienzo

Cada extensión de lienzo se encuentra en su propio directorio dentro de .github/extensions (ámbito del proyecto) o ~/.copilot/extensions (ámbito del usuario).

Aunque las implementaciones pueden variar, una extensión de lienzo normalmente incluye:

• Un package.json archivo para los metadatos y las dependencias de la extensión.
• Un archivo de entrada de extensión, como extension.mjs, que define el comportamiento y las funcionalidades del lienzo.
• Artefactos JSON opcionales (por ejemplo, archivos en un artifacts directorio) para datos y estado de lienzo persistentes.

Cuando se abre un lienzo en el panel lateral de la aplicación, tanto los usuarios como los agentes interactúan con ese mismo estado compartido mediante acciones en la interfaz de usuario y capacidades que los agentes pueden invocar.

Trabajar en un lienzo

Una vez abierto un lienzo, puede iterar con rapidez con el agente.

• Agregue o revise las funcionalidades del lienzo.
• Use controles de lienzo (como botones, tarjetas o filtros) para actualizar la superficie directamente.
• Pida al agente que llame a las funcionalidades expuestas por el lienzo para actualizar los datos o realizar acciones.

Lectura adicional

• Trabajar con sesiones de agente en la aplicación GitHub Copilot.
• Personalización del aplicación Copilot de GitHub.