AI Assistant 패널은 선택한 DB 스키마를 근거로 AI 에게 질문하고, AI 가 만든 SQL 을 바로 실행하는 대화창입니다. 질문은 내가 등록한 API 키로 AI 제공자에게 갑니다. 무엇이 기기 외부로 나가는지는 AI 와 MCP 에서 먼저 확인하세요.
로그인하지 않으면 로컬 프로젝트에서 이 기기의 API 키 묶음의 키를 사용합니다. 패널은 프로젝트 화면 오른쪽 레일의
버튼으로 열고 닫습니다. `Ctrl+I`(macOS 는 `Cmd+I`)로도 열고 닫을 수 있고, SQL 편집기 안에서도 사용할 수 있습니다.화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | AI 모델 칸 | 대화에 사용할 API 키입니다. 목록에는 [제공자] 이름 으로 보이고, 기본 Key에는 ★ 가 붙습니다. 처음에는 기본 Key가 선택되어 있습니다. 목록 아래의 AI 모델 추가 버튼은 키를 등록하는 화면을 엽니다. |
| 2 | 새 대화 버튼 | 지금 대화를 이력에 남기고 빈 대화를 시작합니다. 응답을 받는 동안에는 클릭할 수 없습니다. |
| 3 | 대화 이력 버튼 | 프로젝트의 지난 대화 목록을 엽니다(아래 '대화 이력'). |
| 4 | 고정 버튼 | 클릭하면 패널이 작업 영역을 줄이지 않고 작업 영역 위에 표시되어 고정됩니다. 표시되어 있는 패널은 위쪽 막대를 드래그해 옮기고, 가장자리를 드래그해 크기를 변경합니다. |
| 5 | 도구 활동 | AI 가 답하기 전에 DB 에서 확인한 것입니다. 테이블 목록 확인, 테이블 정보 확인, 실행 계획 확인, 데이터 조회 같은 줄을 클릭하면 요청과 응답이 펼쳐집니다. |
| 6 | SQL 카드 | AI 가 만든 SQL 한 문장입니다. 번호, 문장 종류, 제목과 실행, SQL 편집기 열기, 복사 버튼이 있습니다. |
| 7 | 실행 결과 표시 | 카드의 SQL 을 실행한 결과입니다. 반환한 행 수나 영향을 준 행 수가 함께 보이고, 클릭하면 결과 표가 펼쳐집니다. 표에는 처음 100행까지 보입니다. |
| 8 | 컨텍스트 표시 | 이번 질문에서 AI 가 볼 수 있는 스키마입니다. 마우스를 올리면 커넥션, 데이터베이스, 스키마 전체가 보이고, × 로 제외합니다. 자물쇠 표시는 편집기, ERD 에서 맡긴 일의 대상이라 제외할 수 없습니다. |
| 9 | Database Schema 선택 버튼 | 컨텍스트를 선택하는 창을 엽니다. |
| 10 | 전송 버튼 | 메시지를 보냅니다. 응답을 받는 동안에는 응답 생성 중지 버튼으로 변경됩니다. |
- 입력란에서
Enter는 보내기,Shift+Enter는 줄 바꿈입니다(Enter 전송 · Shift+Enter 줄바꿈 안내). 입력란이 비어 있을 때↑,↓를 클릭하면 대화에서 보낸 메시지를 다시 불러옵니다. - 등록한 키가 하나도 없으면 빈 대화 자리에 AI 모델 추가 버튼이 보이고, 입력란은 사용할 수 없습니다.
자연어로 SQL 받기
- 버튼을 클릭하거나 `Ctrl+I` 를 누릅니다.
- AI 모델 칸(1)에서 사용할 키를 선택합니다. 기본 Key로 충분하면 그대로 둡니다.
- Database Schema 선택 버튼(9)을 클릭해 질문에 사용할 스키마를 선택하고 적용 버튼을 클릭합니다(아래 '컨텍스트 선택하기').
- 입력란에 하고 싶은 일을 적고
Enter를 누릅니다. 예: "지난달 매출이 가장 많은 상품 5개", "리뷰가 없는 고객 목록". - AI 가 필요한 테이블을 확인한 뒤(5) 설명과 SQL 카드(6)로 답합니다.
- 응답이 끝나면 SELECT 카드는 바로 실행되어 결과(7)가 붙습니다. 데이터나 스키마를 변경하는 카드는 아래 표의 조건에 따라 기다리거나 실행됩니다.
- 컨텍스트를 선택하지 않고 보내면 AI가 참고할 DB를 선택해 주세요 창이 표시됩니다. DB 선택 버튼을 클릭하면 컨텍스트 창이 열리고, 선택한 뒤 다시 보내면 됩니다.
- 응답을 받는 동안에는 키와 컨텍스트를 변경할 수 없습니다. 멈추려면 응답 생성 중지 버튼을 클릭합니다.
- AI 에게 함께 보내는 지난 대화는 대화의 최근 메시지 29개까지입니다. 그보다 오래된 내용은 AI 가 보지 못합니다.
- 응답 언어와 모든 응답에 붙일 공통 지침은 제공자 및 API 키 의 화면에서 정합니다.
컨텍스트 선택하기
컨텍스트는 이번 질문에서 AI 가 볼 수 있는 범위의 전부입니다. AI 의 도구는 선택하지 않은 스키마에 접근하지 않습니다.
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 검색 칸 | 커넥션이나 스키마 이름으로 목록을 줄입니다(Connection 또는 Schema 검색). |
| 2 | 전체 선택, 전체 해제 버튼 | 보이는 스키마를 모두 선택하거나 모두 해제합니다. |
| 3 | 커넥션, 데이터베이스, 스키마 목록 | 커넥션이나 데이터베이스의 체크 상자는 아래 항목을 한꺼번에 선택합니다. |
| 4 | 적용 버튼 | 선택한 것을 입력란의 컨텍스트 표시로 옮깁니다. 취소 버튼은 변경한 것을 버립니다. |
- 목록에는 프로젝트 AI 설정 에서 사용 항목을 활성화한 커넥션의, 커넥션 설정에서 선택한 스키마만 나옵니다. 비활성화한 커넥션과 DB 접속 정보가 없는 설계 전용 커넥션은 나오지 않습니다. 선택할 것이 없으면 사용 가능한 Schema가 없습니다. 안내가 보입니다.
- 새 대화는 프로젝트 AI 설정에서 기본 항목으로 정한 스키마를 미리 선택해 둡니다. 정한 것이 없으면 빈 채로 시작합니다.
SQL 카드 실행
응답이 끝나면 NeoSQL 은 카드를 위에서부터 차례로 살펴 아래 조건에 맞는 카드를 실행합니다. 실행하지 않은 카드는 실행 버튼으로 직접 실행합니다.
| 문장 | 응답이 끝났을 때 | 실행 버튼을 클릭하면 |
|---|---|---|
| SELECT | 바로 실행합니다 | 다시 실행합니다 |
| INSERT, UPDATE, DELETE 같은 데이터 변경 | 커넥션의 데이터 변경 항목이 활성화되어 있으면 실행하고, 비활성화되어 있으면(기본) 기다립니다 | 실행 확인 창에서 실행 버튼을 클릭하면 실행합니다. 창의 SQL 보기 버튼으로 전체 SQL 을 볼 수 있습니다 |
| CREATE, ALTER, DROP 같은 스키마 변경 | 스키마 변경 항목이 활성화되어 있으면 실행하고, 비활성화되어 있으면(기본) 기다립니다 | 실행 확인 창에서 실행 버튼을 클릭하면 실행합니다 |
| 종류를 알 수 없는 문장 | 실행하지 않습니다 | 실행하지 않습니다 |
- 위 표보다 커넥션의 보호 모드 항목이 먼저입니다. 읽기 전용 (SELECT 외 차단) 항목이면 SELECT 가 아닌 문장은 실행하지 않고, 확인 (DDL + 위험 DML) 항목이면 정책과 상관없이 실행 전에 확인합니다. 계정 프로젝트에서 DDL 제한 권한이 걸린 사용자는 스키마 변경을 실행할 수 없습니다.
- 카드의 SQL 은 카드에 적힌 커넥션, 데이터베이스, 스키마에서 자동 커밋으로 실행합니다. SQL 편집기 탭의 트랜잭션과 상관없이 바로 반영되므로 되돌릴 수 없습니다.
- 실행 결과는 패널에만 남고 AI 제공자로 보내지 않습니다. 실행한 SQL 은 SQL 이력과 저장된 SQL 에 AI 가 실행한 것으로 남습니다.
- SQL 편집기 열기 버튼은 카드의 SQL 을 담은 새 SQL 문서를 같은 커넥션, 스키마로 만들어 엽니다. 수정해서 실행하거나 보관할 때 사용합니다.
실제 데이터 조회 승인
AI 가 답을 만들려고 실제 행의 값을 읽어야 할 때, 커넥션의 데이터 전송 허용 항목이 비활성화되어 있으면 대화에 승인 카드가 표시됩니다. 새 커넥션에서는 기본으로 활성화되어 있으므로, 처음에는 카드 없이 조회합니다.
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 조회 SQL | AI 가 실행하려는 SELECT 한 문장입니다. 승인하면 결과가 AI 제공자로 갑니다. |
| 2 | 이후 조회 자동 승인 체크 상자 | 활성화하고 승인하면 프로젝트를 열어 둔 동안 다음 조회부터 카드 없이 승인합니다. 저장되지 않아 프로젝트를 다시 열면 다시 묻습니다. |
| 3 | 승인, 거절 버튼 | 거절하면 응답 만들기가 멈춥니다. 새 메시지를 보내 대화를 이어 갈 수 있습니다. |
- AI 가 직접 실행하는 조회는 읽기 전용 SELECT 한 문장, 최대 10행, 30초 제한입니다.
- 계정 프로젝트에서 이후 조회 자동 승인 체크 상자는 프로젝트 소유자에게 보이고, 소유자가 아닌 멤버에게는 프로젝트 AI 설정의 프로젝트 비소유자의 데이터 전송 지속 승인을 허용 항목이 활성화되어 있을 때만 보입니다.
HTML 응답 열기
보고서나 차트처럼 화면으로 보는 결과를 요청하면 AI 가 HTML 문서로 답하기도 합니다. 응답에는 문서 제목과 HTML 열기 버튼이 보입니다.
- 응답의 HTML 열기 버튼을 클릭합니다. 작업 영역에 탭이 열립니다.
- 탭 위에 마우스를 올리면 오른쪽 위에 버튼이 나타납니다. 브라우저에서 열기 버튼(1), HTML 다운로드 버튼(2), 인쇄 버튼(3)이 있습니다.
- 미리보기는 격리된 틀 안에서 그립니다. 문서의 스크립트는 실행되지만 외부 파일을 읽거나 네트워크로 통신하지 못합니다.
- 브라우저에서 열기 버튼은 데스크톱에서는 운영체제의 기본 HTML 앱으로, 웹에서는 브라우저의 새 탭으로 엽니다.
- HTML 탭은 저장되지 않습니다. 남겨 두려면 HTML 다운로드 버튼으로 파일을 받으세요.
ERD 로 테이블 설계하기
"주문 반품을 관리할 테이블을 ERD 에 설계해 줘" 처럼 ERD 에 만들어 달라고 분명히 요청하면, AI 는 SQL 대신 ERD 도구를 사용합니다. 도구 활동에 ERD 테이블 생성 줄이나 ERD 테이블 수정 줄이 남습니다.
- 결과는 대화와 커넥션, 스키마마다 새로 만드는 ERD 에 저장되고, ERD 가 열립니다. 같은 대화에서 다시 요청하면 같은 ERD 에 더합니다.
- ERD 도구는 DB 를 변경하지 않습니다. 검토한 뒤 DB 반영 으로 실제 DB 에 만드세요.
- ERD 에 만들지 DB 에 만들지 분명하지 않으면 AI 가 되묻습니다.
대화 이력
패널 위쪽의 대화 이력 버튼을 클릭하면 패널이 프로젝트의 지난 대화 목록으로 변경됩니다. 대화마다 제목과 마지막 활동 시각이 보입니다.
- 두 번 클릭하거나
Enter를 누르면 대화를 엽니다. Ctrl(macOS 는Cmd)을 누른 채 클릭하면 여러 개를,Shift를 누른 채 클릭하면 범위를 선택합니다.- 우클릭하면 이름 변경 항목과 대화 삭제 항목이 있습니다. 삭제는 되돌릴 수 없습니다.
- 대화는 계정 프로젝트면 내 계정(NeoSQL 서버)에, 로컬 프로젝트면 기기에 저장됩니다.
주의할 점
- SELECT 카드는 응답이 끝나자마자 DB 에서 실행됩니다. 큰 테이블을 훑는 SELECT 도 그대로 실행되므로, 운영 DB 의 커넥션에서는 보호 모드 항목을 사용하거나 권한이 좁은 DB 계정으로 연결하세요(운영 DB 안전장치).
- AI 가 실행한 SQL 은 자동 커밋입니다. 데이터 변경 항목과 스키마 변경 항목을 활성화하면 변경 SQL 도 확인 없이 바로 반영됩니다.
- 데이터 전송 허용 항목은 새 커넥션에서 활성화되어 있습니다. 실제 행의 값이 AI 제공자로 가는 것을 매번 확인하려면 프로젝트 AI 설정 에서 비활성화하세요.
- 질문에 비밀번호, 토큰, 개인정보를 직접 적지 마세요. 질문과 지난 대화는 그대로 AI 제공자로 갑니다.
- 웹에서는
http주소나localhost, 사설 IP 주소를 사용하는 키가 AI 모델 칸에 나오지 않습니다. 데스크톱에서만 사용하는 키입니다.
관련 화면
- 제공자 및 API 키: 키를 등록하고, 응답 언어와 사용량을 보는 화면입니다.
- 프로젝트 AI 설정: 커넥션마다 AI 사용 여부와 자동 실행, 데이터 전송 승인을 정합니다.
- 편집기와 ERD 의 AI 기능: 쿼리 튜닝, SQL 오류 질문, 샘플 데이터를 AI Assistant 패널로 맡기는 방법입니다.
- AI 와 MCP: AI 제공자로 넘어가는 데이터와 키의 종류입니다.
- SQL 이력과 저장된 SQL: AI 가 실행한 SQL 이 남는 곳입니다.
- DB 반영: AI 가 ERD 에 설계한 테이블을 실제 DB 에 만듭니다.