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

# Sử dụng Hermes Agent với CometAPI

> Sử dụng hướng dẫn này để kết nối Hermes Agent với CometAPI thông qua cài đặt chat tương thích OpenAI hoặc Anthropic Messages.

Sử dụng [CometAPI](https://www.cometapi.com) làm nhà cung cấp model cho [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). Hermes hỗ trợ hai cách dùng CometAPI trong hướng dẫn này: một endpoint tương thích OpenAI chung cho hầu hết các model văn bản và một tuyến Claude thông qua Anthropic Messages.

## Điều kiện tiên quyết

* Git
* Tài khoản CometAPI với API key đang hoạt động
* Terminal trên macOS, Linux hoặc WSL2

## Cài đặt

<Steps>
  <Step title="Lấy CometAPI API key của bạn">
    Đăng nhập vào [bảng điều khiển CometAPI](https://www.cometapi.com/console/token). Nhấp vào **Add API Key** và sao chép CometAPI API key của bạn.

    <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="Bảng điều khiển CometAPI hiển thị nút Add API Key" 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="Chi tiết API key của CometAPI với base URL được hiển thị" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Cài đặt Hermes Agent">
    Lệnh sau sẽ chạy trình cài đặt chính thức:

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

    Nếu shell hiện tại vẫn chưa nhận thấy lệnh `hermes`, hãy tải lại cấu hình shell:

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

    <Note>
      Hermes lưu cấu hình trong `~/.hermes/`, liên kết lệnh `hermes` trong `~/.local/bin`, và có thể thêm `~/.local/bin` vào PATH của shell.
    </Note>
  </Step>
</Steps>

## Cấu hình

Chọn route CometAPI khớp với họ model:

| Họ model                         | Cấu hình Hermes                                                                              | Route CometAPI              |
| -------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------- |
| Model văn bản tương thích OpenAI | `model.provider: custom` với `base_url: https://api.cometapi.com/v1`                         | `/v1/chat/completions`      |
| Model Claude                     | Provider được đặt tên với `transport: anthropic_messages`                                    | `/v1/messages`              |
| Model Gemini trong Hermes        | Sử dụng cấu hình tương thích OpenAI                                                          | `/v1/chat/completions`      |
| Lệnh gọi Gemini API trực tiếp    | Sử dụng [Gemini `generateContent` API](/api/text/gemini-generating-content) bên ngoài Hermes | `/v1beta` `generateContent` |

<Warning>
  Không cấu hình Hermes với `https://api.cometapi.com/v1beta` như một provider Gemini-native tùy chỉnh. Hãy sử dụng cấu hình Hermes tương thích OpenAI cho các model Gemini. Đối với lệnh gọi Gemini API trực tiếp, hãy dùng [Gemini `generateContent` API](/api/text/gemini-generating-content).
</Warning>

<Steps>
  <Step title="Lưu khóa CometAPI của bạn">
    Mở `~/.hermes/.env` và thêm các giá trị sau:

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

    `COMETAPI_KEY` được dùng bởi provider Claude được đặt tên. `OPENAI_API_KEY` giúp cơ chế dự phòng endpoint tùy chỉnh tương thích OpenAI của Hermes tiếp tục hoạt động.
  </Step>

  <Step title="Cấu hình route tương thích OpenAI">
    Sử dụng route này cho hầu hết các model văn bản CometAPI, bao gồm cả các model Gemini được dùng từ Hermes. Mở `~/.hermes/config.yaml` và đảm bảo phần `model` trông như sau:

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

    Thay `your-model-id` bằng một model ID văn bản hiện có từ [trang Models của CometAPI](https://www.cometapi.com/models/).

    <Note>
      Giữ khóa API trong `~/.hermes/.env`. Không hardcode secret trong `config.yaml`.
    </Note>

    <Note>
      Thiết lập này cấu hình model chat chính. Hermes có thể sử dụng các model phụ trợ riêng cho những tác vụ như vision hoặc trích xuất web.
    </Note>
  </Step>

  <Step title="Cấu hình route Claude Messages">
    Sử dụng route này khi bạn muốn Hermes gọi các model Claude thông qua Anthropic Messages. Mở `~/.hermes/config.yaml` và sử dụng một provider được đặt tên:

    ```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
    ```

    Thay `your-claude-model-id` bằng một model ID Claude hiện có từ [trang Models của CometAPI](https://www.cometapi.com/models/).

    <Note>
      Giữ `base_url` là `https://api.cometapi.com` cho route này. Hermes sử dụng transport Anthropic Messages từ provider được đặt tên.
    </Note>
  </Step>
</Steps>

## Xác minh

<Steps>
  <Step title="Kiểm tra cấu hình">
    Lệnh sau xác nhận rằng Hermes có thể đọc config và khóa API:

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

    Nếu `hermes config check` báo thiếu tùy chọn sau một lần cập nhật, hãy chạy `hermes config migrate` rồi kiểm tra lại.
  </Step>

  <Step title="Chạy kiểm tra chat thực tế">
    Lệnh sau gửi một request thực tế qua CometAPI:

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

    Thiết lập thành công sẽ trả về `CONNECTED` và không có lỗi auth hoặc endpoint. Khi cấu hình Claude Messages đang hoạt động, điều này xác nhận rằng Hermes có thể sử dụng transport `anthropic_messages` thông qua CometAPI.
  </Step>
</Steps>

## Cấu hình tùy chọn

<AccordionGroup>
  <Accordion title="Cài đặt lại sạch (tùy chọn)">
    Nếu bạn đang thay thế một bản cài đặt Hermes cũ hơn, hãy dùng trình gỡ cài đặt tích hợp sẵn trước:

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

    Trong trình gỡ cài đặt, chọn **Gỡ cài đặt hoàn toàn** để xóa CLI, mục nhập PATH và dữ liệu `~/.hermes/`. Sau đó chạy lại bước cài đặt và tiếp tục với cùng cấu hình CometAPI.
  </Accordion>

  <Accordion title="Dùng model hermes thay thế (tùy chọn)">
    Nếu bạn muốn dùng luồng tương tác cho tuyến OpenAI-compatible, hãy chạy `hermes model` và chọn **Custom endpoint**.

    Sau đó nhập các giá trị sau:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: khóa API CometAPI của bạn
    * Model: một model ID model văn bản CometAPI hiện tại

    Luồng này ghi cài đặt provider OpenAI-compatible vào `config.yaml`. Với Claude Messages, hãy chỉnh sửa trực tiếp `config.yaml` để provider đã đặt tên vẫn giữ `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": "Sử dụng Hermes Agent với CometAPI",
        "description": "Sử dụng hướng dẫn này để kết nối Hermes Agent với CometAPI thông qua cài đặt chat OpenAI-compatible hoặc Anthropic Messages.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "Lấy khóa API CometAPI của bạn",
            "text": "Tạo hoặc mở tài khoản CometAPI của bạn, sau đó sao chép một khóa API đang hoạt động từ trang tổng quan."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Cài đặt Hermes Agent",
            "text": "Hoàn thành bước Cài đặt Hermes Agent trong hướng dẫn Sử dụng Hermes Agent với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "Lưu khóa CometAPI của bạn",
            "text": "Hoàn thành bước Lưu khóa CometAPI của bạn trong hướng dẫn Sử dụng Hermes Agent với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "Cấu hình tuyến OpenAI-compatible",
            "text": "Hoàn thành bước Cấu hình tuyến OpenAI-compatible trong hướng dẫn Sử dụng Hermes Agent với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Cấu hình tuyến Claude Messages",
            "text": "Hoàn thành bước Cấu hình tuyến Claude Messages trong hướng dẫn Sử dụng Hermes Agent với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Kiểm tra cấu hình",
            "text": "Hoàn thành bước Kiểm tra cấu hình trong hướng dẫn Sử dụng Hermes Agent với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Chạy kiểm thử chat thực tế",
            "text": "Hoàn thành bước Chạy kiểm thử chat thực tế trong hướng dẫn Sử dụng Hermes Agent với CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Tài liệu CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Tích hợp",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Sử dụng Hermes Agent với CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>