Поделиться через

Краткое руководство: Использование режима Агент GitHub Copilot

Режим агента позволяет GitHub Copilot использовать средства, доступные в расширении MSSQL для Visual Studio Code. Когда расширение установлено и активно, Copilot может перечислить подключения SQL Server, подключиться к серверу и базе данных и получить метаданные базы данных.

Все действия используют тот же контекст подключения и учетные данные, что и расширение MSSQL. Режим агента не содержит дополнительных изменений проверки подлинности или разрешений.

Tip

При использовании режима агента не нужно явно ссылаться на расширение MSSQL (@mssql). Если расширение активно, его средства доступны автоматически. Дополнительные сведения см. в разделе "Средства режима агента".

Дополнительные сведения о выборе и выполнении средств в режиме агента см. в документации Visual Studio Code по режиму агента.

Что такое режим агента?

Режим агента позволяет GitHub Copilot выполнять действия, связанные с SQL, с помощью расширения MSSQL, а до выполнения требуется подтверждение пользователя.

Эти действия можно вызвать с помощью таких переменных чата, как #mssql_connect, например, или путем выдачи эквивалентных запросов естественного языка, например:

Connect to my Library database using my LocalDev profile

Снимок экрана интерфейса режима агента GitHub Copilot.

Справочник по инструменту режима агента MSSQL

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

Снимок экрана – список инструментов, специфичных для SQL, внесенных расширением MSSQL в режиме агента Copilot.

Tip

Вы также можете использовать переменные чата, такие как #mssql_connect, чтобы напрямую вызвать эти средства или писать запросы на естественном языке, например, таким образом:

Connect to my development database

GitHub Copilot автоматически обрабатывает выбор инструмента.

Управление подключениями

Имя инструмента Description
connect Подключается к базе данных с помощью сохраненного профиля подключения или указанного сервера и базы данных.
disconnect Завершает текущий активный сеанс подключения.
change_database Изменяет базу данных для существующего сеанса подключения.
get_connection_details Возвращает сведения о конкретном подключении MSSQL.
list_servers Выводит список всех сохраненных профилей подключений SQL Server в вашей среде.
list_databases Выводит список всех доступных баз данных для подключенного сервера MSSQL.

Examples

Используйте следующие фразы для взаимодействия с GitHub Copilot.

- Connect to my LocalDev environment
- Disconnect from my current database
- List my available connection profiles
- List all databases in the localhost server
- Set the active connection to localhost
- Set AdventureWorks as the active database
- Get the connection string for AdventureWorks on localhost

Снимок экрана: пример использования средства агента для подключения к базе данных в чате GitHub Copilot.

Принцип работы логики подключения

Режим агента GitHub Copilot поддерживает гибкие способы подключения к базе данных SQL, ссылаясь на сохраненные профили или указав сервер и базу данных напрямую. Вот как работает логика подключения.

При подключении с сохраненным профилем:

  1. Вы подключаетесь, ссылаясь на имя сохраненного профиля подключения.
  2. GitHub Copilot использует mssql_list_servers средство для проверки наличия профиля.
  3. Затем средство mssql_connect использует сохраненные profileId и их параметры для установления соединения.

При подключении путем указания сервера и базы данных:

  • Если сохраненный профиль соответствует указанному серверу и базе данных:

    1. GitHub Copilot используется mssql_list_servers для поиска совпадения.
    2. Затем вызывает mssql_connect с использованием полного профиля.

  • Если сохраненный профиль соответствует только серверу:

    1. GitHub Copilot находит соответствующий профиль сервера.
    2. Он пытается подключиться, подставив запрошенную пользователем базу данных в этот профиль.
    3. Если соединение не удалось, отображается сообщение об ошибке.

  • Если профиль не соответствует указанному серверу:

    • GitHub Copilot сообщает об ошибке.

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

Исследование схемы

Имя инструмента Description
show_schema Отображает высокоуровневую схему схемы подключенной базы данных, включая таблицы и связи.
list_schemas Выводит список всех схем в базе данных для подключенного сервера MSSQL.
list_tables Выводит список всех таблиц в базе данных для подключенного сервера MSSQL.
list_views Выводит список всех представлений в базе данных для подключенного сервера MSSQL.
list_functions Перечисляет все функции в базе данных для подключенного сервера MSSQL.

Examples

Используйте следующие фразы для взаимодействия с GitHub Copilot.

- Show me the schema for this database
- Show me all tables in the current database
- List all views from this MSSQL database
- Give me a list of all the functions available in this schema
- What schemas are available in this database?

Снимок экрана: анимация, показывающая средство визуализатора схемы базы данных в режиме агента Copilot.

Выполнение запросов

Имя инструмента Description
run_query Выполняет SQL-запрос к подключенной базе данных.

Examples

Используйте следующие фразы для взаимодействия с GitHub Copilot.

- Give me the top five posts published this week
- Execute the current file to find how many comments each post has
- Get all categories along with the number of posts in each

Снимок экрана: пример использования средства агента для подключения к базе данных и получения данных.

Снимок экрана: другой пример использования средства агента для подключения к базе данных и получения данных.

Управление инструментами в режиме агента

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

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

Дополнительные сведения о видимости и утверждениях инструментов см. в разделе "Управление утверждениями инструментов".

Рабочий процесс подтверждения режима агента

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

  • Разрешить в этом сеансе
  • Разрешить в этой рабочей области
  • Всегда разрешать

Этот шаг подтверждения помогает обеспечить безопасное, преднамеренное взаимодействие с средой разработки.

Note

Дополнительные сведения о том, как подтверждение работает во всех средствах в режиме агента, см. в документации по Visual Studio Code по утверждениям инструментов.

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

  • Last updated on