> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CometAPI로 WorkBuddy AI 사용

> Custom 제공자 대화상자 또는 models.json을 통해 CometAPI로 WorkBuddy AI 데스크톱 앱을 구성하세요.

이 [WorkBuddy AI](https://www.workbuddy.ai/) 데스크톱 앱을 OpenAI 호환 Custom 제공자를 통해 CometAPI와 함께 사용할 수 있습니다. 앱에서 또는 `models.json` 파일을 사용하여 연결을 구성할 수 있습니다.

WorkBuddy AI 공식 참고 자료:

* [모델 구성](https://www.workbuddy.ai/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)
* [models.json 구성 가이드](https://www.workbuddy.ai/docs/cli/models)

## 사전 요구 사항

* [WorkBuddy AI](https://www.workbuddy.ai/) 가 컴퓨터에 설치되어 있어야 합니다
* 활성 API 키가 있는 [CometAPI](https://www.cometapi.com) 계정
* 다음에서 제공하는 모델 ID: [CometAPI 모델 목록](https://apidoc.cometapi.com/ko/overview/models.md)

## 설정 방법 선택

> **[앱에서 구성](#configure-the-app)**
>
> 그래픽 인터페이스를 통해 Custom 제공자를 추가하려면 **Settings** → **Model** 을 사용하세요.

> **[models.json으로 구성](#configure-models-json)**
>
> 사용자 수준 또는 프로젝트 수준 WorkBuddy AI 구성 파일에 재사용 가능한 모델 정의를 저장하세요.

## 앱 구성

**1. 모델 설정 열기**

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

**2. Custom 제공자 선택**

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

**3. CometAPI 연결 값 입력**

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

| 필드 | 값 |
| - | - |
| Provider | `Custom` |
| Endpoint | `https://api.cometapi.com/v1/chat/completions` |
| API Key | 사용자의 CometAPI API 키 |
| Model Name | 다음에서 제공하는 모델 ID: [CometAPI 모델 목록](https://apidoc.cometapi.com/ko/overview/models.md) |

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

![Custom 제공자 및 CometAPI 연결 필드가 있는 WorkBuddy AI Add Model 대화상자](https://mintcdn.com/cometapi/yz6X9U_FscWpHj8q/images/integrations/workbuddy-ai-add-model.png?fit=max\&auto=format\&n=yz6X9U_FscWpHj8q\&q=85\&s=3dabe44ed2e5f275370cc55fb6960c38)

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

**4. 모델 기능 설정**

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

**5. 모델 테스트 및 저장**

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

## models.json 구성

WorkBuddy AI는 사용자 수준의 `~/.codebuddy/models.json` 파일 또는 프로젝트 수준의 `<workspace>/.codebuddy/models.json` 파일에서 사용자 지정 모델을 읽습니다. 프로젝트 수준 구성은 일치하는 모델 ID에 우선 적용됩니다.

구성 디렉터리가 없으면 만든 다음 다음 JSON을 저장하세요. 이 예제에서는 API 키가 파일에 표시되지 않도록 환경 변수 참조를 사용합니다:

```json theme={null}
{
  "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 모델 목록](https://apidoc.cometapi.com/ko/overview/models.md)의 모델 ID로 바꾸세요. `url` 값은 전체 OpenAI 채팅 완성 경로여야 합니다. 선택한 모델이 해당 기능을 지원하는 경우에만 기능 플래그를 `true`로 변경하세요.

macOS 또는 Linux에서 파일 권한을 소유자 읽기/쓰기로 설정하세요:

```bash theme={null}
chmod 600 "$HOME/.codebuddy/models.json"
```

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

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

## 연결 확인

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

```text theme={null}
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을 전송합니다.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.