интеграция Copilot

Расширение PostgreSQL интегрируется с помощниками по ИИ через три поверхности: участник чата @pgsql (только Visual Studio Code), средства режима агента и поставщик MCP-сервера средств PostgreSQL. Эта страница помогает выбрать правильную точку входа и понять общую конфигурацию, которая применяется ко всем трем.

Расширение работает как в Visual Studio Code (с GitHub Copilot), так и в Cursor (с его встроенным ИИ). Большинство функций работают одинаково в обоих редакторах; немногочисленные особенности, характерные для конкретного редактора, отмечены по ходу этой статьи.

Необходимые условия

Прежде чем использовать любую функцию СИ, убедитесь, что выполнены следующие требования:

  • Расширение PostgreSQL установлено и настроено по крайней мере одно подключение к базе данных.
  • Помощник по искусственному интеллекту доступен в редакторе:
    • Visual Studio Code: установите GitHub Copilot или GitHub Copilot Чат и войдите в систему с помощью активной подписки.
    • Cursor: дополнительная установка не требуется; встроенный ИИ используется автоматически.

Note

Copilot функции включены по умолчанию (pgsql.copilot.enableимеет значение true). Если установить для этого значение false, будут скрыты участник чата @pgsql (только в Visual Studio Code), подменю редактора Действия ИИ для запросов, инструменты режима агента и поставщик сервера MCP.

Tip

Помощь СИ лучше всего работает, если у вас уже есть активное подключение к базе данных. Если вы ещё не подключились, начните с Подключения и идентификационные данные.

Выберите нужную точку входа

Если вы хотите... Начните здесь Availability Learn more
Задайте вопрос о базе данных с учетом ее схемы участник чата @pgsql только Visual Studio Code участник чата @pgsql
Запустите режим агента с определённой базой данных, уже находящейся в контексте Подключение ИИ из узла базы данных в дереве подключений Visual Studio Code и курсор Режим агента
Объяснение, перезапись или анализ SQL из редактора Подменю AI Query Actions в контекстном меню редактора Visual Studio Code и курсор Действия редактора
Автоматизируйте многоэтапную задачу базы данных Подключение искусственного интеллекта к узлу базы данных для запуска режима агента Visual Studio Code и курсор Режим агента
Предоставить инструменты PostgreSQL хостам, совместимым с MCP Поставщик MCP-сервера для инструментов PostgreSQL Visual Studio Code и курсор Сервер MCP

Используйте @pgsql для чата с учетом схемы

Note

Участник чата @pgsql зарегистрирован только в Visual Studio Code, где он подключается к Copilot Chat GitHub. В Cursor используйте Connect AI из узла базы данных в дереве подключений , чтобы запустить режим агента с тем же контекстом схемы или использовать сервер MCP в собственной области чата Курсора.

Расширение регистрирует участника чата @pgsql (ID: vscode-postgresql.chat-agent) для чатов с учётом схемы в GitHub Copilot Chat. Введите @pgsql, а затем свой вопрос, и участник ответит, используя актуальный контекст схемы из подключённой базы данных.

Чтобы запустить инструментальный рабочий процесс, если база данных уже находится в области действия, щелкните правой кнопкой мыши по узлу базы данных в дереве Connections и выберите Connect AI.

Чтобы получить руководство для конечных пользователей, примеры запросов и инструкции по устранению неполадок, перейдите к участнику чата @pgsql.

Используйте действия редактора для получения справки по запросам

При открытии SQL в редакторе запросов щелкните правой кнопкой мыши, чтобы найти подменю действий запросов ИИ . Он содержит следующие действия:

Действие Описание
Объяснение запроса Возвращает объяснение того, что делает запрос, простым языком.
Перезапись запроса Предлагает альтернативную версию запроса при сохранении предполагаемого результата.
Анализ производительности запросов В подключенной базе данных выполняется EXPLAIN ANALYZE, а затем план выполнения отправляется ИИ для анализа.

