Skip to main content

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

Узнайте о процессе разработки для Copilot Extension.

Note

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

О 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 .

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