> ## 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 Agno với CometAPI

> Sử dụng hướng dẫn này để kết nối agent Agno với CometAPI bằng model provider CometAPI, API key và model ID.

[Agno](https://docs.agno.com/) cho phép bạn xây dựng và chạy các AI agent bằng Python. Agno có model provider `CometAPI` chính thức, vì vậy bạn có thể sử dụng CometAPI trực tiếp từ `agno.models.cometapi` mà không cần tạo adapter tùy chỉnh.

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

* Python 3.10+
* Gói Python Agno
* Tài khoản CometAPI với API key đang hoạt động — [lấy API key trong dashboard](https://www.cometapi.com/console/token)

## Cấu hình tích hợp

<Steps>
  <Step title="Install Agno">
    Cài đặt Agno trong môi trường Python của bạn:

    ```bash theme={null}
    pip install -U agno
    ```
  </Step>

  <Step title="Set your CometAPI API key">
    Lưu API key CometAPI của bạn vào biến môi trường `COMETAPI_KEY`:

    ```bash theme={null}
    read -rsp "CometAPI API key: " COMETAPI_KEY
    printf '\n'
    export COMETAPI_KEY
    ```
  </Step>

  <Step title="Create an Agno agent">
    Sử dụng provider `CometAPI` chính thức của Agno:

    ```python theme={null}
    from agno.agent import Agent
    from agno.models.cometapi import CometAPI

    agent = Agent(
        model=CometAPI(id="your-model-id"),
        markdown=True,
    )

    agent.print_response("Write a short product update in three bullet points.")
    ```

    Thay `your-model-id` bằng model ID hiện tại từ [trang Models của CometAPI](/vi/overview/models).
  </Step>

  <Step title="Run the agent">
    Lưu ví dụ dưới dạng `agent.py`, sau đó chạy nó trong cùng phiên shell:

    ```bash theme={null}
    python agent.py
    ```

    Phản hồi thành công xác nhận rằng Agno đang gửi các lệnh gọi model thông qua CometAPI.
  </Step>
</Steps>

## Cách Agno kết nối với CometAPI

Provider `CometAPI` chính thức của Agno đọc `COMETAPI_KEY` từ môi trường của bạn và sử dụng `https://api.cometapi.com/v1` làm base URL mặc định. Nội bộ nó mở rộng giao diện model tương thích OpenAI của Agno, nhưng mã ứng dụng của bạn nên import và khởi tạo `CometAPI`.

Bạn cũng có thể truyền API key hoặc base URL một cách tường minh khi runtime của bạn không thể đọc biến môi trường:

```python theme={null}
import os

from agno.agent import Agent
from agno.models.cometapi import CometAPI

agent = Agent(
    model=CometAPI(
        id="your-model-id",
        api_key=os.environ["COMETAPI_KEY"],
        base_url="https://api.cometapi.com/v1",
    )
)

agent.print_response("Summarize the benefits of a unified AI API.")
```

## Liệt kê các model khả dụng

Provider của Agno cung cấp `get_available_models()` để kiểm tra các model ID khả dụng thông qua tài khoản CometAPI của bạn:

```python theme={null}
from agno.models.cometapi import CometAPI

model = CometAPI()
available_models = model.get_available_models()
print(available_models)
```

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="Authentication errors">
    Hãy xác nhận rằng `COMETAPI_KEY` được đặt trong cùng phiên shell đang chạy `agent.py`. Nếu biến này bị thiếu, Agno sẽ phát sinh lỗi xác thực trước khi gửi yêu cầu model.
  </Accordion>

  <Accordion title="Model errors">
    Hãy xác nhận rằng giá trị `id` khớp với một model ID từ [trang Models của CometAPI](/vi/overview/models). Bạn cũng có thể gọi `CometAPI().get_available_models()` để kiểm tra tình trạng khả dụng của model từ tài khoản của mình.
  </Accordion>
</AccordionGroup>

## Tài nguyên liên quan

* [Tài liệu nhà cung cấp Agno CometAPI](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Mã nguồn nhà cung cấp Agno CometAPI](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Cookbook Agno CometAPI](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [Bắt đầu nhanh với CometAPI](/vi/overview/quick-start)
* [Trang Models của CometAPI](/vi/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "Sử dụng Agno với CometAPI",
        "description": "Sử dụng hướng dẫn này để kết nối các agent Agno với CometAPI bằng nhà cung cấp model CometAPI, API key và model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Cài đặt Agno",
            "text": "Hoàn thành bước Cài đặt Agno trong hướng dẫn Sử dụng Agno với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "Thiết lập CometAPI API key của bạn",
            "text": "Lưu CometAPI API key của bạn vào biến môi trường hoặc trường cài đặt được integration sử dụng."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Tạo một agent Agno",
            "text": "Hoàn thành bước Tạo một agent Agno trong hướng dẫn Sử dụng Agno với CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "Chạy agent",
            "text": "Hoàn thành bước Chạy agent trong hướng dẫn Sử dụng Agno 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 Agno với CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>