메인 콘텐츠로 건너뛰기
AI 모델을 사용하려면 먼저 LLM 프로바이더와의 연결을 설정해야 합니다. 여러 프로바이더를 동시에 연결하여 사용자가 다양한 모델을 선택할 수 있도록 구성합니다. 관리자 > 설정 > 연결 탭에서 설정합니다.
연결 설정 탭

OpenAI API 연결

OpenAI 또는 OpenAI 호환 API(Azure OpenAI, AI Foundry 등)와 연결합니다. 여러 연결을 동시에 구성하여 부하를 분산할 수 있습니다.
1

연결 추가

OpenAI API 섹션의 ”+” 버튼을 클릭합니다.
2

연결 정보 입력

연결 Modal에서 API Base URL, API Key를 입력합니다.
3

연결 확인

저장 후 모델 목록이 자동으로 갱신되는지 확인합니다.
설정 항목설명
API Base URLhttps://api.openai.com/v1
API KeyOpenAI에서 발급받은 키 (sk-...)
Prefix ID모델 ID 접두사 (선택 — 다중 연결 시 충돌 방지)
Model IDs수동 지정 (비우면 자동 조회)

연결 설정 공통 사항

각 연결에는 다음 공통 기능이 있습니다:
기능설명
연결 확인설정 모달의 확인 버튼으로 API 접속 테스트
Prefix ID여러 연결의 모델명이 겹칠 때 {prefix}.{model} 형태로 구분
활성화/비활성화연결별 토글로 일시 중지 가능 (삭제하지 않고)
Model IDs수동 지정 시 해당 모델만 노출. 비우면 API에서 자동 조회
동일 프로바이더에 여러 연결을 추가하면 모델 목록이 자동으로 병합됩니다. 예를 들어 Azure OpenAI 연결 2개(미국/한국 리전)를 추가하면 양쪽 리전의 모델이 모두 표시됩니다. 이때 Prefix ID로 구분하세요.

Ollama API 연결

로컬 또는 사내 서버의 Ollama 인스턴스와 연결합니다.
설정 항목설명예시
Base URLOllama 서버 주소http://localhost:11434
여러 서버를 추가하여 부하를 분산할 수 있습니다. Ollama는 외부 네트워크 없이 완전한 데이터 프라이버시를 보장합니다.

직접 연결 (Direct Connections)

관리자가 설정한 연결 외에, 사용자가 개인 API 키로 LLM에 직접 연결하도록 허용하는 기능입니다.
설정 항목설명기본값
직접 연결 허용사용자별 개인 API 연결 허용활성화
활성화하면 사용자가 개인 설정 > Connections에서 OpenAI 호환 API를 추가할 수 있습니다.
직접 연결은 OpenAI 호환 API만 지원합니다 (Ollama 미지원). 사용자가 연결하는 API 서버에서 CORS 설정이 올바르게 구성되어 있어야 합니다.

Cloud Accounts

글로벌 클라우드 서비스 계정을 설정합니다. 여기서 설정한 Service Account Key는 개별 기능(TTS, STT, 이미지 등)에서 별도 키가 없을 때 fallback으로 사용됩니다.
제공자설정 항목
Google CloudService Account Key (JSON)
Service Account Key를 비워두면 Application Default Credentials(ADC)를 사용합니다.

Image Attachment Mode

채팅에 첨부된 이미지의 처리 및 저장 방식을 설정합니다.
설정 항목설명기본값
Image Upload ModeBase64 Inline 또는 Cloud StorageBase64 Inline
Storage ProviderLocal, AWS S3, Azure Blob, Google Cloud StorageLocal
설정 항목설명
Bucket NameS3 버킷 이름
RegionAWS 리전
Endpoint URL커스텀 Endpoint (선택)
Access Key ID인증 키 ID
Secret Access Key비밀 키
Key Prefix파일 경로 접두사 (선택)

Shared Storage (파일 업로드)

문서, PDF 등 업로드 파일의 저장 위치를 설정합니다. Image Attachment Mode와 동일한 스토리지 제공자 옵션을 지원합니다.
설정 항목설명기본값
File Storage ProviderLocal, AWS S3, Azure Blob, Google Cloud StorageLocal
스토리지 설정 변경 후 “Test” 버튼으로 연결 상태를 반드시 확인하세요.

관련 페이지

모델 관리

연결된 모델 활성화/비활성화 및 Workspace 모델 설정

문서 설정

임베딩 엔진 및 RAG 파이프라인 설정

Code Gateway

코딩 도구용 LLM 프록시 설정