Вы также можете выбрать Спросить ИИ об этом запросе на панели инструментов редактора, чтобы открыть чат, основанный на текущем содержимом редактора.

Чтобы сбросить сохранённые параметры включения запросов для анализа планов, выполните Очистить параметры включения запросов для анализа ИИ из палитры команд.

Использование режима агента для рабочих процессов на основе инструментов

Режим агента предоставляет помощнику по искусственному интеллекту доступ к средствам PostgreSQL, чтобы он смог подключиться, проверить схему, выполнить запросы, открыть скрипты и выполнять многоэтапные задачи в одной беседе. Щелкните правой кнопкой мыши узел базы данных в дереве подключений и выберите "Подключить ИИ ", чтобы запустить сеанс режима агента.

Для семейств инструментов, примеров рабочих процессов и устранения неполадок перейдите в режим агента.

Использование сервера MCP в поддерживаемых узлах

Расширение регистрирует поставщика MCP-сервера инструментов PostgreSQL (ID: pgsql-tools-mcp-server-provider), который предоставляет тот же набор инструментов PostgreSQL через протокол Model Context Protocol. Узлы, совместимые с MCP, могут обнаруживать и вызывать эти средства без использования встроенных рабочих процессов чата.

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

Настройка режима доступа

Параметр pgsql.copilot.accessMode определяет, сколько доступа к базе данных помощник по ИИ получает в режиме агента и средствах MCP. Значение по умолчанию — чтение и запись (rw).

Настройка значения Метка пользовательского интерфейса Что может сделать помощник по ИИ
ro Только чтение Операции только для чтения: SELECT, SHOW, EXPLAIN, проверка схемы
rw Чтение и запись Операции чтения, операции изменения данных и DDL с явным подтверждением

Переопределение для каждого подключения

Вы также можете задать режим доступа для отдельных подключений. В диалоговом окне подключения разверните раздел Copilot (ИИ в курсоре) и задайте режим доступа Copilot (режим доступа к ИИ в курсоре) одному из следующих элементов:

Опция Поведение
Использование глобального параметра Возвращается к глобальному pgsql.copilot.accessMode значению (по умолчанию)
Только чтение Принудительно включает режим доступа только для чтения для этого подключения независимо от глобальной настройки
Чтение и запись Принудительно включает доступ на чтение и запись для этого подключения независимо от глобальной настройки

Расширение определяет эффективный режим доступа, используя следующую цепочку: значение для конкретного подключения → глобальная настройка pgsql.copilot.accessMode → значение по умолчанию (rw).

Предостережение

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

Настройка дополнительных параметров

Setting Что он контролирует По умолчанию
pgsql.copilot.enable Включает или отключает всю интеграцию ИИ в расширении true
pgsql.copilot.accessMode Глобальный режим доступа к ИИ (только для чтения или чтения и записи) rw
pgsql.copilot.autoAttachQuery Включен ли текст SQL-запроса при анализе планов с помощью ИИ: спрашивать каждый раз, всегда включать или никогда не включать ask
pgsql.copilot.modelOptions Расширенная настройка модели (максимальное количество токенов, температура, top_p) для рабочих процессов ИИ расширения -

Идентификаторы настроек сохраняют префикс pgsql.copilot.* в обоих редакторах ради обратной совместимости, хотя в видимых пользователю названиях указано "AI".

Интеграция с ИИ для конкретных функций

К нескольким функциям относятся выделенные точки интеграции СИ:

Функция Возможности искусственного интеллекта
Визуализатор плана запросов Анализируйте данные плана выполнения с помощью Анализа с Copilot (или Анализа с ИИ в Cursor)
Панель мониторинга сервера Открывайте сеансы чата с помощью кнопок Спросить Copilot (Ask AI в Cursor) на панелях Запросы, Ожидания, Сеансы и диаграмм метрик
Визуализатор схемы Визуализация связей схемы из рабочего процесса режима агента

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

  • Last updated on