Как GitHub Copilot работает с расширением MSSQL

Интеграция GitHub Copilot с расширением MSSQL для Visual Studio Code предоставляет несколько поверхностей, где искусственный интеллект (ИИ) помогает разрабатывать SQL. Каждая поверхность имеет различные возможности, разные возможности доступа к схеме базы данных и разные идеальные варианты использования. В этой статье объясняется, какие поверхности обрабатывают сценарий, поэтому вы можете выбрать подходящее средство для каждой задачи.

Основные итоги

  • Участник @mssql чата, средства режима агента, конструктор схем и построитель API данных имеют осведомленность о схеме при подключении к базе данных.
  • Встроенные автодополнения (фантомный текст при вводе в файле .sql) поступают непосредственно из модели GitHub Copilot и не учитывают схему подключённой базы данных.
  • Чтобы получать подсказки с учётом схемы при написании SQL, используйте в чате участника @mssql, а не встроенный призрачный текст.

GitHub Copilot: краткий обзор

Surface Кем предоставлено С учетом схемы? лучше всего подходит для
Участник чата (@mssql) Расширение MSSQL Да (подключенная база данных) Вопросы, объяснения, создание запросов
Средства режима агента Расширение MSSQL содержит инструменты Да (через вызовы инструментов) Многоэтапные рабочие процессы, делегированные изменения
Режим плана Visual Studio Code Да (через контекст @mssql) Причины перед написанием языка определения данных SQL (DDL)
Слэш-команды Расширение MSSQL Yes Структурированные запросы для распространенных задач
Встроенные завершения модель GitHub Copilot напрямую нет Стандартный текст-подсказка при вводе текста
Конструктор схем с GitHub Copilot Внедренный в конструктор схем MSSQL Yes Проектирование визуальной схемы с помощью ИИ
Построитель API данных с GitHub Copilot Встроено в конструктор Data API для MSSQL Yes Конфигурация сущностей для конечных точек REST, GraphQL и протокола контекста модели (MCP)

Участник чата: @mssql

Участник чата @mssql предоставляется расширением MSSQL. Когда вы вводите @mssql в окне GitHub Copilot Chat, расширение получает ваш запрос вместе с метаданными об активном подключении к базе данных. Расширение может:

  • Чтение сведений о схеме (таблицы, столбцы, связи, хранимые процедуры)
  • Включение контекста схемы в запрос, отправляемый модели
  • Возврат ответов, ссылающихся на реальные объекты в базе данных

Участник беседы — основной способ получить помощь ИИ, учитывающую схему. Он обеспечивает взаимодействия в режиме ask и режиме edit, когда вы обращаетесь к @mssql в чате.

Пример пошагового руководства по сценарию см. в разделе Краткое руководство: чат с участником @mssql(режим вопросов).

Средства режима агента

Режим агента позволяет GitHub Copilot автономно планировать и выполнять работу. Расширение MSSQL предоставляет набор инструментов (например, connect, list_databases, run_query), которые режим агента может использовать от вашего имени, но только с вашего одобрения.

В отличие от участника чата (которому требуется явное упоминание @mssql), режим агента автоматически получает доступ к инструментам расширения MSSQL, когда это расширение активно. Вы пишете запросы естественного языка, такие как "Подключиться к моему профилю LocalDev и показать мне таблицы в AdventureWorks", и режим агента выбирает средства для вызова.

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

Полное справочное руководство по инструменту и примеры запросов см. в статье Краткое руководство. Использование режима агента GitHub Copilot.

Режим планирования

Режим планирования — это функция Visual Studio Code, которая позволяет GitHub Copilot анализировать запрос, не внося изменений. Когда вы переключаете чат в режим плана, GitHub Copilot создает текстовый план (часто сохраняемый как plan.md), который можно просмотреть перед тем, как передать его режиму агента или Schema Designer для выполнения.

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

Пошаговое руководство по использованию режима плана с документом о требованиях к продукту (PRD) см. в кратком руководстве. Использование режима плана для проектирования баз данных на основе спецификаций.

