다음을 통해 공유


빠른 시작: GitHub Copilot 에이전트 모드 사용

GitHub Copilot 에이전트 모드는 Visual Studio Code용 MSSQL 확장에 상황에 맞는 작업 기반 채팅 환경을 제공합니다. 에이전트 모드를 사용하면 GitHub Copilot는 제안 코드를 넘어 자연어 프롬프트 또는 기본 제공 도구를 사용하여 실제 데이터베이스 작업을 안전하게 실행할 수 있습니다. 편집기를 종료하지 않고 모든 연결을 나열하고, 특정 서버/데이터베이스에 연결하고, 스키마를 탐색할 수 있습니다.

Tip

에이전트 모드에서 SQL 도구를 사용하려는 참가자 @mssql 를 언급할 필요가 없습니다. MSSQL 확장이 활성화되면 에이전트 모드 인터페이스에서 해당 도구를 자동으로 사용할 수 있습니다. 자세한 내용은 에이전트 모드 도구를 참조하세요.

이러한 작업은 MSSQL 확장에서 제공하는 도구로 구동되며 GitHub Copilot의 에이전트 모드 내에서 직접 표시됩니다. 에이전트 모드의 작동 방식에 대한 자세한 내용은 에이전트 모드의 Visual Studio Code 설명서를 참조하세요.

에이전트 모드란?

에이전트 모드를 사용하면 GitHub Copilot가 제안 코드를 넘어설 수 있습니다. 이제 다음과 같은 채팅 변수 또는 다음과 같은 #mssql_connect자연스러운 구를 사용하여 SQL 개발 환경 내에서 안전하고 확인된 작업을 수행할 수 있습니다.

Connect to my Library database using my LocalDev profile

GitHub Copilot 에이전트 모드 채팅 인터페이스의 스크린샷.

MSSQL 에이전트 모드 도구 참조

이 섹션에서는 GitHub Copilot 에이전트 모드에서 사용할 수 있는 SQL 관련 도구에 대한 자세한 참조를 제공합니다. MSSQL 확장은 이러한 도구를 제공하여 GitHub Copilot가 채팅 변수 또는 자연어 프롬프트를 통해 작업을 실행할 수 있도록 합니다. 모든 도구는 실행 전에 사용자 확인이 필요합니다.

코필로트 에이전트 모드의 MSSQL 확장에서 제공하는 SQL 관련 도구 목록의 스크린샷

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과(와) 그 매개 변수를 사용하여 연결을 설정합니다.

서버/데이터베이스 사양을 통해 연결하는 경우:

  • 저장된 프로필이 지정된 서버와 데이터베이스 모두와 일치하는 경우:

    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 설명서를 참조하세요.