WorkBuddy

WorkBuddy는 사용자 지정 모델로 HiAPI에 연결할 수 있습니다. OpenAI Chat Completions 프로토콜(인터페이스에서는 OpenAI-compatible)만 지원하므로 Anthropic Messages만 지원하는 모델은 연결할 수 없습니다. 아래 단계는 gpt-6-astra를 예로 사용하며, 이 튜토리얼은 WorkBuddy 5.8.3에서 검증했습니다. 다른 모델을 사용하려면 텍스트 모델 목록에서 이름을 찾아 입력하세요. 연결 테스트가 거부되면 그 모델은 Chat Completions를 지원하지 않으므로 다른 모델로 바꾸세요.

1. HiAPI API 키 준비

API 키 발급받기에 설명된 대로 키를 준비하고, 키 옆의 복사 아이콘을 클릭해 전체 HiAPI API 키를 복사해 아래 WorkBuddy에 입력하세요.

2. 모델 추가

2.1 진입점 열기

Settings → Models → Add Model (设置 → 模型 → 添加模型)을 클릭합니다.

2.2 항목 입력

항목	값
Supplier (供应商)	Custom (自定义)
API address (接口地址)	https://api.hiapi.ai/v1
API Key	자신의 HiAPI API 키
Model name (模型名称)	gpt-6-astra
Advanced settings → Tool calling (高级配置 → 工具调用)	체크
Input / Output (输入 / 输出)	“Use provider default” (使用提供商默认值) 유지

API address는 /v1까지만 입력하고 /chat/completions나 /responses를 덧붙이지 마세요. 매개변수 지원은 모델마다 다르므로 모델 페이지를 참고하세요.

Test connection (测试连接)을 클릭하고 통과하면 저장하세요.

3. 확인

3.1 채팅

“안녕하세요, 한 문장으로 자기소개를 해 주세요.”를 보내세요. 정상적으로 답하면 연결이 된 것입니다.

3.2 도구 호출

먼저 WorkBuddy가 현재 사용하는 작업 폴더에 tool-call-test.txt를 만들고 hello hiapi 한 줄을 써서 저장하세요. 그다음 “반드시 도구를 호출해야 합니다. tool-call-test.txt의 전체 내용을 읽고 그대로 반환하세요. 파일 이름으로 내용을 추측하지 마세요.”를 보내세요. 도구 호출이 나타나고 hello hiapi를 반환하면 통과입니다.

이 페이지는 텍스트 모델만 다룹니다. 도구 기능은 MCP 가이드를 참고하세요.

4. 문제 해결

여기에는 WorkBuddy에 특화된 문제만 정리했습니다. 401, 404, 429 같은 일반적인 오류는 자주 발생하는 오류를 참고하세요.

WorkBuddy의 Test connection (测试连接)이 프로토콜 오류를 만나면 구체적인 이유 없이 일반 메시지만 반환하므로, 아래 표로 원인을 좁히세요:

오류	원인	해결 방법
모델 서비스가 테스트 요청을 거부함	모델이 OpenAI Chat Completions를 지원하지 않음	Chat Completions를 지원하는 모델로 바꾸세요
API 주소 또는 모델 이름이 올바르지 않음	API 주소가 잘못됨	API 주소를 https://api.hiapi.ai/v1로 설정하세요
401	HiAPI API 키가 잘못됨	앞뒤 공백 없이 다시 붙여 넣으세요
Invalid model name	모델 이름에 오타가 있음	텍스트 모델 목록에 표시된 대로 모델 이름을 정확히 입력하세요