매뉴얼웍스는 OpenAI, Gemini 등이 제공하는 API를 이용해 다양한 AI 어시스턴트(챗봇, AI 글쓰기, 맞춤법 검사와 교정, 아이콘 추천) 기능을 제공합니다. API 기반 AI 어시스턴트를 사용하려면 먼저 AI 제공자를 만들고 AI 모델을 지정해야 합니다.

<AI | AI 제공자> 메뉴는 “관리” 권한이 있는 사용자만 사용할 수 있습니다.

AI 제공자 및 주요 모델

매뉴얼웍스는 Claude, OpenAI, Gemini, Grok, Ollama, Voyage AI의 6가지 AI 제공자를 지원합니다. 각 제공자에서 지원하는 주요 AI 모델은 다음 표와 같습니다.

AI 제공자	AI 모델	비고
Claude	claude-sonnet-4-0	생성형 AI 모델
	claude-opus-4-0	생성형 AI 모델
	claude-3-5-haiku-latest	생성형 AI 모델
Gemini	gemini-2.5-pro	생성형 AI 모델
	gemini-2.5-flash	생성형 AI 모델
	gemini-2.5-flash-lite	생성형 AI 모델
	gemini-embedding-001	임베딩 AI 모델
Grok	grok-4	생성형 AI 모델
	grok-3	생성형 AI 모델
	grok-3-mini	생성형 AI 모델
Ollama	자세한 내용은 다음을 참고합니다.
OpenAI	gpt-4.1	생성형 AI 모델
	gpt-4.1-mini	생성형 AI 모델
	gpt-4.1-nano	생성형 AI 모델
	gpt-4o	생성형 AI 모델
	text-embedding-3-large	임베딩 AI 모델
	text-embedding-3-small	임베딩 AI 모델
Voyage AI	voyage-3.5	임베딩 AI 모델

매뉴얼웍스는 AI 어시스턴트 기능에 적합한 일부 AI 제공자와 AI 모델을 키워드로 바로 지원합니다. 필요하면 임의의 모델을 등록하여 사용할 수도 있습니다.

AI 제공자 만들기

다음 순서로 AI 제공자를 만듭니다.

<AI | AI 제공자> 메뉴로 이동합니다.
<AI 제공자 만들기> 링크를 클릭합니다.
사용할 ‘AI 제공자’를 선택하고 기본 정보를 입력합니다.
- 같은 유형의 AI 제공자를 여러 개 만들 수 있습니다.
“API 키”를 입력하고 합니다.

Ollama를 유형으로 선택했을 때는 API 키가 아닌 운영 중인 Ollama의 URL을 입력합니다.

AI 모델 추가

다음 순서로 AI 모델을 추가합니다.

AI 모델을 지정할 ‘AI 제공자’를 클릭합니다.
“AI 모델” 패널에서 <1AI 모델 추가> 링크를 클릭합니다.
지원하는 모델을 선택하여 추가합니다.
- 각 AI 제공자에는 여러 개의 AI 모델을 지정할 수 있습니다.
<2테스트> 링크를 클릭하여 선택한 모델의 동작을 테스트할 수 있습니다.
- <3삭제> 링크를 클릭하여 해당 모델을 삭제할 수 있습니다.

API 키

API 키 발급받기

AI 제공자마다 API 키를 발급받는 방법이 다릅니다. AI 제공자의 가이드를 참고합니다.

일부 AI 제공자는 API 키 발급 시 신용카드를 이용한 선결제가 필요할 수 있습니다.

AI 제공자	가이드 주소
Claude	https://www.anthropic.com/api
Gemini	https://aistudio.google.com/app/apikey
Grok	https://x.ai/api
OpenAI	https://platform.openai.com/api-keys
Voyage AI	https://voyageai.com

API 키 변경하기

<1변경> 링크를 클릭하여 API 키를 변경합니다.

매뉴얼웍스는 UI에서 AI 제공자의 API 키 전체를 노출하지 않고, 일부만 마스킹하여 보여줍니다.

AI 제공자의 API 사용과 관련한 주의 사항

사용량에 따른 비용 증가

AI 제공자마다 API 사용 비용이 다르게 발생하며, 같은 AI 제공자라도 선택한 모델과 사용 방식에 따라 요금이 달라집니다. 자세한 내용은 각 AI 제공자의 요금 가이드를 참고합니다.

대부분의 AI 제공자는 월 최대 비용 제한 기능을 제공합니다. 이를 설정하는 것을 권장합니다.

AI 모델마다 요금뿐만 응답 속도와 품질도 차이가 납니다.

AI 제공자	비용 가이드 주소
Claude	https://www.anthropic.com/pricing#api
Gemini	https://ai.google.dev/gemini-api/docs/pricing
Grok	https://docs.x.ai/docs/models
OpenAI	https://openai.com/api/pricing/
Voyage AI	https://docs.voyageai.com/docs/pricing

데이터 전송에 따른 보안 문제

API를 호출할 때 여러 데이터를 AI 제공자에게 전송합니다. AI 제공자마다 해당 데이터를 처리하는 정책을 공개하고 있으므로, 정확한 내용은 각 제공자의 가이드를 참고합니다.

AI 제공자	데이터 처리 가이드 주소
Claude	https://support.anthropic.com/en/collections/4078534-privacy-legal
Gemini	https://ai.google.dev/gemini-api/terms
Grok	https://docs.x.ai/docs/resources/faq-api/security
OpenAI	https://platform.openai.com/docs/guides/your-data
Voyage AI	https://www.voyageai.com/privacy

매뉴얼웍스가 제공하는 AI 어시스턴트별로 AI 제공자에게 전달하는 데이터는 다음과 같습니다.

AI 어시스턴트	전송하는 데이터
문서 임베딩	매뉴얼웍스로 작성한 문서의 전체 내용
챗봇	사용자 입력 사용자 입력에서 추출한 벡터 데이터의 내용
AI 글쓰기	사용자 입력 스타일 가이드를 설정했을 때는 스타일 가이드 장 내용
AI 맞춤법 검사와 교정	단락 내용
AI 아이콘 추천	사용자 입력

각 AI 어시스턴트에 맞는 답변을 얻기 위해 프롬프트를 구성할 때 응답 언어와 응답 형식에 관한 추가 정보를 함께 전달합니다. 이렇게 추가되는 데이터에는 보안과 관련된 내용이 없습니다. 정확한 프롬프트 내용은 REST API 요청 및 응답을 로그 파일에 기록하면 확인할 수 있습니다.