> ## 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 页面](/zh-Hans/overview/models) 的当前 model ID。
  </Step>

  <Step title="运行代理">
    将示例保存为 `agent.py`，然后在同一个 shell 会话中运行它：

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

    成功返回响应即表示 Agno 正在通过 CometAPI 发送模型调用。
  </Step>
</Steps>

## Agno 如何连接到 CometAPI

Agno 官方的 `CometAPI` provider 会从你的环境中读取 `COMETAPI_KEY`，并使用 `https://api.cometapi.com/v1` 作为默认 base URL。它在内部扩展了 Agno 与 OpenAI 兼容的模型接口，但你的应用代码应当导入并实例化 `CometAPI`。

当你的运行环境无法读取环境变量时，也可以显式传入 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 提供了 `get_available_models()`，用于检查你的 CometAPI 账户可用的 model ID：

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

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

## 故障排查

<AccordionGroup>
  <Accordion title="身份验证错误">
    确认 `COMETAPI_KEY` 已在运行 `agent.py` 的同一个 shell 会话中设置。如果该变量缺失，Agno 会在发送模型请求之前抛出身份验证错误。
  </Accordion>

  <Accordion title="模型错误">
    确认 `id` 值与 [CometAPI Models 页面](/zh-Hans/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 快速开始](/zh-Hans/overview/quick-start)
* [CometAPI 模型页面](/zh-Hans/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/agno#howto",
        "name": "使用 Agno 与 CometAPI",
        "description": "使用本指南通过 CometAPI 模型提供商、API 密钥和 model ID 将 Agno 智能体连接到 CometAPI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-1",
            "position": 1,
            "name": "安装 Agno",
            "text": "完成“使用 Agno 与 CometAPI”指南中的“安装 Agno”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-2",
            "position": 2,
            "name": "设置你的 CometAPI API 密钥",
            "text": "将你的 CometAPI API 密钥存储在该集成使用的环境变量或设置字段中。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-3",
            "position": 3,
            "name": "创建 Agno 智能体",
            "text": "完成“使用 Agno 与 CometAPI”指南中的“创建 Agno 智能体”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/agno#step-4",
            "position": 4,
            "name": "运行智能体",
            "text": "完成“使用 Agno 与 CometAPI”指南中的“运行智能体”步骤。"
          }
        ]
      },
      {
        "@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": "使用 Agno 与 CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/agno"
          }
        ]
      }
    ]
    }
    `}
</script>