에이전트 모드를 사용하면 편집기의 AI 도우미가 단일 다단계 대화의 일부로 확장의 PostgreSQL 도구를 사용할 수 있습니다. 도우미는 질문에 대답하는 대신 데이터베이스에 연결하고, 스키마를 검사하고, 쿼리를 실행하고, 스크립트를 열고, 워크플로를 끝까지 이동할 수 있습니다.
에이전트 모드는 Visual Studio Code(GitHub Copilot 포함) 및 커서(기본 제공 AI 포함)에서 실행됩니다. 확장은 두 편집기에서 동일한 PostgreSQL 도구 화면을 노출합니다. 열리는 채팅 패널만 다릅니다.
AI가 SQL을 설명하거나 초안을 작성하는 것이 아니라 구조화된 작업을 수행하도록 하려면 에이전트 모드를 사용합니다.
필수 조건
시작하기 전에 다음이 있는지 확인합니다.
- PostgreSQL 확장이 설치되었습니다.
- 확장에서 활성화된 Copilot/AI 기능(
pgsql.copilot.enable는true입니다). - 확장에 구성된 데이터베이스 연결이 하나 이상 있습니다.
- 편집기에서 사용할 수 있는 AI 도우미:
- Visual Studio Code: GitHub Copilot 또는 GitHub Copilot 채팅을 설치하고 활성화합니다.
- 커서: 추가 설치 없음; 기본 제공 AI는 자동으로 사용됩니다.
에이전트 모드 시작
- PostgreSQL 확장의 대상 서버 또는 데이터베이스에 연결합니다.
- 연결 트리에서 사용할 데이터베이스를 마우스 오른쪽 단추로 클릭합니다.
- AI 연결을 선택합니다.
- 완료하려는 워크플로를 사용하여 열리는 채팅 패널에서 대화를 계속합니다.
- Visual Studio Code 에이전트 모드의 GitHub Copilot Chat 패널입니다.
- 커서에서 커서의 네이티브 AI 패널입니다. 확장은 도우미가 사용 가능한 PostgreSQL 도구에 대해 알 수 있도록 간단한 MCP 지향 프리앰블을 제공합니다.
세션이 시작된 후 AI는 요청을 통해 작동할 때 백그라운드에서 PostgreSQL 도구를 결합할 수 있습니다.
올바른 액세스 모드 선택
이 설정은 pgsql.copilot.accessMode 에이전트 모드에서 수신하는 데이터베이스 액세스의 양을 제어합니다. 설정 ID는 호환성을 위해 pgsql.copilot.* 접두사를 유지합니다. 사용자에게 표시되는 레이블은 Visual Studio Code에서는 Copilot access mode이고 Cursor에서는 AI access mode입니다.
| 모드 | AI가 수행할 수 있는 일 | 권장 사용 |
|---|---|---|
ro |
SELECT, SHOW, EXPLAIN, 스키마 검사 및 분석과 같은 읽기 전용 작업 |
변경하지 않고 조사하려는 프로덕션 시스템 또는 공유 환경 |
rw |
읽기 작업과 데이터 수정 명령문 및 DDL, 실행 전에 명시적으로 확인 | 로컬 개발, 일회용 샌드박스 및 제어된 테스트 환경 |
Caution
의도적으로 Agent 모드를 통해 스키마 또는 데이터 변경을 가능하게 하려는 경우가 아니라면, 프로덕션 데이터베이스에는 ro 모드를 사용하세요.
도구 패밀리 이해
에이전트 모드는 워크플로에 따라 여러 도구 패밀리를 사용할 수 있습니다.
| 도구 패밀리 | 용도 | 사용하는 경우 |
|---|---|---|
| 연결 도구 | 프로필 나열, 연결, 연결 끊기, 데이터베이스 나열 | 컨텍스트 시작 또는 전환 |
| 스키마 컨텍스트 도구 | 개체 정의를 가져오거나 스키마 시각화 | 테이블, 뷰, 함수, 인덱스 및 관계 이해 |
| 쿼리 도구 | 읽기 쿼리 실행, 쿼리 계획 검사, 스크립트 열기 | 데이터 조사, 아이디어 유효성 검사 또는 생성된 SQL 검토 |
| 수정 도구 | 확인을 사용하여 DDL 또는 DML 실행 |
rw 모드에서 제어된 스키마 또는 데이터 변경 적용 |
| 데이터 가져오기 도구 | CSV 파일 설명 및 대량 로드하기 | CSV 가져오기 워크플로 계획 및 실행 |
Tip
커서에서 MCP 서버 등록을 통해 동일한 도구가 표시됩니다. 커서의 네이티브 채팅은 CONNECT AI 진입점을 사용하지 않고 직접 호출할 수 있습니다. 자세한 내용은 MCP 서버를 참조하세요.
일반적인 워크플로에 에이전트 모드 사용
다음 예제에서는 새 데이터베이스 탐색에서 쿼리 구체화에 이르기까지 다양한 작업에 에이전트 모드를 사용하는 방법을 보여 줍니다.
익숙하지 않은 데이터베이스 살펴보기
AI에 데이터베이스에 연결하고, 주요 개체를 나열하고, 작업에 중요한 스키마 영역을 요약하도록 요청합니다.
Example:
내 개발 데이터베이스에 연결하고, public 스키마의 테이블 목록을 보여 주고, 그중 어떤 테이블이 고객 및 주문과 관련 있어 보이는지 알려 주세요.
쿼리 성능 조사
AI에 쿼리 실행 또는 계획 검사와 스키마 컨텍스트를 결합하도록 요청합니다.
Example:
준비 데이터베이스에 연결하고, 읽기 전용 모드에서 이 쿼리를 실행하고, 실행 계획의 어느 부분이 비용을 유발하고 있는지 설명합니다.
데이터 로드 또는 모양 바꾸기
워크플로에 스크립트 또는 CSV 기반 작업이 포함된 경우 에이전트 모드를 사용합니다.
Example:
이 CSV 파일을 검토하고, 스키마가 의미하는 바를 알려주고, 테이블에 대한
sales.records안전한 가져오기 계획을 준비합니다.
초안에서 수동 검토로 이동
실행하기 전에 사용자 검토 검사점을 원하는 경우 AI에 즉시 실행하는 대신 쿼리 편집기에서 생성된 SQL을 열도록 요청합니다.
@pgsql 대신 에이전트 모드를 사용해야 하는 경우
스키마 인식 답변 또는 쿼리 초안을 원하는 경우 @pgsql 채팅 참가자 를 사용합니다. 참가자는 @pgsqlVisual Studio Code만 사용할 수 있습니다.
AI가 다음을 수행하도록 하려면 에이전트 모드(Visual Studio Code 및 커서 모두에서 사용 가능)를 사용합니다.
- 사용자에게 적합한 데이터베이스에 연결합니다,
- 한 대화에서 여러 도구를 연결합니다.
- 다음 단계 전에 결과를 검사하거나
- 스크립트 또는 제어된 수정 워크플로를 준비합니다.
메모
커서에서는 채팅 참가자를 사용할 수 없으므로 @pgsql 에이전트 모드가 기본 경로입니다. MCP 서버를 통해 커서의 네이티브 채팅에서도 동일한 도구 화면에 연결할 수 있습니다.
에이전트 모드 문제 해결
에이전트 모드가 예상대로 작동하지 않는 경우 먼저 액세스 모드 및 도구 가용성을 확인합니다.
AI가 데이터베이스를 수정할 수 없습니다.
pgsql.copilot.accessMode을 확인하고 활성 연결이 ro로 해석되지 않는지 확인합니다.
예상되는 도구를 사용할 수 없습니다.
Copilot 통합을 사용하도록 설정하고 유효한 PostgreSQL 연결 컨텍스트가 있는 데이터베이스에서 시작했는지 확인합니다.
연결 요청 실패
연결 프로필이 여전히 존재하는지, 자격 증명을 사용할 수 있는지, 확장이 에이전트 모드 외부의 동일한 데이터베이스에 연결할 수 있는지 확인합니다.
더 간단한 채팅 우선 워크플로를 원합니다.
Visual Studio Code 도구 기반 자동화 없이 설명, 쿼리 초안 작성 또는 스키마 질문을 원하는 경우 @pgsql 채팅 참가자를 사용합니다. 커서에서 네이티브 채팅에서 동일한 종류의 질문을 합니다. 확장의 MCP 도구는 여전히 검색할 수 있지만 채팅은 명시적 에이전트 모드 항목 없이 대화 방식으로 동작합니다.