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

# Agno を CometAPI と使う

> このガイドでは、CometAPI model provider、API key、model ID を使って Agno エージェントを CometAPI に接続する方法を説明します。

[Agno](https://docs.agno.com/) を使うと、Python で AI エージェントを構築して実行できます。Agno には公式の `CometAPI` model provider が含まれているため、カスタムアダプターを作成せずに `agno.models.cometapi` から直接 CometAPI を利用できます。

## 前提条件

* Python 3.10+
* Agno Python パッケージ
* 有効な API key を持つ CometAPI アカウント — [ダッシュボードで取得](https://www.cometapi.com/console/token)

## 統合を設定する

<Steps>
  <Step title="Agno をインストールする">
    Python 環境に Agno をインストールします:

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

  <Step title="CometAPI API key を設定する">
    CometAPI API key を `COMETAPI_KEY` 環境変数に保存します:

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

  <Step title="Agno エージェントを作成する">
    Agno の公式 `CometAPI` provider を使用します:

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

    `your-model-id` は、[CometAPI Models page](/ja/overview/models) にある現在の model ID に置き換えてください。
  </Step>

  <Step title="エージェントを実行する">
    例を `agent.py` として保存し、同じシェルセッションから実行します:

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

    レスポンスが正常に返れば、Agno が CometAPI 経由でモデル呼び出しを送信していることが確認できます。
  </Step>
</Steps>

## Agno が CometAPI に接続する仕組み

Agno の公式 `CometAPI` provider は、環境から `COMETAPI_KEY` を読み取り、デフォルトの base URL として `https://api.cometapi.com/v1` を使用します。内部的には Agno の OpenAI 互換モデルインターフェースを拡張していますが、アプリケーションコードでは `CometAPI` を import してインスタンス化する必要があります。

実行環境で環境変数を読み取れない場合は、API key や base URL を明示的に渡すこともできます:

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

## 利用可能なモデルを一覧表示する

Agno の provider は、CometAPI アカウントで利用可能な model ID を確認するための `get_available_models()` を提供しています:

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

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

## トラブルシューティング

<AccordionGroup>
  <Accordion title="認証エラー">
    `agent.py` を実行しているのと同じシェルセッションで `COMETAPI_KEY` が設定されていることを確認してください。変数が設定されていない場合、Agno はモデルリクエストを送信する前に認証エラーを発生させます。
  </Accordion>

  <Accordion title="モデルエラー">
    `id` の値が [CometAPI Models page](/ja/overview/models) の model ID と一致していることを確認してください。`CometAPI().get_available_models()` を呼び出して、アカウントで利用可能なモデルを確認することもできます。
  </Accordion>
</AccordionGroup>

## 関連リソース

* [Agno CometAPI プロバイダのドキュメント](https://docs.agno.com/models/providers/gateways/cometapi/overview)
* [Agno CometAPI プロバイダのソース](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/models/cometapi/cometapi.py)
* [Agno CometAPI クックブック](https://github.com/agno-agi/agno/tree/main/cookbook/90_models/cometapi)
* [CometAPI クイックスタート](/ja/overview/quick-start)
* [CometAPI Models ページ](/ja/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "CometAPI で Agno を使う",
        "description": "このガイドを使用して、CometAPI model provider、API key、model ID を使って Agno エージェントを CometAPI に接続します。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "Agno をインストールする",
            "text": "CometAPI で Agno を使うガイドの「Agno をインストールする」手順を完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "CometAPI API key を設定する",
            "text": "CometAPI API key を、この統合で使用する環境変数または設定フィールドに保存します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "Agno エージェントを作成する",
            "text": "CometAPI で Agno を使うガイドの「Agno エージェントを作成する」手順を完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "エージェントを実行する",
            "text": "CometAPI で Agno を使うガイドの「エージェントを実行する」手順を完了します。"
          }
        ]
      },
      {
        "@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 で Agno を使う",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>