О создании расширений Copilot

О Copilot Extensions

Copilot Extensions — это интеграции, расширяющие функциональные возможности Copilot Chat. Copilot Extensions позволяют разработчикам интегрировать внешние средства, службы и пользовательские поведения в интерфейс Copilot Chat во всех поддерживаемых идентификаторах и GitHub.

Copilot Extensions создаются как GitHub Apps с дополнительными возможностями, в том числе:

• Доступ на чтение к журналу Copilot Chat
• Отправка ответов пользователям в окне Copilot Chat
• Выполнение GitHub (первая сторона) или функции во внешних службах (сторонние)

Copilot Extensions можно использовать с:

• Copilot Chat в Visual Studio
• Copilot Chat в Visual Studio Code
• Copilot Chat в GitHub.com (с подпиской Copilot Enterprise

Видимость Copilot Extensions

Copilot Extensions может быть частным, общедоступным и общедоступным, или общедоступным и перечисленным в GitHub Marketplace. Какой вариант видимости вы выберете, будет зависеть от вашего варианта использования и целевой аудитории.

• Частные расширения часто предпочитают крупные предприятия или компании, которые:
  • Требуется больше настроек и элементов управления доступом к данным
  • Необходимо интегрировать с большим объемом внутренних документов и баз данных
  • Строгая политика безопасности, что затрудняет авторизацию разрешений для третьих сторон
• Общедоступные расширения подходят для:
  • Проекты с открытым кодом
  • Совместная разработка и использование в организациях в рамках предприятия
  • Предоставление общего доступа к инструменту и получение отзывов перед публикацией в GitHub Marketplace
• Расширения GitHub Marketplace идеально подходят для сторонних разработчиков, которые хотят:
  • Предложить свою службу более широкой аудитории
  • Интеграция средства в рабочий процесс разработчика на GitHub и интегрированной среды разработки
  • Использование экосистемы GitHub для повышения осведомленности о продукте

Случаи использования

Вы можете использовать Copilot Extensions для расширения возможностей Copilot Chat различными способами. Например, их можно использовать для:

• Запросы к документам: Copilot Extension может разрешить Copilot Chat запрашивать стороннюю службу документации для поиска сведений о конкретном разделе.
• Код с поддержкой искусственного интеллекта: Copilot Extension может использовать стороннюю модель ИИ для предоставления предложений кода.
• Получение данных: Copilot Extension может разрешить Copilot Chat запрашивать стороннюю службу данных для получения сведений о конкретном разделе.
• Выполнение действия: Copilot Extension может разрешить Copilot Chat выполнять определенное действие, например публикацию в доске сообщений или обновление элемента отслеживания во внешней системе.

Набор средств расширений, примеры кода и пакет SDK

GitHub предоставляет комплексный набор средств для построителей расширений, примеры кода, средство отладки CLI, пакеты SDK для быстрого запуска и репозиторий отзывов пользователей. Дополнительные сведения см. в организации copilot-extensions на GitHub.

Прежде чем создавать собственные данные Copilot Extension с нуля, вам может потребоваться изучить существующий Copilot agent, и интегрировать его с GitHub App для просмотра его работы. GitHub предоставляет несколько примеров Copilot agents, которые можно клонировать и использовать в качестве основы для собственных данных Copilot Extension, включая:

• Blackbeard: простой Copilot agent, который отвечает на запросы, такие как пират, используя CopilotLLM API и специальные системные запросы. Это хорошая отправная точка для обучения созданию Copilot Extension. Дополнительные сведения см. в документе Blackbeard Copilot Extension.

• GitHub Models: более сложный объект Copilot agent, который позволяет запрашивать и взаимодействовать с различными LLM, перечисленными в GitHub Marketplace из Copilot Chat. Дополнительные сведения см. в разделе GitHub Models Copilot Extension.

  Note

  GitHub Models находятся в beta и подлежат изменению. Чтобы запросить доступ, присоединитесь к списку ожидания.

• Вызов функции: пример агента, написанного в Go, который демонстрирует вызовы функций и диалоги подтверждения. Дополнительные сведения см. в расширении вызова функции.

• Расширение RAG: пример агента, написанного в Go, который демонстрирует простую реализацию расширенного поколения извлечения. Дополнительные сведения см. в расширении RAG.

• Пакет SDK для предварительной версии: пакет SDK, упрощающий создание Copilot Extensions путем обработки проверки запросов, форматирования ответа и взаимодействия API. Это позволяет построителям сосредоточиться на основных функциональных возможностях расширения, а не на основе стандартных функций, упрощая интеграцию средств, API и источников данных в Copilot Chat. Дополнительные сведения см. в пакете SDK для предварительной версии.

О Copilot-enabled Visual Studio Code extensions

Кроме того, можно создать Copilot Extension, который является эксклюзивным и собственным для Visual Studio Code. Эти расширения называются Copilot-enabled Visual Studio Code extensions, или Visual Studio Code расширения чата. VS Code Расширения чата можно использовать только в Copilot Chat для VS Code, и это хороший вариант для разработчиков, которые хотят создавать расширения, использующие определенные функции Visual Studio Code .

Существует несколько ключевых различий от GitHub Copilot Extensions:

• Visual Studio Code Расширения чата работают только в среде Visual Studio Code .
• Copilot-enabled Visual Studio Code extensions имеет больше доступа к функциям и API Visual Studio Code, что позволяет более подробно взаимодействовать с редактором, например получать доступ к данным локальной рабочей области, управлять интерфейсом Visual Studio Code, а также доступом на чтение и запись к локальным файлам.
• Copilot-enabled Visual Studio Code extensions публикуются в Visual Studio Code Marketplace, а не GitHub Marketplace.

Дополнительные сведения см. в разделе "Расширения чата " в документации по Visual Studio Code .

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

• "Глоссарий расширений Copilot"