AI Assistant 는 내가 등록한 API 키로 AI 제공자의 모델을 호출하고, 비용도 등록한 키에서 나갑니다. 메뉴에서 키를 등록하고, 응답 언어를 정하고, 사용량을 봅니다. 키가 저장되는 곳과 AI 제공자로 넘어가는 데이터는 AI 와 MCP 에서 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
마이페이지는 헤더 오른쪽의 사용자 표시를 클릭하고 마이페이지 항목을 클릭해 엽니다. 메뉴를 펼치면
화면, 화면, 화면이 있습니다. 로그인하지 않아도 세 화면은 잠기지 않습니다. AI Assistant 패널의 키 목록 아래 AI 모델 추가 버튼을 클릭해도 화면이 열리고, 등록한 키가 하나도 없으면 바로 등록 창이 표시됩니다.화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 메뉴 | 펼치면 하위 화면 세 개가 보입니다. |
| 2 | 계정 API 키 묶음 | 내 계정에 암호화되어 저장되는 키입니다. 로그인했을 때만 보입니다. 다른 기기와 웹에서도 같은 키를 사용합니다. |
| 3 | 키 카드 | 제공자, 이름, 기본 Key 표시(★), 끝 네 자리만 보이는 키, 편집 버튼과 삭제 버튼이 있습니다. 빈 별(☆)을 클릭한 키가 묶음의 기본 Key가 됩니다. 비활성화해 둔 키에는 비활성 표시가 붙습니다. |
| 4 | 설정 | 키로 호출할 모델, 한 번에 받을 응답 길이의 상한(Max output tokens), 월 예산 항목(계정 API 키 묶음만), 직접 지정한 주소입니다. |
| 5 | 최근 30일 사용량 | 키의 호출 수, 추정 비용, 입력, 출력 토큰입니다. 계정 API 키 묶음의 키에 월 예산이 있으면 이번 달 비용과 예산의 막대가 보입니다. |
| 6 | 이 기기의 API 키 묶음 | 기기에만 저장되는 키입니다. 데스크톱에서만 보입니다. 키 원문은 운영체제의 보안 저장소에 둡니다. |
| 7 | Key 추가 버튼 | 묶음에 키를 등록하는 창을 엽니다. |
환경마다 보이는 묶음과 AI Assistant 에서 선택할 수 있는 키가 다릅니다. 프로젝트 종류와는 상관없습니다.
| 환경 | 보이는 묶음 | AI Assistant 에서 선택할 수 있는 키 |
|---|---|---|
| 웹 | 계정 API 키 묶음 | 계정 API 키 묶음. 단 http 주소나 localhost, 사설 IP 주소를 사용하는 키는 빠집니다 |
| 데스크톱, 로그인하지 않음 | 이 기기의 API 키 | 이 기기의 API 키 |
| 데스크톱, 로그인 | 계정 API 키 묶음과 이 기기의 API 키 | 둘 다 |
- 기본 Key는 묶음마다 하나입니다. AI Assistant 는 계정 API 키 묶음의 기본 Key를 먼저 사용하고, 없으면 이 기기의 API 키 묶음의 기본 Key를 사용합니다.
- 비활성화해 둔 키는 AI Assistant 의 키 목록에 나오지 않습니다.
API 키 등록하기
- 키를 둘 묶음의 Key 추가 버튼(7)을 클릭합니다. 묶음에 키가 없으면 가운데의 첫 Provider 추가 버튼을 클릭합니다.
- 제공자를 선택하고 API 키를 붙여 넣습니다. 키 칸 아래 링크로 제공자의 키 발급 화면을 열 수 있습니다.
- 사용 모델 칸에서 모델을 선택합니다. 목록은 선택한 제공자의 모델입니다. 날짜가 붙은 고정 버전까지 보려면 snapshot 체크 상자를 활성화합니다.
- 필요하면 별칭 (선택) 칸, Max output tokens 칸, 월 예산 칸(계정 API 키 묶음만)을 적습니다.
- 연결 테스트 버튼으로 키와 주소가 맞는지 확인하고 저장 버튼을 클릭합니다.
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 활성화 스위치 | 비활성화하면 키로 AI 를 호출하지 않습니다. 기본 Key는 비활성화할 수 없습니다. |
| 2 | 기본 Key로 설정 스위치 | 활성화하면 묶음의 기본 Key가 됩니다. 묶음의 첫 키는 자동으로 기본 Key가 됩니다. |
| 3 | Provider 칸 | 이 기기의 API 키 묶음의 키는 OpenAI, Claude(Anthropic), Gemini(Google), Ollama 가운데 선택합니다. 계정 API 키 묶음의 키는 NeoSQL 서버가 주는 목록에서 선택합니다. 등록한 뒤에는 변경할 수 없습니다. |
| 4 | 사설 endpoint 칸 | Ollama 는 서버 주소가 필요합니다. 다른 제공자는 사내 게이트웨이나 프록시처럼 기본 주소가 아닌 곳을 거칠 때만 적습니다. 데스크톱 전용 주소를 적으면 칸 옆에 안내가 붙습니다. |
| 5 | 사용 모델 칸 | AI Assistant 가 키로 호출할 모델입니다. 이 기기의 API 키 묶음의 키와 Ollama 는 목록에 없는 모델 이름도 직접 적을 수 있습니다. |
| 6 | Max output tokens 칸 | AI 가 한 번에 만드는 응답 길이의 상한입니다. 너무 작으면 SQL 이 잘리고, 크면 비용과 시간이 늘어납니다. 칸 옆 도움말은 4096 을 권합니다. |
- 편집할 때 API Key 칸을 비워 두면 저장된 키를 그대로 사용합니다. 새 값을 적으면 변경됩니다.
- 기본 Key는 삭제할 수 없습니다. 다른 키를 기본 Key로 정한 뒤 삭제하세요. 삭제한 키의 지난 사용 기록은 보존됩니다.
- 월 예산 항목은 미국 달러로 적고, 비우면 제한이 없습니다. 월 추정 비용이 예산을 넘으면 키로 AI 를 호출하지 못합니다. 이 기기의 API 키 묶음의 키에는 예산이 없습니다.
기기나 사내에서 실행하는 모델 사용하기
Ollama 처럼 기기나 사내 서버에서 실행하는 모델도 키로 등록합니다. Ollama 는 Ollama 연결 방식 항목에서 직접 호스팅 항목과 Ollama Cloud 항목 가운데 선택합니다.
- Provider 칸에서 Ollama 를 선택하고 Ollama 연결 방식 항목을 직접 호스팅 항목으로 둡니다.
- 사설 endpoint 칸에 서버 주소를 적습니다. 기기의 Ollama 는
http://localhost:11434입니다. - 모델 조회 버튼을 클릭해 서버의 모델 목록을 읽고, 사용 모델 칸에서 선택합니다. 모델 정보 영역을 펼치면 처리 위치 항목, 크기 항목, 최대 컨텍스트 (토큰) 항목이 보입니다.
- 서버에 인증이 걸려 있으면 서버 인증 사용 체크 상자를 활성화하고 접근 키를 적은 뒤 저장합니다.
AI 를 호출하는 요청은 데스크톱에서는 기기에서, 웹에서는 NeoSQL 서버에서 나갑니다. 사용할 AI 서버의 주소에 맞는 환경을 선택합니다.
| 주소 | 사용하는 환경 |
|---|---|
https 공개 주소 | 웹과 데스크톱 |
http 주소 | 데스크톱 |
localhost, 사설 IP(10.x, 192.168.x 등) | 해당 주소에 접속할 수 있는 기기의 데스크톱 앱 |
http,localhost, 사설 IP 주소도 계정 API 키 묶음에 등록할 수 있습니다. 등록 창에 데스크톱 전용 안내가 붙고, 등록한 키는 데스크톱에서만 모델 조회와 AI 호출에 사용합니다.- 직접 호스팅한 Ollama 도 Cloud 모델을 호출할 수 있습니다. 주소만으로 처리 위치가 기기라고 보장되지 않으니 모델 정보 영역의 처리 위치 항목을 확인하세요.
- AI Assistant 에는 도구 호출을 지원하는 모델을 사용합니다. 지원 여부는 모델 정보 영역에서 확인합니다.
- Ollama 의 사용량은 토큰과 호출 수로 확인합니다.
응답 언어와 공통 지침
화면에서 AI 응답에 함께 적용할 설정을 정합니다.| 항목 | 설명 |
|---|---|
| 응답 언어 칸 | 자동 항목이면 질문한 언어로 답합니다. 언어를 선택하면 질문의 언어와 상관없이 선택한 언어로 답합니다. SQL 과 식별자는 변경되지 않습니다. |
| 응답 지침 칸 | 모든 응답에 덧붙일 지침입니다. NeoSQL 의 기본 지침 뒤에 붙고, 보안 정책이나 실행 제한, 응답 언어는 변경하지 못합니다. |
- 저장 버튼을 클릭하면 다음 요청부터 적용됩니다.
- 로그인하면 내 계정에, 로그인하지 않으면 기기에 저장됩니다.
사용량 보기
화면은 최근 30일의 AI 호출을 모아 보여 줍니다.| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 계정 API 키 묶음 사용량 | 계정 API 키 묶음의 활성 키 항목, 30일 호출 항목, 30일 비용 (추정) 항목, 이번 달 산정 비용 항목입니다. 모든 키에 월 예산이 있으면 예산 합계 대비 막대가 보입니다. 로그인했을 때만 보입니다. |
| 2 | 기능별 표 | 기능은 자연어로 SQL 생성, Query Tuning, Sample Data 생성, SQL 오류 질문 항목으로 나뉩니다. 기능마다 호출 열, 입력 열, 캐시 읽기 열, 출력 열, 추론 열, 비용 (추정) 열입니다. 캐시 읽기 열과 추론 열은 입력, 출력 열에 들어가지 않는 별도 값입니다. |
| 3 | 이 기기의 API 키 사용량 | 이 기기의 API 키 묶음의 키로 호출한 30일 호출 항목과 토큰을 모델별로 보여 줍니다. 데스크톱에서만 보입니다. 비용은 계산하지 않습니다. |
- 사용량은 NeoSQL 이 기록한 요청과 응답으로 집계합니다. 비용은 추정이므로 실제 청구액은 제공자의 콘솔에서 확인하세요.
- MCP 로 외부 AI 가 NeoSQL 을 호출한 것은 NeoSQL 이 모델을 호출하지 않으므로 여기에 기록되지 않습니다.
주의할 점
- 계정 API 키 묶음의 키는 NeoSQL 서버에 암호화되어 저장되고, 웹과 로그인한 모든 기기에서 사용됩니다. 로그아웃해도 계정에 보존됩니다.
- 이 기기의 API 키 묶음의 키는 운영체제 보안 저장소에만 있습니다. 다른 기기로 옮겨지지 않고, 웹에서는 사용할 수 없습니다.
- 운영체제 보안 저장소를 사용할 수 없는 환경(키체인이 없는 Linux 등)에서는 이 기기의 API 키 묶음의 키가 평문으로 저장됩니다. 이때는 저장하기 전에 API 키가 암호화되지 않습니다 확인 창이 표시됩니다.
- 월 예산 항목은 NeoSQL 이 추정한 비용으로 판단합니다. 제공자의 실제 청구와 다를 수 있으니 제공자 쪽에도 한도를 걸어 두세요.
- 키를 등록한 묶음은 나중에 변경할 수 없습니다. 계정 API 키 묶음의 키를 이 기기의 API 키 묶음으로 옮기려면 이 기기의 API 키 묶음에 새로 등록하세요.
관련 화면
- AI Assistant: 등록한 키를 선택해 대화하는 패널입니다.
- AI 와 MCP: 계정 API 키 묶음과 이 기기의 API 키 묶음의 차이, AI 제공자로 넘어가는 데이터입니다.
- 프로젝트 AI 설정: 커넥션마다 AI 사용을 허용하는 창입니다.
- 보안과 데이터가 나가는 곳: 키가 저장되는 곳과 기기 외부로 나가는 통신입니다.