AI 제공자와 API 키

## 왜 고객이 키를 발급하나 AI 에이전트는 외부 AI 모델을 호출합니다. **고객사 계정으로 발급한 키를 쓰면** 아래 이점이 있습니다. - 사용량과 비용을 고객사가 직접 통제 - 회사 데이터가 어느 제공자를 거치는지 명확히 선택 - 제공자별 정책(데이터 학습 여부 등)을 직접 확인·적용 ## 지원 제공자 | 제공자 | 발급 위치 | 특징 | |---|---|---| | **Anthropic Claude** | [Anthropic Console](https://console.anthropic.com) | 긴 문맥·문서 분석에 강점 | | **OpenAI ChatGPT** | [OpenAI Platform](https://platform.openai.com) | 음성 입출력·이미지 생성 함께 사용 | | **Google Gemini** | [Google AI Studio](https://aistudio.google.com) | 비용 효율 | **하나만 등록해도 동작합니다.** 여러 개를 등록하면 기본 제공자를 골라 쓸 수 있습니다. 사내 폐쇄망 환경이라면 → [COMKEY Private LLM](/news/guide/agent-comkey) ## 발급 절차 ### Anthropic Claude 1. [Anthropic Console](https://console.anthropic.com) 가입·로그인 2. **API Keys** → **Create Key** 3. 결제 수단 등록 (사용량 과금) 4. 발급된 키 복사 — **한 번만 표시됩니다** ### OpenAI 1. [OpenAI Platform](https://platform.openai.com) 가입·로그인 2. **API keys** → **Create new secret key** 3. 결제 수단 등록 4. 발급된 키 복사 — **한 번만 표시됩니다** > 음성 입력·음성 답변·이미지 생성 기능은 OpenAI 키를 사용합니다. > 음성 기능을 쓰려면 OpenAI 키를 등록하세요. ### Google Gemini 1. [Google AI Studio](https://aistudio.google.com) 로그인 2. **Get API key** → 프로젝트 선택 후 키 생성 3. 발급된 키 복사 ## 모닝인사이트에 입력 1. **설정 → AI Agent** 탭 2. **AI API 키** 영역에서 제공자 카드를 클릭 3. 발급받은 키 붙여넣기 → **저장** 4. 저장 후 사용할 **모델을 선택** ### 기본 AI 모델 지정 같은 화면의 **Agent 기본 동작 → 기본 AI 모델** 에서 평소 사용할 제공자를 지정합니다. - 일상적인 질문은 가벼운 모델로 두면 비용이 절약됩니다 - 복잡한 분석이 필요할 때만 상위 모델로 전환하는 운용을 권합니다 ## 확인 방법 1. **AI 에이전트** 화면에서 간단한 질문을 던져 봅니다 (예: "이번 달 매출 알려줘") 2. 답변이 오면 정상입니다 3. **설정 → AI Agent → 비용 추적** 에 사용량이 기록됐는지 확인 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | "API 키가 설정되지 않았습니다" | 키 미등록 | 제공자 키 등록 | | 인증 실패 | 키 복사 시 공백·줄바꿈 포함 | 다시 붙여넣기 | | 인증 실패 | 제공자 쪽 결제 수단 미등록 | 제공자 콘솔에서 결제 등록 | | `quota` 초과 오류 | 제공자 사용 한도 도달 | 제공자 콘솔에서 한도 확인·증액 | | 특정 모델만 실패 | 계정에 그 모델 접근 권한이 없음 | 다른 모델 선택 또는 제공자 문의 | | 음성 기능이 안 됨 | OpenAI 키 미등록 | OpenAI 키 등록 | ## 키는 어떻게 보관되나 - **암호화 저장**되며 화면에는 마스킹 표시됩니다 - 워크스페이스별로 분리 저장됩니다 - 등록·변경은 감사 로그에 기록됩니다 - 저장 후 **다시 조회할 수 없습니다** — 원본은 별도 보관하세요 자세한 내용 → [자격증명 보관과 보안](/news/guide/integration-security) ## 운영 팁 - **개인 계정이 아닌 회사 계정**으로 키를 발급하세요 - 제공자 콘솔에서 **월 사용 한도**를 걸어 두면 이중 안전장치가 됩니다 - 담당자 교체 시 키를 재발급해 교체하세요 ## 관련 문서 - [COMKEY Private LLM](/news/guide/agent-comkey) - [비용 추적과 한도](/news/guide/agent-cost) - [업무 지침 설정](/news/guide/agent-instructions)