Agno 已迅速發展成為生產級 代理作業系統——一個用於多智能體系統的運行時、框架和控制平面——而 CometAPI（「一站式全模型 API」聚合器）宣布正式支援 Agno 的模型提供者。它們共同使運行多智能體系統變得簡單，該系統可以在數百個模型端點之間切換，而無需重寫代理代碼，這滿足了使用 CometAPI 等統一網關作為 Agno 等代理框架的嵌入式模型提供程序的需求——因此，我們下面描述的模式既實用又及時。
Agno 和 CometAPI 到底是什麼？
什麼是 Agno？我為什麼要關心？
Agno 是一個高效能的 Pythonic 多代理框架、運行時和 UI，旨在透過記憶體、工具、知識和人機互動支持，建立代理、團隊和代理工作流程。它提供了現成的 FastAPI 運行時 (AgentOS)、本機開發工具和控制平面 UI，讓您無需將資料傳出環境即可測試和監控正在運行的代理程式。如果您想快速建立生產級代理系統，並保持對資料和可觀察性的完全控制，Agno 正是為此而設計的。
什麼是 CometAPI？為什麼我要使用它作為 LLM 提供者？
CometAPI 是一個 API 聚合器/模型網關，它為數十到數百個 LLM 和模態（文字、圖像、視訊等）提供統一一致的 API。開發者無需綁定到單一模型供應商，而是呼叫 CometAPI 網關，並透過參數切換提供者或模型——這對於成本管理、A/B 測試和回退非常有用。該平台支援模型切換、統一計費，並聲明與 OpenAI 相容的端點——也就是說，您通常可以將 OpenAI 風格的用戶端指向 CometAPI 的基本 URL 和身份驗證令牌，並像調用 OpenAI 端點一樣調用模型。這使得 CometAPI 成為已經支援 OpenAI API 介面的框架的便捷「插入式」提供者。
近期訊號： CometAPI 宣布作為模型提供者 Agno 的官方文檔 和社群管道，這意味著 Agno 發布了 CometAPI 您可以傳遞給您的模型提供者類 Agent。這使得網關整合變得簡單且受支援。
為什麼要將 Agno 與 CometAPI 整合？
- 無需鎖定供應商：CometAPI 讓您無需更換 SDK 即可嘗試多種型號（OpenAI、Claude、LLama 變體、Gemini 等）。這與 Agno 的模型無關設計相得益彰。
- 更快的開發循環：由於 CometAPI 支援 OpenAI 風格的端點，因此您通常可以避免編寫自訂 Agno 提供者 - 您可以將 Agno 的 OpenAI 模型適配器指向 CometAPI 並啟動。
- 可觀察性+控制：使用 Agno 的 AgentOS 運行時和控制平面在本地或雲端中運行代理，同時透過 CometAPI 撥打模型，結合最佳的模型靈活性和運行時可觀察性。
如何逐步將 Agno 與 CometAPI 整合？
以下是一個實用的、可複製貼上的工作流程－從建立虛擬環境到執行透過 CometAPI 呼叫模型的本機 AgentOS 實例。
關鍵思想： 由於 CometAPI 公開了與 OpenAI 相容的端點，最簡單的方法是使用 Agno 的 OpenAI 模型適配器並指向
OPENAI_API_BASEopenai.api_base) 新增至 CometAPI 的基本 URL，同時提供您的 CometAPI 令牌作為 OpenAI API 金鑰。 CometAPI 明確記錄了此「更改 base_url + 使用 OpenAI 格式」的流程。
開始之前所需的環境和先決條件
推薦哪個作業系統、Python 版本和工具？
- 操作系統： macOS、Linux 或 Windows —— Agno 及其工具支援這三種系統。 ()
- 蟒蛇： 使用現代 CPython（Agno 文件和程式碼庫支援現代 Python 版本；建議使用 Python 3.12）。在生產部署之前，請檢查 Agno 的程式碼庫/文件以確保其相容性。
- 套件管理器/虛擬環境：
uv（星界uv專案 (project) 是管理虛擬環境和依賴項的出色且快速的選擇。
您必須準備哪些帳戶、金鑰和網路先決條件？
- CometAPI 帳戶和 API 金鑰。 從 CometAPI 取得金鑰並將其儲存在環境變數中（
COMETAPI_KEY). Agno 的 CometAPI 模型適配器讀取COMETAPI_KEY. - 可選的 Agno 控制平面帳戶（AgentOS UI）。 如果您打算將本機 AgentOS 連線到控制平面以進行監控或團隊功能，請準備好控制平面存取權和組織/團隊權限。
- 代理狀態資料庫（可選）。 為了持久化，您通常會根據規模配置 SQLite/Postgres；Agno 有顯示用於本機開發的 Sqlite 的範例。
如何逐步將 Agno 與 CometAPI 整合？
以下是一個實用的、可複製貼上的工作流程－從建立虛擬環境到執行透過 CometAPI 呼叫模型的本機 AgentOS 實例。
關鍵思想： 由於 CometAPI 公開了與 OpenAI 相容的端點，最簡單的方法是使用 Agno 的 OpenAI 模型適配器並指向
OPENAI_API_BASEopenai.api_base) 新增至 CometAPI 的基本 URL，同時提供您的 CometAPI 令牌作為 OpenAI API 金鑰。 CometAPI 明確記錄了此「更改 base_url + 使用 OpenAI 格式」的流程。
1）安裝 uv 並創建虛擬環境
uv 安裝程式（一行）：
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
建立並啟動可重現的 venv（Agno quickstart 使用 Python 3.12）：
# create a venv managed by uv
uv venv --python 3.12
# activate (POSIX)
source .venv/bin/activate
（如果您更喜歡傳統的 python -m venv .venv 這也有效； uv 提供鎖定檔案+可重複性優勢。 ）
2）安裝 Agno 和運行時相依性（透過 uv pip)
```bash
uv pip install -U agno openai mcp 'fastapi' sqlalchemy 'httpx'
# optionally, add extras you need
uv pip install -U agno # if using cloud infra plugins
（安裝您需要的其他函式庫：向量資料庫用戶端、監控函式庫等）
Agno 的常見安裝 `agno` + 提供者 SDK。
### 3）匯出 CometAPI API 金鑰
設定環境變量，Agno Comet 提供者將讀取：
bash
macOS / Linux
export COMETAPI_KEY="sk-xxxx-your-cometapi-key"
Windows (PowerShell)
setx COMETAPI_KEY "sk-xxxx-your-cometapi-key"
Agno 的 CometAPI 提供者預設讀取 `COMETAPI_KEY`.
### 4）建立一個使用 CometAPI 提供者的小型 Agno Agent
打開資料夾並建立一個新檔案。保存如下內容為 `comet_agno_agent.py`:
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.cometapi import CometAPI
from agno.os import AgentOS
from agno.tools.mcp import MCPTools
1) Create an Agent which uses CometAPI as the model provider
id parameter selects a model id from the CometAPI catalog
agno_agent = Agent(
name="Agno Agent",
model=CometAPI(id="gpt-5-mini"),
# Add a database to the Agent
db=SqliteDb(db_file="agno.db"),
# Add the Agno MCP server to the Agent
tools=,
# Add the previous session history to the context
add_history_to_context=True,
markdown=True,
)
2) Attach Agent to AgentOS and get FastAPI app
agent_os = AgentOS(agents=)
Get the FastAPI app for the AgentOS
app = agent_os.get_app()
### 5）本地運行 Agno 進行測試
啟動 AgentOS（FastAPI）開發伺服器：
In the activated .venv (uv-managed)
fastapi dev agno_comet_agent.py
defaults to http://localhost:8000
未結案工單 `http://localhost:8000/docs` 檢查自動產生的端點。
> 確保設定了環境變數（COMETAPI\_KEY\_API\_KEY）
### 6）將本地 AgentOS 連接到 AgentOS 控制平面（可選）
如果您希望 Agno Web 控制平面監控您的本機 AgentOS：
1. 存取 AgentOS 控制平面： `os.agno.com` 並登錄。
2. 每填寫完資料或做任何更動請務必點擊 **新增作業系統→本地**，進入 `http://localhost:8000`，給它取個名字，然後 **連結**.
一旦連接，您將獲得用於聊天、會話、指標和管理的 Web UI。
## 配置和安全最佳實踐是什麼？
### 秘密和 API 金鑰
切勿提交 API 金鑰。請使用環境變數、密鑰管理器或 `.env` 結合當地 `.gitignore`最佳實務：定期輪換金鑰，並在提供者支援的情況下限制 IP 使用。 （OpenAI 文件和其他供應商建議使用環境變數。）
### 模型選擇與成本控制
使用 CometAPI 的模型目錄來選擇具有適當成本/延遲權衡的模型。設定合理的速率限制並使用指數退避演算法實現重試。 CometAPI 在其文件中公開了模型清單和定價。
### 可觀察性
使用 Agno 的 AgentOS 控制平面來取得代理日誌、會話追蹤和指標。將其與提供者級指標（CometAPI 儀表板）結合，將成本/延遲與代理活動關聯起來。
### 隱私和資料駐留
由於 AgentOS 在您的雲端運行，您可以保留對會話資料的控制權。不過，除非政策明確允許，否則請避免將敏感的 PII 發送給第三方模型；如有需要，請使用本地或私人模型託管。
## 最佳實踐和推薦用例是什麼？
### 最佳實踐
- **從小開始：** 在擴展之前，使用開發代理和低層模型（更便宜）進行測試。
- **模型回退：** 實現回退鏈（例如，較便宜的小型模型→失敗時更強大的模型）。 CometAPI 可以輕鬆地透過名稱切換模型。
- **細粒度工具：** 為代理提供有限的、經過審計的工具（例如網頁搜尋、資料庫存取）以及具有追蹤功能的儀表化工具呼叫。 Agno 提供工具整合和儀表化呼叫的模式。
- **速率限制和批次：** 批量處理類似的請求，並在網關或客戶端應用速率限制以避免激增。
### 典型用例
- **RAG（檢索增強生成）聊天機器人** — 用於文件的 Agno 代理 + 用於語言產生的 CometAPI。
- **自動化的工作流程** — 結合了網頁抓取工具、向量資料庫和生成步驟的多代理程式工作流程。
- **從原型到生產** — 使用 CometAPI 快速迭代以嘗試不同的模型，然後固定所選提供者或轉移到企業合約。
## 如何開始使用 Comet API
CometAPI 是一個統一的 API 平台，它將來自領先供應商（例如 OpenAI 的 GPT 系列、Google 的 Gemini、Anthropic 的 Claude、Midjourney、Suno 等）的 500 多個 AI 模型聚合到一個開發者友好的介面中。透過提供一致的身份驗證、請求格式和回應處理，CometAPI 顯著簡化了將 AI 功能整合到您的應用程式中的過程。無論您是建立聊天機器人、影像產生器、音樂作曲家，還是資料驅動的分析流程，CometAPI 都能讓您更快地迭代、控製成本，並保持與供應商的兼容性——同時也能充分利用整個 AI 生態系統的最新突破。
首先，探索模型的功能 [彗星API](https://www.cometapi.com/zh-TW/?utm_source=agno uted) ，詳見 [游乐场](https://www.cometapi.com/console/playground) 並查閱繼續 [API指南](https://apidoc.cometapi.com/continue-1624859m0) 以獲得詳細說明。造訪前請確保您已經登入CometAPI並取得API金鑰。 [COM](https://www.cometapi.com/zh-TW/)[e](https://www.cometapi.com/zh-TW/?utm_source=agno uted)[tAPI](https://www.cometapi.com/zh-TW/) 提供遠低於官方價格的價格，幫助您整合。
準備出發了嗎？ → [立即註冊 CometAPI](https://api.cometapi.com/login) !
如果您想了解更多有關 AI 的提示、指南和新聞，請關注我們 [VK](https://vk.com/id1078176061), [X](https://x.com/cometapi2025) [不和](https://discord.com/invite/HMpuV6FCrG)!
## 最後的思考
將 Agno 與 CometAPI 集成，為您提供了一種實用的方法，可以建立靈活、可觀察且與供應商無關的代理系統。 Agno 提供運行時和控制平面；CometAPI 提供存取多個模型的單一閘道。兩者結合，可以減少營運摩擦：減少每個代理商的模型管道，簡化實驗，並實現集中計費/控制。