CometAPI로 WorkBuddy AI 사용

이 WorkBuddy AI 데스크톱 앱을 OpenAI 호환 Custom 제공자를 통해 CometAPI와 함께 사용할 수 있습니다. 앱에서 또는 models.json 파일을 사용하여 연결을 구성할 수 있습니다. WorkBuddy AI 공식 참고 자료:

사전 요구 사항

WorkBuddy AI 가 컴퓨터에 설치되어 있어야 합니다
활성 API 키가 있는 CometAPI 계정
다음에서 제공하는 모델 ID: CometAPI 모델 목록

설정 방법 선택

앱에서 구성

그래픽 인터페이스를 통해 Custom 제공자를 추가하려면 Settings → Model 을 사용하세요.

models.json으로 구성

사용자 수준 또는 프로젝트 수준 WorkBuddy AI 구성 파일에 재사용 가능한 모델 정의를 저장하세요.

앱 구성

모델 설정 열기

WorkBuddy AI에서 Settings → Model을 연 다음 Add Model을 선택하세요..

Custom 제공자 선택

설정의 Provider 필드에서 Custom을 선택하세요. 이 옵션은 OpenAI 호환 API 연결을 허용합니다.

CometAPI 연결 값 입력

Add Model 대화상자에 다음 값을 입력하세요:

필드	값
Provider	`Custom`
Endpoint	`https://api.cometapi.com/v1/chat/completions`
API Key	사용자의 CometAPI API 키
Model Name	다음에서 제공하는 모델 ID: CometAPI 모델 목록

엔드포인트에는 전체 /chat/completions 경로가 포함됩니다. Custom Protocol 을 활성화하면 WorkBuddy가 다른 /chat/completions 경로를 추가하지 않고 URL을 입력한 그대로 전송합니다.

Custom 제공자 및 CometAPI 연결 필드가 있는 WorkBuddy AI Add Model 대화상자

스크린샷에서는 gpt-6-astra을 예시 모델 이름으로 사용합니다. CometAPI 계정에서 사용할 수 있는 모델 ID를 선택하세요.

모델 기능 설정

선택한 모델이 해당 기능을 지원하는 경우에만 Tool Calling, Image Input, 또는 Reasoning 을 활성화하세요. 해당 컨트롤이 모델의 추론 동작과 일치하는 경우 Reasoning Only 및 Allow Disabling Reasoning 을 사용하세요.

모델 테스트 및 저장

Add Model 대화상자에서 Test connection을 클릭한 후, 연결 검사가 완료되면 Save 를 클릭하세요.

models.json 구성

WorkBuddy AI는 사용자 수준의 ~/.codebuddy/models.json 파일 또는 프로젝트 수준의 <workspace>/.codebuddy/models.json 파일에서 사용자 지정 모델을 읽습니다. 프로젝트 수준 구성은 일치하는 모델 ID에 우선 적용됩니다. 구성 디렉터리가 없으면 만든 다음 다음 JSON을 저장하세요. 이 예제에서는 API 키가 파일에 표시되지 않도록 환경 변수 참조를 사용합니다:

{
  "models": [
    {
      "id": "your-model-id",
      "name": "CometAPI model",
      "vendor": "CometAPI",
      "apiKey": "${COMETAPI_KEY}",
      "url": "https://api.cometapi.com/v1/chat/completions",
      "supportsToolCall": false,
      "supportsImages": false,
      "supportsReasoning": false
    }
  ],
  "availableModels": [
    "your-model-id"
  ]
}

WorkBuddy AI를 시작하는 환경에서 COMETAPI_KEY을 설정하세요. your-model-id를 CometAPI 모델 목록의 모델 ID로 바꾸세요. url 값은 전체 OpenAI 채팅 완성 경로여야 합니다. 선택한 모델이 해당 기능을 지원하는 경우에만 기능 플래그를 true로 변경하세요. macOS 또는 Linux에서 파일 권한을 소유자 읽기/쓰기로 설정하세요:

chmod 600 "$HOME/.codebuddy/models.json"

프로젝트 수준 파일을 사용하는 경우 <workspace>/.codebuddy/models.json에 만들고, 로컬 구성이 포함되어 있다면 파일을 버전 관리에서 제외하세요. WorkBuddy AI는 저장된 models.json 변경 사항을 다시 로드하고 파일을 통해 추가된 모델을 사용자 지정 모델로 표시합니다.

availableModels 배열은 모델 선택기에 표시되는 모델 ID를 제어합니다. 배열이 비어 있거나 생략되면 WorkBuddy AI는 구성된 모든 모델을 표시합니다.

연결 확인

두 설정 방법 중 하나를 완료한 후 WorkBuddy AI 모델 선택기에서 CometAPI 모델을 선택하고 다음과 같은 짧은 프롬프트(Prompt)를 전송하세요:

Reply with one sentence: WorkBuddy AI is connected through CometAPI.

응답이 반환되면 WorkBuddy AI가 구성된 CometAPI 모델에 연결할 수 있음을 확인할 수 있습니다. 모델이 표시되지 않으면 모델 ID가 CometAPI 모델 목록과 일치하는지, 그리고 해당 필드를 사용하는 경우 availableModels에 동일한 ID가 포함되어 있는지 확인하세요.

문제 해결

WorkBuddy AI에 모델이 표시되지 않음

id 값이 CometAPI 모델 ID와 일치하는지 확인하세요. availableModels이 있으면 해당 배열에 동일한 ID를 추가하세요. 프로젝트 구성에서는 사용자 수준 파일보다 먼저 <workspace>/.codebuddy/models.json을 확인하세요.

연결 테스트 실패

API 키가 활성 상태인지, 엔드포인트가 정확히 https://api.cometapi.com/v1/chat/completions인지 확인하세요. models.json 설정에서는 WorkBuddy AI를 시작하는 환경에서 COMETAPI_KEY을 사용할 수 있는지 확인하세요.

요청이 잘못된 경로를 사용함

Endpoint 필드와 /chat/completions 필드에 전체 url 경로를 사용하세요. 앱에서 사용자 지정 프로토콜 을 활성화하면 WorkBuddy가 다른 경로를 추가하지 않고 전체 URL을 전송합니다.

모델이 지원되지 않는 기능을 전송함

선택한 모델이 지원하지 않는 기능 플래그를 끄세요. 도구 호출, 이미지 입력, 추론은 서로 독립적인 설정입니다.

개요

AI 코딩 에이전트

AI 에이전트

AI 채팅 클라이언트

번역 및 언어

자동화 플랫폼

관측성 및 평가

AI 프레임워크

사전 요구 사항

설정 방법 선택

앱에서 구성

models.json으로 구성

앱 구성

models.json 구성

연결 확인

문제 해결

​사전 요구 사항

​설정 방법 선택

앱에서 구성

models.json으로 구성

​앱 구성

​models.json 구성

​연결 확인

​문제 해결

사전 요구 사항

설정 방법 선택

앱 구성

models.json 구성

연결 확인

문제 해결