Встроенные автодополнения

Встроенные завершения — это фантомный текст, который отображается при вводе в редакторе. В .sql файлах эти предложения приходят непосредственно из модели GitHub Copilot.

Встроенные автодополнения не видят схему подключённой базы данных. API встроенных автодополнений в Visual Studio Code по сути поддерживает только одного поставщика: когда включён GitHub Copilot, сторонние расширения (включая расширение MSSQL) не могут предоставлять призрачные подсказки с учётом схемы. Для предложений SQL с поддержкой схемы используйте вместо этого участника чата@mssql.

Это поведение платформы, а не ограничение расширения MSSQL. Это относится к любому стороннему расширению, которое хочет добавлять встроенные автодополнения SQL. Чтобы подробнее узнать о возможностях встроенных завершений, см. Краткое руководство: использование встроенных завершений GitHub Copilot в SQL-файлах.

Конструктор схем со встроенным GitHub Copilot

GitHub Copilot встроен прямо в рабочую область конструктора схем в расширении MSSQL. Это отдельный конвейер, отличный от режима чата и режима агента. Конструктор схем имеет собственную инфраструктуру промптов и собственный подход к применению контекста схемы. Вы можете попросить GitHub Copilot создавать таблицы из выбранного кода, добавлять связи, создавать тестовые данные или импортировать внешние артефакты, а также наблюдать за динамическим обновлением визуальной схемы.

Конструктор схем с GitHub Copilot учитывает схему, так как он работает непосредственно в подключенной базе данных.

Примеры, основанные на сценариях, см. в кратком руководстве: Визуальное проектирование схем с помощью встроенных сценариев GitHub Copilot.

Конструктор API данных со встроенным GitHub Copilot

Рабочая область конструктора Data API также включает встроенную панель чата GitHub Copilot. Вы можете использовать естественный язык для настройки сущностей, разрешений и типов выходных данных (REST, GraphQL, MCP). Как и конструктор схем, эта поверхность учитывает схему и использует собственный конвейер запроса.

Полный рабочий процесс см. в построителе API данных.

Пользовательские инструкции действуют во всех интерфейсах

Независимо от того, какая область используется, GitHub Copilot применяет любые пользовательские инструкции, созданные для проекта. Файлы инструкций (.github/instructions/*.instructions.md) знакомят GitHub Copilot с принятыми в вашей команде соглашениями и добавляются в каждый запрос, для которого совпадает шаблон applyTo.

Это означает, что ваши правила именования, шаблоны файлов и предпочтения в отношении типов данных в равной степени влияют на режим вопросов, режим агента, режим плана и встроенные автодополнения. О том, как это настроить, см. в кратком руководстве «Использование пользовательских инструкций для настройки GitHub Copilot в соответствии с вашими соглашениями T-SQL».

Конфиденциальность и обработка данных

Все запросы проходят через прокси-сервер GitHub Copilot, обеспечивающий конфиденциальность. Запросы и ответы не хранятся и не используются для обучения моделей. Дополнительные сведения см. в разделе "Ограничения" и известные проблемы ицентр управления безопасностью GitHub Copilot.

Оставьте свой отзыв

Чтобы помочь нам уточнить и улучшить GitHub Copilot для расширения MSSQL, используйте следующий шаблон проблемы GitHub для отправки отзывов: GitHub Copilot Feedback

При отправке отзывов рассмотрите возможность включения:

  • Тестируемые сценарии: сообщите нам, на какие области вы ориентированы, например создание схемы, создание запросов, безопасность, локализация.

  • Что хорошо работало: Опишите любые ситуации, которые были безупречными, полезными или превысили ваши ожидания.

  • Проблемы или ошибки: любые проблемы, несоответствия или запутанное поведение. Снимки экрана или записи экрана особенно полезны.

  • Предложения по улучшению: поделитесь идеями для улучшения удобства использования, расширения охвата или улучшения ответов GitHub Copilot.

Связанный контент

  • Last updated on