Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Режим агента позволяет помощнику по ИИ в редакторе использовать средства PostgreSQL из расширения в рамках одного многоэтапного диалога. Вместо того чтобы просто отвечать на вопрос, помощник может подключаться к базе данных, изучать её схему, выполнять запросы, открывать скрипты и помогать вам проходить весь рабочий процесс от начала до конца.
Режим агента работает как в Visual Studio Code (с GitHub Copilot), так и в Cursor (с его встроенным ИИ). Расширение предоставляет одну и ту же область инструментов PostgreSQL в обоих редакторах; только открывающаяся панель чата отличается.
Используйте режим агента, когда нужно, чтобы ИИ выполнял структурированные действия, а не только давал объяснения или составлял SQL-запросы.
Необходимые условия
Прежде чем начать, убедитесь, что у вас есть:
- Установленное расширение PostgreSQL.
- функции Copilot/ИИ, включенные в расширение (
pgsql.copilot.enableistrue). - По крайней мере одно подключение к базе данных, настроенное в расширении.
- Помощник по искусственному интеллекту, доступный в редакторе:
- Visual Studio Code: GitHub Copilot или GitHub Copilot чат установлен и активен.
- Cursor: дополнительная установка не требуется; встроенный ИИ используется автоматически.
Режим запуска агента
- Подключитесь к целевому серверу или базе данных в расширении PostgreSQL.
- В дереве подключений щелкните правой кнопкой мыши базу данных, которую вы хотите использовать.
- Выберите "Подключить ИИ".
- Продолжайте беседу на панели чата, которая открывается с рабочим процессом, который вы хотите завершить.
- В Visual Studio Code это панель Copilot Chat GitHub в режиме агента.
- В Cursor это встроенная ИИ-панель Cursor; расширение предоставляет краткое введение, ориентированное на MCP, чтобы помощник знал о доступных инструментах PostgreSQL.
После начала сеанса ИИ может в фоновом режиме комбинировать инструменты PostgreSQL при обработке вашего запроса.
Выбор правильного режима доступа
Параметр pgsql.copilot.accessMode определяет, сколько получает режим агента доступа к базе данных. Идентификатор параметра сохраняет префикс pgsql.copilot.* для совместимости; отображаемая пользователю метка — режим доступа Copilot в Visual Studio Code и режим доступа к ИИ в Cursor.
| Режим | Что может сделать ИИ | Рекомендуемое использование |
|---|---|---|
ro |
Операции только для чтения, такие как SELECT, SHOW, EXPLAIN, проверка схемы и анализ |
Рабочие системы или общие среды, в которых требуется исследование без изменений |
rw |
Операции чтения и инструкции изменения данных и DDL с явным подтверждением перед выполнением | Локальная разработка, временные песочницы и управляемые тестовые среды |
Предостережение
Используйте ro режим для рабочих баз данных, если вы намеренно не хотите изменять схему или данные, доступные в режиме агента.
Общие сведения о семействах инструментов
Режим агента может использовать несколько семейств инструментов в зависимости от рабочего процесса.
| Семейство инструментов | Что делает | При его использовании |
|---|---|---|
| Средства подключения | Список профилей, подключение, отключение, список баз данных | Контекст запуска или переключения |
| Инструменты контекста схемы | Получение определений объектов или визуализация схемы | Общие сведения о таблицах, представлениях, функциях, индексах и отношениях |
| Средства выполнения запросов | Выполнение запросов чтения, проверка планов запросов, открытие скриптов | Изучение данных, проверка идей или проверка созданного SQL |
| Средства изменения | Запуск DDL или DML с подтверждением | Применение контролируемых изменений схемы или данных в режиме rw |
| Средства импорта данных | Описать CSV-файлы и массово загрузить их | Планирование и выполнение рабочих процессов импорта CSV |
Tip
В Cursor те же инструменты также доступны через регистрацию на сервере MCP. Встроенный чат Cursor может напрямую вызывать их без использования точки входа Connect AI. Дополнительные сведения см. на сервере MCP .
Использование режима агента для распространенных рабочих процессов
В следующих примерах показано, как использовать режим агента для задач, которые варьируются от изучения новой базы данных до уточнения запросов.
Изучение незнакомой базы данных
Попросите ИИ подключиться к базе данных, перечислить ключевые объекты и суммировать области схемы, которые имеют значение для вашей задачи.
Пример:
Подключитесь к моей базе данных для разработки, перечислите таблицы в схеме public и сообщите, какие из них, по-видимому, связаны с клиентами и заказами.
Изучение производительности запросов
Попросите ИИ объединить контекст схемы с выполнением запросов или проверкой плана.
Пример:
Подключитесь к промежуточной базе данных, запустите этот запрос в режиме только для чтения и объясните, какая часть плана выполнения приводит к затратам.
Загрузка или изменение формы данных
Используйте режим агента, если рабочий процесс включает скрипты или операции на основе CSV.
Пример:
Просмотрите этот CSV-файл, сообщите мне, какую схему она подразумевает, и подготовьте безопасный план импорта
sales.recordsдля таблицы.
Переход от черновика к просмотру вручную
Если перед выполнением требуется контрольная точка проверки человека, попросите ИИ открыть созданный SQL в редакторе запросов, а не запустить его немедленно.
Знать, когда следует использовать режим агента вместо @pgsql
Используйте @pgsql участник чата, когда вам нужен ответ с учётом схемы или черновик запроса. Компонент @pgsql доступен только в Visual Studio Code.
Используйте режим агента (доступный как в Visual Studio Code, так и в курсоре), если вы хотите, чтобы ИИ:
- подключитесь к нужной базе данных,
- объединять несколько инструментов в рамках одной беседы,
- проверьте результаты перед следующим шагом или
- подготовьте скрипт или управляемый рабочий процесс изменения.
Note
В Cursor режим агента является основным вариантом, так как участник чата @pgsql там недоступен. Тот же интерфейс инструментов также доступен из встроенного чата Cursor через сервер MCP.
Устранение неполадок в режиме агента
Если режим агента не работает должным образом, сначала проверьте режим доступа и доступность инструментов.
ИИ не может изменить базу данных
Проверьте pgsql.copilot.accessMode и убедитесь, что активное соединение не разрешается в ro.
Ожидаемое средство недоступно
Убедитесь, что интеграция Copilot включена и запущена из базы данных с допустимым контекстом подключения PostgreSQL.
Сбой запроса на подключение
Убедитесь, что профиль подключения по-прежнему существует, учетные данные доступны, и расширение может подключаться к той же базе данных вне режима агента.
Я хочу более простой рабочий процесс, в котором общение в чате стоит на первом месте
В Visual Studio Code используйте участник чата @pgsql, если вам нужны объяснения, составление запросов или ответы на вопросы о схеме без автоматизации с помощью инструментов. В Cursor задайте те же типы вопросов из собственного чата. Инструменты MCP расширения по-прежнему можно обнаружить, но чат работает в более разговорной манере без явного входа в режим агента.