Walkthrough:建立一個具有專案範本的多代理工具 | OpenAgents 部落格
本教學需要 openagents 版本 0.8.5.post4 或更高版本
本演練將教您如何建置一個透過 MCP 暴露工具的協調式多代理工作流程。我們將以「替代服務尋找器」為例——一個讓多個代理協同工作以尋找和比較網路服務替代方案的系統。
完成後,您將能夠詢問 Claude:
「尋找 Notion 的替代方案並進行比較」
並從您的多代理系統獲得詳細比較!
您將學到什麼
架構概覽
步驟 1:設定您的 Python 環境
首先,請確保您已安裝 Python 3.10 或更高版本。
如果您需要安裝 Python,請造訪 python.org 或使用您的系統套件管理器。
步驟 2:安裝 OpenAgents
從 PyPI 安裝 OpenAgents 套件:
提示:始終升級到最新版本以獲取最新功能和錯誤修復:
步驟 3:複製 OpenAgents 儲存庫
複製儲存庫以取得示範檔案:
步驟 4:了解專案範本
在啟動網路之前,讓我們了解專案範本的工作原理。開啟 demos/08_alternative_service_project/network.yaml 以查看範本定義:
關鍵設定:
步驟 5:啟動網路
啟動替代服務尋找器網路:
Studio 網頁介面將自動在您的瀏覽器中開啟,網址為 http://localhost:8700。
注意:如果瀏覽器沒有自動開啟,請手動導覽至 http://localhost:8700。
點擊「Manage Network」進入管理儀表板,輸入「admin」作為密碼。
步驟 6:設定預設模型並啟動服務代理
網路需要三個代理才能運作,讓我們首先在 Service Agents 標籤中設定服務代理的預設 LLM。
設定預設模型
在 Default Models 標籤中,設定並測試 LLM 存取。
啟動服務代理
讓我們在 Service Agents 標籤中啟動所有三個服務代理:searcher、comparer 和 coordinator。
步驟 7:在使用者主控台中測試工作流程
在連接 Claude Desktop 之前,讓我們驗證一切是否正常運作。
點擊 User Console 並切換到 Project App。讓我們啟動一個新專案並選擇 Find Service Alternatives 專案範本。
我們可以輸入「Discord」,這樣代理團隊就會開始尋找 Discord 的替代選項。
正在發生什麼:協調者收到您的請求,將其委派給搜尋器尋找替代方案,然後委派給比較器以進行詳細分析。所有通訊都透過 OpenAgents 網路進行。
步驟 9:發佈您的網路
若要將 Claude Desktop 連接到您的網路,您需要將其發佈。
從管理儀表板發佈
重要:您需要選擇一個唯一的網路 ID
發佈後,如果您前往 Dashboard,將會看到以下資訊:
複製 MCP URL - 您將在 Claude Desktop 中需要它。
步驟 10:連接 Claude Desktop
現在讓我們連接 Claude Desktop 以使用您的多代理工具。
設定 Claude Desktop
前往 Settings > Connectors,讓我們新增一個自訂連接器:
讓我們設定連接器並始終允許 find_service_alternatives 工具!
重要:請將 service-alternatives-142342 替換為您在發佈步驟中取得的實際網路 ID。
步驟 11:使用您的工具與 Claude 互動
開啟 Claude Desktop 並嘗試以下提示:
基本查詢
Claude 將會:
更多範例查詢
代理如何協同工作
協調者 (Python)
協調者是一個非 LLM 代理,負責協調工作流程:
搜尋器代理 (YAML + LLM)
搜尋器使用智慧工具選擇:
比較器代理 (YAML + LLM)
比較器也使用智慧工具選擇:
可用的 MCP 工具
連接後,Claude 可以存取:
該工具接受服務名稱並返回:
了解專案範本
專案範本是一種強大的方式來: