開發 Agent 應用時,可配置多種類型的工具來擴充 Agent 能力,實現與外部服務互動、代碼執行、知識檢索等功能。
工具概覽
LangStudio 提供 5 種工具類型,用於封裝不同形式的外部能力:
MCP 工具:將實現 MCP 協議的後端服務註冊到平台,Agent 可按需調用,實現與外部系統的安全互動。
自訂工具(OpenAPI工具):提供符合 OpenAPI 3.0+ 規範的介面定義檔案,平台自動轉換為可調用工具,每個 API 端點對應一個工具。
Python 工具:編寫 Python 函數,平台自動提取函數簽名、類型註解和文檔,產生結構化描述供 Agent 調用。
知識庫工具:將已建立的企業知識庫直接配置到 Agent 節點,推理時按需檢索私人知識。
連網搜尋工具:通過互連網搜尋引擎擷取即時資訊,Agent 可自動調用該工具查詢最新資訊、事實資料等網路內容。
根據您的使用情境選擇合適的工具類型:
工具類型 | 適用情境 | 核心特點 |
MCP 工具 | 內部微服務、私人 API | 低成本接入、內建可觀測性 |
自訂工具 | 第三方 SaaS、RESTful 服務 | 零代碼整合 |
Python 工具 | 複雜邏輯處理、本地計算 | 靈活編程、深度整合 Python 生態 |
知識庫工具 | 專屬知識問答 | 開箱即用、Agent 自動檢索 |
連網搜尋工具 | 即時資訊查詢、最新資訊擷取 | 自動連網檢索 |
工具組合與選擇建議:
同一個 Agent 可以配置多種工具。例如,組合使用 MCP 工具(調用內部 API)和 Python 工具(資料處理)來處理複雜商務邏輯。
如果內部 API 尚未實現 MCP 協議但有 OpenAPI 規範,可先使用自訂工具快速接入,後續再遷移到 MCP 工具以獲得更好的可觀測性。
配置MCP工具
建立 MCP 工具串連
進入LangStudio,在頁面,單擊新建工具。
選擇建立方式:
FunctionAI:配置通過頁面建立的MCP服務。
選擇已部署的 MCP 服務,系統自動填滿串連參數。
自訂:配置使用者自行部署或使用第三方平台託管的 MCP 服務。
transport:與 MCP 服務通訊時使用的底層傳輸協議。支援SSE和StreamableHTTP。
url:MCP 服務的完整訪問端點 URL。
authentication:用於配置訪問 MCP 服務時的身份認證資訊。支援以下三種:
BearerAuth:使用Bearer令牌認證。需在token欄位填寫有效存取權杖。
Other:需填寫auth_header_name、token,說明從哪個要求標頭擷取token。
None: 不需要身份認證。
(可選) 運行連通性測試驗證 MCP 服務可訪問。
單擊提交建立工具。
配置 Agent 節點
在Agent節點的配置頁面,找到MCP工具,支援2種配置方式:
選擇已有的MCP工具串連:需先建立可複用的MCP工具串連,詳情請參見建立 MCP 工具串連。一個 MCP 服務通常會提供多個工具(Tools),可以設定工具範圍和審批工具。
通過工具範圍選項,可以控制哪些工具對大模型可見。
對於具有敏感操作(如修改使用者資料)的工具,可以通過审批工具功能進行保護。當工作流程執行到這些工具時,節點會自動暫停,並等待人工確認;審批通過後,工作流程才會繼續執行。
自訂添加MCP配置:僅在該節點中可用。

配置其他類型工具
在Agent節點的配置頁面,進入工具,可以選擇添加各種工具。對於選中的工具,支援編輯該工具的描述、是否“需要审批”等參數。
知識庫:參見知識庫管理員建立知識庫後再為Agent添加。
自訂工具(OpenAPI工具):
可以選擇已有自訂工具或者新建自定义工具。
支援將PAI-EAS上已部署的LangStudio服務建立為工具,也可以選擇手動填入OpenAPI 規範進行建立。
工具建立成功後,可進入工具詳情頁,使用測試功能發送樣本請求並驗證響應。
Python工具:
可選擇已有工具或者新建Python工具。
如建立,設定工具集名稱後,在開啟的頁面上編輯代碼並進行測試。
查看或編輯已有 Python 工具:單擊應用開發頁面右上方的 ,檔案位於應用源碼目錄下的
tools檔案夾內。
連網搜尋工具:使用阿里雲IQS-標準搜尋,添加工具後參見阿里雲IQS-連網搜尋(IQS-GenericSearch)進行配置。