> ## 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.

# 使用 Hermes Agent 搭配 CometAPI

> 使用本指南透過 OpenAI 相容聊天或 Anthropic 訊息設定，將 Hermes Agent 連接到 CometAPI。

將 [CometAPI](https://www.cometapi.com) 作為 [Hermes Agent](https://hermes-agent.nousresearch.com/docs/) 的模型提供者。本指南支援 Hermes 的兩種 CometAPI 連接方式：適用於大多數文字模型的一般 OpenAI 相容端點，以及透過 Anthropic 訊息使用 Claude 的路由。

## 先決條件

* Git
* 具有有效 API key 的 CometAPI 帳戶
* macOS、Linux 或 WSL2 上的終端機

## 安裝

<Steps>
  <Step title="取得你的 CometAPI API key">
    登入 [CometAPI 主控台](https://www.cometapi.com/console/token)。按一下 **Add API Key**，並複製你的 CometAPI API key。

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="顯示 Add API Key 按鈕的 CometAPI 儀表板" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="顯示 base URL 的 CometAPI API key 詳細資訊" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="安裝 Hermes Agent">
    以下指令會執行官方安裝程式：

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    如果目前的 shell 還無法識別 `hermes` 指令，請重新載入 shell 設定：

    ```bash theme={null}
    source ~/.zshrc
    # or
    source ~/.bashrc
    ```

    <Note>
      Hermes 會將設定儲存在 `~/.hermes/`，將 `hermes` 指令連結到 `~/.local/bin`，並且可能會將 `~/.local/bin` 加入你的 shell PATH。
    </Note>
  </Step>
</Steps>

## 設定

選擇與模型家族相符的 CometAPI 路由：

| 模型家族                | Hermes 設定                                                                         | CometAPI 路由                 |
| ------------------- | --------------------------------------------------------------------------------- | --------------------------- |
| 與 OpenAI 相容的文字模型    | `model.provider: custom` 搭配 `base_url: https://api.cometapi.com/v1`               | `/v1/chat/completions`      |
| Claude 模型           | 具名 provider 搭配 `transport: anthropic_messages`                                    | `/v1/messages`              |
| Hermes 中的 Gemini 模型 | 使用與 OpenAI 相容的設定                                                                  | `/v1/chat/completions`      |
| 直接呼叫 Gemini API     | 在 Hermes 之外使用 [Gemini `generateContent` API](/api/text/gemini-generating-content) | `/v1beta` `generateContent` |

<Warning>
  不要將 Hermes 設定為使用 `https://api.cometapi.com/v1beta` 的自訂 Gemini 原生 provider。Gemini 模型請使用與 OpenAI 相容的 Hermes 設定。若要直接呼叫 Gemini API，請使用 [Gemini `generateContent` API](/api/text/gemini-generating-content)。
</Warning>

<Steps>
  <Step title="儲存你的 CometAPI 金鑰">
    開啟 `~/.hermes/.env` 並加入以下值：

    ```dotenv theme={null}
    COMETAPI_KEY=<COMETAPI_KEY>
    OPENAI_API_KEY=<COMETAPI_KEY>
    ```

    `COMETAPI_KEY` 由具名 Claude provider 使用。`OPENAI_API_KEY` 可讓 Hermes 的自訂 OpenAI 相容端點備援機制持續運作。
  </Step>

  <Step title="設定與 OpenAI 相容的路由">
    這個路由適用於大多數 CometAPI 文字模型，包括從 Hermes 使用的 Gemini 模型。開啟 `~/.hermes/config.yaml`，並確認 `model` 區段如下：

    ```yaml theme={null}
    model:
      provider: custom
      default: your-model-id
      base_url: https://api.cometapi.com/v1
    ```

    將 `your-model-id` 替換為 [CometAPI Models 頁面](https://www.cometapi.com/models/) 上目前可用的文字 model ID。

    <Note>
      請將 API 金鑰保存在 `~/.hermes/.env`。不要在 `config.yaml` 中硬編碼密鑰。
    </Note>

    <Note>
      此設定會配置主要聊天模型。Hermes 也可以針對視覺或網頁擷取等任務使用獨立的輔助模型。
    </Note>
  </Step>

  <Step title="設定 Claude Messages 路由">
    當你希望 Hermes 透過 Anthropic Messages 呼叫 Claude 模型時，請使用這個路由。開啟 `~/.hermes/config.yaml`，並使用具名 provider：

    ```yaml theme={null}
    model:
      provider: cometapi-claude
      default: your-claude-model-id

    providers:
      cometapi-claude:
        base_url: https://api.cometapi.com
        key_env: COMETAPI_KEY
        transport: anthropic_messages
        default_model: your-claude-model-id
    ```

    將 `your-claude-model-id` 替換為 [CometAPI Models 頁面](https://www.cometapi.com/models/) 上目前可用的 Claude model ID。

    <Note>
      此路由的 `base_url` 請保持為 `https://api.cometapi.com`。Hermes 會透過具名 provider 使用 Anthropic Messages transport。
    </Note>
  </Step>
</Steps>

## 驗證

<Steps>
  <Step title="檢查設定">
    以下指令可確認 Hermes 能夠讀取設定與 API 金鑰：

    ```bash theme={null}
    hermes config check
    ```

    如果 `hermes config check` 在更新後回報缺少選項，請執行 `hermes config migrate`，然後再檢查一次。
  </Step>

  <Step title="執行實際聊天測試">
    以下指令會透過 CometAPI 傳送一個真實請求：

    ```bash theme={null}
    hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
    ```

    設定成功時會回傳 `CONNECTED`，且不會出現 auth 或 endpoint 錯誤。當 Claude Messages 設定啟用時，這也會確認 Hermes 能透過 CometAPI 使用 `anthropic_messages` transport。
  </Step>
</Steps>

## 選用設定

<AccordionGroup>
  <Accordion title="全新重新安裝（選用）">
    如果你要取代較舊版本的 Hermes 安裝，請先使用內建解除安裝程式：

    ```bash theme={null}
    hermes uninstall
    ```

    在解除安裝程式中，選擇 **Full uninstall** 以移除 CLI、PATH 項目，以及 `~/.hermes/` 資料。接著重新執行安裝步驟，並使用相同的 CometAPI 設定繼續。
  </Accordion>

  <Accordion title="改用 hermes model（選用）">
    如果你偏好 OpenAI 相容路徑的互動式流程，請執行 `hermes model` 並選擇 **Custom endpoint**。

    接著輸入以下值：

    * Base URL: `https://api.cometapi.com/v1`
    * API key: 你的 CometAPI API key
    * Model: 目前可用的 CometAPI 文字 model ID

    此流程會將 OpenAI 相容提供者設定寫入 `config.yaml`。若是 Claude Messages，請直接編輯 `config.yaml`，以便具名提供者保留 `transport: anthropic_messages`。
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "搭配 CometAPI 使用 Hermes Agent",
        "description": "使用本指南透過 OpenAI 相容聊天或 Anthropic 訊息設定，將 Hermes Agent 連線至 CometAPI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "取得你的 CometAPI API key",
            "text": "建立或開啟你的 CometAPI 帳戶，然後從控制台複製一個有效的 API key。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "安裝 Hermes Agent",
            "text": "完成「搭配 CometAPI 使用 Hermes Agent」指南中的「安裝 Hermes Agent」步驟。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "儲存你的 CometAPI key",
            "text": "完成「搭配 CometAPI 使用 Hermes Agent」指南中的「儲存你的 CometAPI key」步驟。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "設定 OpenAI 相容路徑",
            "text": "完成「搭配 CometAPI 使用 Hermes Agent」指南中的「設定 OpenAI 相容路徑」步驟。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "設定 Claude Messages 路徑",
            "text": "完成「搭配 CometAPI 使用 Hermes Agent」指南中的「設定 Claude Messages 路徑」步驟。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "檢查設定",
            "text": "完成「搭配 CometAPI 使用 Hermes Agent」指南中的「檢查設定」步驟。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "執行實際聊天測試",
            "text": "完成「搭配 CometAPI 使用 Hermes Agent」指南中的「執行實際聊天測試」步驟。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 文件",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "整合",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "搭配 CometAPI 使用 Hermes Agent",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>