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

# Gunakan Agno dengan CometAPI

> Gunakan panduan ini untuk menghubungkan agent Agno ke CometAPI dengan model provider CometAPI, API key, dan model ID.

[Agno](https://docs.agno.com/) memungkinkan Anda membangun dan menjalankan agent AI di Python. Agno menyertakan model provider `CometAPI` resmi, sehingga Anda dapat menggunakan CometAPI secara langsung dari `agno.models.cometapi` tanpa membuat adapter kustom.

## Prasyarat

* Python 3.10+
* Paket Python Agno
* Akun CometAPI dengan API key aktif — [dapatkan milik Anda di dashboard](https://www.cometapi.com/console/token)

## Konfigurasikan integrasi

<Steps>
  <Step title="Install Agno">
    Install Agno di environment Python Anda:

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

  <Step title="Setel CometAPI API key Anda">
    Simpan CometAPI API key Anda dalam variabel environment `COMETAPI_KEY`:

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

  <Step title="Buat agent Agno">
    Gunakan provider `CometAPI` resmi dari 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.")
    ```

    Ganti `your-model-id` dengan model ID saat ini dari [halaman Models CometAPI](/id/overview/models).
  </Step>

  <Step title="Jalankan agent">
    Simpan contoh sebagai `agent.py`, lalu jalankan dari sesi shell yang sama:

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

    Respons yang berhasil mengonfirmasi bahwa Agno mengirim panggilan model melalui CometAPI.
  </Step>
</Steps>

## Cara Agno terhubung ke CometAPI

Provider `CometAPI` resmi Agno membaca `COMETAPI_KEY` dari environment Anda dan menggunakan `https://api.cometapi.com/v1` sebagai base URL default. Secara internal, provider ini memperluas interface model yang kompatibel dengan OpenAI milik Agno, tetapi kode aplikasi Anda sebaiknya mengimpor dan menginisialisasi `CometAPI`.

Anda juga dapat meneruskan API key atau base URL secara eksplisit ketika runtime Anda tidak dapat membaca variabel environment:

```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.")
```

## Daftarkan model yang tersedia

Provider Agno menyediakan `get_available_models()` untuk memeriksa model ID yang tersedia melalui akun CometAPI Anda:

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

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

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="Authentication errors">
    Pastikan `COMETAPI_KEY` disetel di sesi shell yang sama yang menjalankan `agent.py`. Jika variabel tersebut tidak ada, Agno akan memunculkan authentication error sebelum mengirim permintaan model.
  </Accordion>

  <Accordion title="Model errors">
    Pastikan nilai `id` cocok dengan model ID dari [halaman Models CometAPI](/id/overview/models). Anda juga dapat memanggil `CometAPI().get_available_models()` untuk memeriksa ketersediaan model dari akun Anda.
  </Accordion>
</AccordionGroup>

## Sumber daya terkait

* [Dokumentasi provider Agno CometAPI](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Sumber provider 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)
* [Mulai cepat CometAPI](/id/overview/quick-start)
* [Halaman Models CometAPI](/id/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "Menggunakan Agno dengan CometAPI",
        "description": "Gunakan panduan ini untuk menghubungkan agen Agno ke CometAPI dengan provider model CometAPI, API key, dan model ID.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Instal Agno",
            "text": "Selesaikan langkah Instal Agno dalam panduan Menggunakan Agno dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "Tetapkan API key CometAPI Anda",
            "text": "Simpan API key CometAPI Anda di environment variable atau kolom pengaturan yang digunakan oleh integrasi."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Buat agen Agno",
            "text": "Selesaikan langkah Buat agen Agno dalam panduan Menggunakan Agno dengan CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "Jalankan agen",
            "text": "Selesaikan langkah Jalankan agen dalam panduan Menggunakan Agno dengan CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentasi CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrasi",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Menggunakan Agno dengan CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>