AI Provider Key 설정

사용할 LLM Provider Key를 등록하고 AI Assistant의 모델, 응답 옵션, 월 예산과 Endpoint를 관리합니다.

지원 Provider

같은 Provider의 키를 여러 개 등록할 수 있으며 각 키마다 모델과 옵션을 따로 설정할 수 있습니다.

Provider	API Key	Endpoint
OpenAI	필수	기본 또는 사용자 지정
Anthropic	필수	기본 또는 사용자 지정
Google Gemini	필수	기본 또는 사용자 지정
Ollama	선택	기본 또는 사용자 지정

Provider Key 등록

AI Provider API Keys 화면에서 사용할 Key를 추가합니다.

AI 설정 열기

오른쪽 위 사용자 메뉴에서 마이페이지를 열고 AI 설정을 선택합니다.

Key 추가

첫 Provider 추가 또는 Key 추가를 누르고 Provider를 선택합니다. 같은 Provider를 여러 개 등록한다면 별칭을 입력해 구분할 수 있습니다.

API Key와 모델 확인

Provider에서 발급한 API Key를 입력하고, 필요한 경우 사용자 지정 Endpoint를 먼저 입력합니다. Provider 카탈로그 또는 해당 Endpoint에서 모델 목록을 불러온 뒤 이 Key가 사용할 기본 모델을 선택합니다. Ollama는 구성에 따라 API Key를 생략할 수 있습니다.

옵션 설정 후 저장

Max output tokens, 월 예산과 필요한 경우 사설 Endpoint를 설정하고 저장합니다.

참고: 첫 번째 Key는 자동으로 기본 Provider Key가 됩니다. 카드의 별표는 Chat에서 먼저 선택할 Key를 바꾸며, Key 설정의 기본 모델은 그 Key로 요청할 때 사용할 모델을 정합니다.

키별 옵션

등록한 Key마다 다음 값을 개별적으로 관리합니다.

옵션	설명
별칭	같은 Provider의 여러 Key를 구분하는 이름입니다.
기본 모델	이 Key를 선택했을 때 호출할 Chat 모델입니다.
Max output tokens	한 번의 응답에서 생성할 수 있는 최대 토큰 수입니다. 너무 작으면 설명이나 SQL이 중간에 잘릴 수 있습니다.
월 예산 (USD)	기록된 이번 달 추정 사용액을 기준으로 추가 호출을 제한할 예산입니다. 비워두면 무제한입니다.
사설 Endpoint	사내 AI Gateway, 프록시, 로컬 Ollama처럼 Provider 기본 URL과 다른 API Base URL을 사용할 때 입력합니다.

Tip

NL2SQL, Query Tuning과 Sample Data 생성은 Max output tokens 4096을 시작값으로 권장합니다.

주의: 화면의 토큰과 비용은 추정치이며 Provider 청구 내역이 최종 기준입니다. 월 예산은 호출 시작 시 기록된 누계를 검사하므로 동시 요청까지 포함한 절대 상한을 보장하지 않습니다.

Key 관리

등록 후에는 Key 카드에서 기본 선택, 활성 상태, 인증 정보와 사용량을 관리합니다.

기본 Provider Key: 별표로 지정하며 새 Chat에서 먼저 선택됩니다. Key별 기본 모델과는 별도 설정입니다.
활성화·비활성화: 비활성 Key는 새 AI 요청에 사용할 수 없습니다.
Key 변경: 편집 화면에서 새 API Key와 사용자 지정 Endpoint를 저장해 인증 정보를 교체할 수 있습니다.
삭제: Key가 여러 개일 때 기본 Provider Key는 바로 삭제할 수 없습니다. 다른 Key를 기본으로 지정한 뒤 삭제하세요. Key가 하나뿐이면 해당 Key를 삭제할 수 있습니다.
사용량과 예산: 최근 사용량과 이번 달 추정 비용을 확인하고 Key별 월 예산을 조정합니다.

키 보호와 Endpoint 정책

Provider Key와 사용자 지정 Endpoint는 계정 단위로 관리되며 실행 환경에 따라 허용 범위가 달라집니다.

API Key와 사용자 지정 Endpoint는 AWS KMS Envelope Encryption과 AES-256-GCM으로 암호화하여 저장합니다.
저장된 Key 원문은 설정 화면에 다시 표시하지 않으며 마스킹된 값만 확인할 수 있습니다.
Key는 등록한 사용자에게만 속하며 프로젝트 구성원에게 공유되지 않습니다.

실행 환경	Endpoint 정책
Web App	Endpoint는 HTTPS를 사용해야 합니다. localhost와 사설·특수 목적 IP 주소를 직접 입력한 Endpoint는 실행과 모델 조회에서 차단됩니다.
Desktop Online	공개 Endpoint와 함께 HTTP, localhost, 사설 IP 기반의 로컬·사내 Endpoint를 사용할 수 있습니다.

문제 해결

Key를 저장한 뒤 AI Assistant에서 전송할 수 없거나 모델을 불러오지 못하면 다음 항목을 확인합니다.

사용 가능한 Key가 없으면 AI Chat의 전송 버튼이 활성화되지 않습니다. Key가 활성 상태인지 확인하세요.
Provider 인증 오류가 발생하면 API Key가 만료되거나 권한이 제한되지 않았는지 확인하세요.
모델 목록이 비어 있으면 Provider 기본 카탈로그를 사용하는지 사용자 지정 Endpoint에서 조회하는지 확인하고, API Key와 Endpoint를 점검한 뒤 모델 검색을 다시 실행하세요.
ENDPOINT_NOT_ALLOWED 오류가 발생하면 Web App에서 로컬·HTTP·사설 IP Endpoint를 사용하고 있지 않은지 확인하세요.
BUDGET_EXCEEDED 오류가 발생하면 해당 Key의 이번 달 추정 사용액과 월 예산을 확인하세요.