将 Agno 与 CometAPI 搭配使用

Agno 让你能够在 Python 中构建和运行 AI 代理。Agno 内置了官方 CometAPI model provider，因此你可以直接通过 agno.models.cometapi 使用 CometAPI，而无需创建自定义适配器。

前置条件

Python 3.10+
Agno Python 包
拥有一个带有效 API key 的 CometAPI 账户 — 在控制台获取

配置集成

安装 Agno

在你的 Python 环境中安装 Agno：

pip install -U agno

设置你的 CometAPI API key

将你的 CometAPI API key 存储到 COMETAPI_KEY 环境变量中：

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

创建一个 Agno 代理

使用 Agno 官方的 CometAPI provider：

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 页面的当前 model ID。

运行代理

将示例保存为 agent.py，然后在同一个 shell 会话中运行它：

python agent.py

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

Agno 如何连接到 CometAPI

Agno 官方的 CometAPI provider 会从你的环境中读取 COMETAPI_KEY，并使用 https://api.cometapi.com/v1 作为默认 base URL。它在内部扩展了 Agno 与 OpenAI 兼容的模型接口，但你的应用代码应当导入并实例化 CometAPI。当你的运行环境无法读取环境变量时，也可以显式传入 API key 或 base URL：

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：

from agno.models.cometapi import CometAPI

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

故障排查

身份验证错误

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

模型错误

确认 id 值与 CometAPI Models 页面中的某个 model ID 匹配。你也可以调用 CometAPI().get_available_models() 来查看你账户中的模型可用性。

概览

AI 编码智能体

AI 智能体

AI 聊天客户端

翻译与语言

自动化平台

可观测性与评估

AI 框架

前置条件

配置集成

Agno 如何连接到 CometAPI

列出可用模型

故障排查

相关资源

​前置条件

​配置集成

​Agno 如何连接到 CometAPI

​列出可用模型

​故障排查

​相关资源

前置条件

配置集成

Agno 如何连接到 CometAPI

列出可用模型

故障排查

相关资源