# Работа с расширениями canvas в приложении GitHub приложение Copilot

Используйте холсты для GitHub Copilot app создания общих, управляемых агентами артефактов и интерфейсов для сотрудничества человека и агента.

## О расширениях холста

Расширение Canvas — это общая, интерактивная поверхность для рабочего артефакта, такого как план, доска сортировки, сессия браузера, чек-лист релиза, панель управления, инцидент или таблица.

Расширение холста можно включить в подключаемый модуль вместе с другими возможностями, такими как навыки или серверы MCP.

Хотя чат полезен для определения намерений и обсуждения задач, большая часть работы происходит на рабочих поверхностях, таких как терминал, браузер, документ или панель управления. Холсты позволяют напрямую сотрудничать с агентом на этих рабочих поверхностях.

Холсты двусторонние: агент может обновлять холст во время работы, а вы можете редактировать на той же поверхности. Когда вы создаёте холст, агент генерирует возможности на основе вашего запроса и рабочего процесса. По мере итерации вы можете попросить его добавить, удалить или изменить эти возможности. После создания холсты открываются в правой боковой панели приложения.

Например, можно создать агентный канбан-холст, где пользователи используют элементы управления интерфейсом для создания или перемещения карт, и попросить агента добавить возможности для вызова агента, такие `get_board`как , `add_card`и `move_card`. Это позволяет людям и агентам координировать работу с одной общей доски.

## Зачем использовать холст

Холсты полезны, когда задача или рабочий процесс нуждаются в структуре, итерации и верификации, а чат недостаточно. Вы можете использовать чат, чтобы инструктировать агента и рассуждать через неоднозначность, а затем использовать canvas для прямого осмотра, управления и проверки видимой работы, не полагаясь только на подсказки.

Холсты дают два вида ценности: они улучшают партнёрство между человеком и агентом, предоставляя обеим сторонам общую поверхность для работы, и позволяют настраивать её под ваш рабочий процесс.

Холсты полезны, когда нужно:

* Наземные агенты работают в реальных артефактах или среде, которые подходят под ваш рабочий процесс.
* Направлять или корректировать работу непосредственно на общей поверхности, а затем дать агенту продолжить эти изменения.
* Анализируйте прогресс и результаты как заметные изменения в общем артефакте, а не только ответы в чате.
* Поддерживайте непрерывность работы во время поворотов, сессий и передач передач.

## Примеры вариантов использования

Расширения Canvas можно адаптировать под ваши нужды или нужды вашей команды в различных ситуациях. Рассмотрим пример.

* **Агентные канбан-доски:** Позвольте людям и агентам добавлять карты, перемещать работу и начинать задачи.
* **Выдайте доски сортировки:** Кратко изложите основные проблемы, повторяющиеся темы и проблемы пользователей для репозитория.
* **Холсты с маркировкой:** Создайте постоянный файл markdown для планирования дня, приоритизирования проблем и pull request, запуска и мониторинга сессий агентов, а также сохранения сопутствующей работы на одной редактируемой поверхности.
* **Документальные холсты:** Открывайте, редактируйте и сотрудничайте с документами, таблицами, слайдами и другими артефактами прямо в приложении.

## Обнаружение холстов

Представление **"Холст** " предоставляет проверенный список избранных холстов. Некоторые холсты доставляются через подключаемые модули, которые необходимо установить, прежде чем использовать холст в сеансе. Например, установка подключаемого модуля Azure DevOps предоставляет доступ к холсту для планирования работы Azure DevOps и управления ими.

1. На боковой панели приложения нажмите кнопку **"Настроить**".
2. Щелкните **экран**.
3. Просмотрите рекомендуемые холсты.
4. Если для холста требуется подключаемый модуль, нажмите кнопку **"Установить подключаемый модуль**".
5. Нажмите кнопку **"Создать сеанс",** чтобы открыть сеанс с холстом.

Вы также можете нажать кнопку **"Установить"** , чтобы просмотреть все установленные настройки, включая холсты, доступные для использования.

## Создание холста

Вы можете создать новый холст внутри сессии, используя этот `/create-canvas` навык.

1. Откройте или начните сессию агента.
2. В поле запроса введите `/create-canvas`, затем опишите рабочий процесс и возможности, которые вы хотите, чтобы поддерживал Canvas, включая то, что должны уметь делать люди, а что должен делать агент.
   Например, вы можете попросить агента:

   * `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. Вы можете выбрать, стоит ли делиться холстом с вашей командой или держать его личным:
   * **Project scope:**`.github/extensions` для командных холста, закреплённых в репозитории.
   * **Сфера применения:**`~/.copilot/extensions` Для личных холстов на вашей машине.

Агент построит холст и откроет его в правой боковой панели после завершения. После этого можно продолжить итеративность, попросив агента изменить интерфейс, общее состояние и возможности.

## Как структурируются расширения холста

Расширения холста, которые вы создаете в приложении или устанавливаете непосредственно в собственном каталоге `.github/extensions` в пределах (область проекта) или `~/.copilot/extensions` (область пользователя).

Хотя реализации могут различаться, расширение Canvas обычно включает:

* Файл `package.json` для метаданных расширений и зависимостей.
* Файл записи расширения, например `extension.mjs`, который определяет поведение и возможности холста.
* Опциональные артефакты JSON (например, файлы под каталогом `artifacts` ) для сохраненных данных холста и состояния.

Когда в боковой панели приложения открывается холст, и люди, и агенты взаимодействуют с тем же общим состоянием через действия интерфейса и возможности вызова агентами.

## Работа на холсте

Когда холст открыт, можно быстро повторять с агентом.

* Добавьте или пересмотрите возможности холста.
* Используйте элементы управления холста (такие как кнопки, карты или фильтры) для прямого обновления поверхности.
* Попросите агента вызвать возможности, открытые canvas, для обновления данных или принятия действий.

## Дополнительные материалы

* [автозаголовок](/ru/copilot/how-tos/github-copilot-app/agent-sessions).
* [автозаголовок](/ru/copilot/how-tos/github-copilot-app/customize-github-copilot-app).