🤖 AI 설정 가이드

AI는 OKNote의 거의 모든 모듈에서 작동합니다. 노트 요약, 번역, 차트 생성, 메일 다이제스트, AI 답장 초안, 주간·월간 리포트… 이 모든 기능이 하나의 설정을 공유합니다. 한 번만 설정하면 모든 기능이 열립니다. 하나의 모델 제공사에서 발급받은 API 키 하나면 충분합니다.

1. 3분 설정

설정(⌘,) → AI 설정을 여세요.

1. 제공사 선택: 드롭다운에 주요 제공사의 프리셋이 준비되어 있습니다.

   구분	제공사
   중국계	DeepSeek, Zhipu GLM, Kimi(Moonshot), Qwen(Alibaba), Doubao(Volcengine), SiliconFlow, Tencent Hunyuan, Baidu Ernie
   글로벌	OpenAI, Anthropic Claude, Google Gemini, xAI Grok, OpenRouter, Mistral, Groq
   로컬 / 커스텀	Ollama, LM Studio, Custom(OpenAI 호환 엔드포인트라면 모두 가능)

   선택하면 Base URL이 자동으로 채워지므로 대부분 직접 손댈 필요가 없습니다.

2. API 키 입력: 제공사 웹사이트에서 발급받은 키를 붙여넣으세요(발급 방법은 아래에서 안내합니다).

3. 모델 선택: 입력란에 해당 제공사가 추천하는 모델이 제안되니 클릭만 하면 됩니다.

4. "테스트" 클릭: 연결에 성공하면 모델의 응답과 지연 시간이 표시됩니다. 실패한다면 키와 계정 잔액을 확인하세요.

5. 저장. 끝입니다!

🔒 API 키는 여러분 자신의 서버에 AES-256으로 암호화되어 저장되며, 어떤 제3자에게도 전송되지 않습니다.

2. API 키 발급받는 법

어느 서비스든 흐름은 대체로 비슷합니다. 제공사 사이트에서 가입 → 개발자/API 콘솔 열기 → API 키 생성 → 복사. 두 가지 예시를 들어보겠습니다.

DeepSeek(가성비가 좋고 중국에서 인기)

1. platform.deepseek.com에 접속해 가입하고 로그인하세요.
2. 왼쪽 메뉴에서 "API Keys"를 열고 "Create API Key"를 클릭하세요.
3. 생성된 키(sk-로 시작하며 이번 한 번만 표시됩니다)를 복사하세요. 소액을 충전해 두면 오래 사용할 수 있습니다.

OpenAI

1. platform.openai.com에 접속해 로그인하고 "API keys"를 여세요.
2. "Create new secret key"를 클릭한 뒤 복사해 저장하세요.

Zhipu(open.bigmodel.cn), Kimi(platform.moonshot.cn), Qwen(Alibaba Cloud의 Bailian 콘솔) 등도 방식은 동일합니다. 각 개발자 플랫폼의 "API Keys" 페이지에서 키를 생성하세요.

Ollama, 로컬 모델(완전 무료, 데이터가 기기 밖으로 나가지 않음)

1. 서버(또는 여러분의 컴퓨터)에 Ollama를 설치하세요. ollama.com에서 내려받을 수 있습니다.
2. 터미널에서 ollama pull qwen3(또는 원하는 모델)을 실행하세요.
3. OKNote에서 제공사로 "Ollama(로컬)"를 선택하세요. Base URL은 기본값으로 http://localhost:11434가 설정되며, API 키는 필요 없습니다. 내려받은 모델 이름을 입력하고 테스트하면 됩니다.

참고: 로컬 모델(Ollama / LM Studio), 커스텀 제공사, 여러 제공사 동시 설정은 라이선스 등급에 따라 제공되는 고급 기능입니다. 옵션에 자물쇠 아이콘이 보인다면 현재 플랜에 포함되어 있지 않은 것입니다.

3. 고급: 모듈별로 다른 AI 사용하기

설정에는 "모듈별 설정" 스위치가 있습니다(라이선스 등급에 따라 제공됩니다). 켜면 다음을 각각 다른 제공사/모델로 설정할 수 있습니다.

• 노트 / 리포트 AI — 노트 요약, 번역, 차트, 주간·월간 작업 리포트
• 메일 AI — 메일 요약, 분류, AI 답장 초안

흔한 조합은 노트/리포트에는 성능이 좋은 모델을 쓰고(주간 리포트는 품질이 중요하니까요), 메일 요약에는 저렴하고 빠른 모델을 쓰는 것입니다(양이 많으니까요). 꺼두면 모든 기능이 하나의 설정을 공유하며, 이 방식도 충분히 잘 작동합니다.

팀 단위로 운영한다면, 관리자가 자신의 AI 설정을 모든 구성원과 공유할 수도 있어, 다른 사람이 각자 키를 발급받을 필요가 없습니다.

4. 설정을 마쳤다면 어디서 쓰나요? — AI 기능 전체 지도

모듈	기능	위치
노트	요약 / 태그 추출 / 영어로 번역 / 일본어로 번역 / 차트 생성 / 자유 질의응답	아무 노트나 열고 오른쪽 아래 ✨ 플로팅 버튼을 클릭해 AI 패널 열기
노트	AI 답변을 노트에 삽입	AI 패널에서 "노트에 삽입" 클릭
메일	AI 요약(메일을 일괄 분류하고 다이제스트로 정리)	메일 사이드바 → 스마트 화면 → AI 요약
메일	AI 답장 초안(커스텀 지시사항 포함)	메일 열기 → "AI 답장 초안"
작업	빠른 작업 생성(자연어 / 음성)	일정 화면 오른쪽 아래의 AI 플로팅 버튼
작업	AI 주간 · 월간 리포트 생성	리포트 화면 → "리포트 생성"

노트 AI 패널의 "대화" 모드는 특히 언급할 만합니다. 현재 노트의 내용을 맥락으로 삼아 답변해 주므로, 긴 회의록을 열어놓고 "내가 뭘 후속으로 처리해야 하지?"라고 물어보기만 하면 됩니다. "차트 생성"은 노트 안에 있는 데이터를 막대·선·원형 그래프로 바로 바꿔 본문에 삽입할 수 있습니다.

5. 자주 묻는 질문

• AI 기능에 "설정되지 않음"이라고 뜨나요? 설정 → AI 설정으로 돌아가 설정을 마치고 테스트를 통과시키세요. 모듈별 설정이 켜져 있다면 해당 모듈(노트 또는 메일)도 설정되어 있는지 확인하세요.
• 연결 테스트가 실패하나요? 순서대로 확인하세요. 키를 전체 복사했는지, 제공사 계정에 잔액이 있는지, 서버의 네트워크가 제공사의 API 엔드포인트에 접근할 수 있는지.
• 모델을 바꾸고 싶나요? 설정에서 모델 이름을 바꾸고 저장하면 바로 적용됩니다.

---

마지막 두 가이드는 관리자를 위한 고급 설정입니다. "🔑 구매 후 할 일: 이 서버에서 라이선스 활성화하기"와 "🌐 공개 접속: 나만의 도메인 + Cloudflare". 해당 사항이 없다면 건너뛰어도 됩니다.