관리자 > 설정 > 연결 탭에서 AI 모델 API 연결, 클라우드 계정, 스토리지를 구성합니다.
OpenAI API 연결
OpenAI 또는 OpenAI 호환 API(Azure OpenAI, AI Foundry 등)와 연결합니다. 여러 연결을 동시에 구성하여 부하를 분산할 수 있습니다.
연결 추가
OpenAI API 섹션의 ”+” 버튼을 클릭합니다.
연결 정보 입력
연결 Modal에서 API Base URL, API Key를 입력합니다.
연결 확인
저장 후 모델 목록이 자동으로 갱신되는지 확인합니다.
OpenAI
Azure OpenAI
AI Foundry
| 설정 항목 | 값 |
|---|
| API Base URL | https://api.openai.com/v1 |
| API Key | OpenAI에서 발급받은 키 (sk-...) |
| 설정 항목 | 값 |
|---|
| API Base URL | https://{리소스명}.openai.azure.com/ |
| API Key | Azure Portal에서 발급받은 키 |
| 설정 항목 | 값 |
|---|
| API Base URL | https://{프로젝트명}.{리전}.models.ai.azure.com/ |
| API Key | AI Foundry에서 발급받은 키 |
OpenAI 호환 API 표준을 따르는 모든 서비스를 연결할 수 있습니다.
각 연결별로 활성화/비활성화 토글이 있어 필요에 따라 제어할 수 있습니다.
Ollama API 연결
로컬 또는 사내 서버의 Ollama 인스턴스와 연결합니다.
| 설정 항목 | 설명 | 예시 |
|---|
| Base URL | Ollama 서버 주소 | http://localhost:11434 |
직접 연결
사용자가 개인 API 키로 OpenAI 호환 API에 직접 연결하도록 허용합니다.
| 설정 항목 | 설명 | 기본값 |
|---|
| 직접 연결 허용 | 사용자별 개인 API 연결 허용 | 비활성화 |
Cloud Accounts
글로벌 클라우드 서비스 계정을 설정합니다. 여기서 설정한 Service Account Key는 개별 기능(TTS, STT, 이미지 등)에서 별도 키가 없을 때 fallback으로 사용됩니다.
| 제공자 | 설정 항목 |
|---|
| Google Cloud | Service Account Key (JSON) |
Service Account Key를 비워두면 Application Default Credentials(ADC)를 사용합니다.
Image Attachment Mode
채팅에 첨부된 이미지의 처리 및 저장 방식을 설정합니다.
| 설정 항목 | 설명 | 기본값 |
|---|
| Image Upload Mode | Base64 Inline 또는 Cloud Storage | Base64 Inline |
| Storage Provider | 클라우드 스토리지 제공자 (Storage 모드 시) | Local |
AWS S3
Azure Blob
Google Cloud Storage
| 설정 항목 | 설명 |
|---|
| Bucket Name | S3 버킷 이름 |
| Region | AWS 리전 |
| Endpoint URL | 커스텀 Endpoint (선택) |
| Access Key ID | 인증 키 ID |
| Secret Access Key | 비밀 키 |
| Key Prefix | 파일 경로 접두사 (선택) |
| 설정 항목 | 설명 |
|---|
| Storage Endpoint | Azure Blob Storage Endpoint |
| Container Name | 컨테이너 이름 |
| Storage Key | 인증 키 |
| 설정 항목 | 설명 |
|---|
| Bucket Name | GCS 버킷 이름 |
| Authentication | Global Google Cloud Key 또는 Custom Key 선택 |
Shared Storage (파일 업로드)
문서, PDF 등 업로드 파일의 저장 위치를 설정합니다. Image Attachment Mode와 동일한 스토리지 제공자 옵션을 지원합니다.
| 설정 항목 | 설명 | 기본값 |
|---|
| File Storage Provider | Local, AWS S3, Azure Blob, Google Cloud Storage | Local |
스토리지 설정 변경 후 “Test” 버튼으로 연결 상태를 반드시 확인하세요.
