
如何在 Apifox 中發布多語言的 API 文檔?
根據是否收取部署費用,有以下兩種計費模式:
您可以開通百煉預置的 MCP 服務,也可以部署其他來源的 MCP 服務,并在智能體和工作流應用中使用這些 MCP 服務。
開通后,您可以使用百煉預置的 MCP 服務。以“開通 Amap Maps MCP 服務”為例:
您可以通過百煉智能體應用和工作流應用使用 MCP 服務。
在智能體應用中,大模型會根據用戶的問題,智能判斷是否調用 MCP 服務。
說明:DeepSeek、QwQ 系列模型不支持使用 MCP 服務。
前往百煉應用管理,打開一個智能體應用。
您可以同時添加至多 5 個 MCP 服務,智能體將根據用戶需求調用合適的 MCP 服務。
以下是幾個常見的 MCP 服務使用場景,供您參考。
路程規劃逐步思考氣溫趨勢
請確認已添加 Amap Maps MCP 服務,幫助智能體獲取地理信息。
在右側對話窗格中發送一條測試消息:“現在出發,從杭州蕭山國際機場到杭州西湖景區。請你提供三種公共交通出行方案”。您將看到智能體多次調用 MCP 服務,完成路徑規劃和時間估算。
MCP 服務可能有多個工具。在工作流應用中,每個 MCP 節點只能使用一個工具。您需要手動指定 MCP 節點的輸入參數,再傳遞輸出參數到下一個節點。
使用“Amap Maps”MCP 服務的“maps_weather”工具,您可以快速構建一個城市天氣查詢工作流。
為了快速構建工作流,示例工作流無法回答與天氣查詢無關的問題。
前往百煉應用管理,新建一個對話型工作流應用。
刪除開始節點的兩個默認參數。
說明:這一步將用戶的自然語言解析為 MCP 節點需要的城市名稱。
從左側工具欄中拖入一個大模型節點,命名為“信息提取”。請將此節點連接到開始節點,并按照指引填寫參數。
除以下參數外,其他參數保持默認即可:
參數名 | 參數值 |
模型配置 | 通義千問-Max |
System Prompt | 你是一個信息提取專家,你的任務是幫助“查詢天氣工具”解析正確的輸入參數。—“查詢天氣工具”的描述如下:名稱:maps_weather描述:根據城市名稱或者標準adcode查詢指定城市的天氣輸入參數:city [string] 城市名稱或者adcode輸出參數:result [string] 城市的天氣預報—你的輸出是“查詢天氣工具”的輸入,你只需要輸出城市的名稱即可。注意:你一次只能輸出一個城市。 |
User Prompt | 參數名 參數值 模型配置 通義千問-Max System Prompt 你是一個信息提取專家,你的任務是幫助“查詢天氣工具”解析正確的輸入參數。—“查詢天氣工具”的描述如下:名稱:maps_weather描述:根據城市名稱或者標準adcode查詢指定城市的天氣輸入參數:city [string] 城市名稱或者adcode輸出參數:result [string] 城市的天氣預報—你的輸出是“查詢天氣工具”的輸入,你只需要輸出城市的名稱即可。注意:你一次只能輸出一個城市。 User Prompt |
說明:使用 MCP 節點前,您通常需要將用戶的自然語言轉換為 MCP 節點的輸入參數。因此,您需要在 System Prompt 里描述 MCP 服務的功能和輸入輸出信息,限定大模型的輸出格式。
使用高德 MCP 服務提供的天氣查詢工具,接收一個城市名,返回該城市的天氣信息。
從左側工具欄中拖入一個 MCP 節點,按照圖示選擇 maps_weather 工具,確認節點配置。
請將 MCP 節點命名為“天氣查詢工具”,然后將此節點連接到“信息提取”節點。
說明:點擊節點左上角的箭頭按鈕,即可展開或收起節點配置。
點擊 MCP 節點內 maps_weather 工具的配置按鈕,修改輸入為“引用:信息提取/result”。
說明:將 MCP 服務返回的結果整理成自然語言,方便用戶閱讀。
從左側工具欄中拖入一個大模型節點,命名為“信息總結”。請將此節點連接到“天氣查詢工具”節點,并按照指引填寫參數。
除以下參數外,其他參數保持默認即可:
參數名 | 參數值 |
模型配置 | 通義千問-Max |
System Prompt | 你是一個信息處理助手,你的任務是將用戶輸入的信息整合為自然語言。 |
User Prompt | 您需要鍵入”/”來呼出變量菜單,選中“天氣查詢工具 > result” |
將結果傳遞到結束節點后,用戶才可以看到天氣信息。
請將此節點連接到“信息總結”節點,并按照指引填寫參數。
除以下參數外,其他參數保持不變。
參數名 | 參數值 |
輸入框 | 鍵入”/”來呼出變量菜單,選中“信息總結 > result |
點擊右上角“測試”按鈕,輸入“查詢杭州天氣”,即可看到工作流輸出“杭州”的天氣信息。
除了百煉預置的 MCP 服務外,您還可以部署開源社區和其他來源的自定義 MCP 服務。百煉會將您的自定義 MCP 服務部署至阿里云函數計算 FC。
以部署開源社區的 Knowledge Graph Memory MCP 服務為例:
1、創建 MCP 服務
前往MCP 管理,點擊創建 MCP 服務。
2、配置 MCP 服務
按照以下指引填寫配置,確認無誤后提交部署。
服務名稱和描述:填寫 MCP 服務的名稱和功能簡介。
安裝方式:當前僅支持 npx。
說明:npx 是一個隨 npm 一起安裝的工具,用于快速執行 npm 包中的命令行工具或可執行文件,它允許在不全局安裝包的情況下直接運行命令 ,從而簡化了項目內部模塊的使用流程。
部署方式:學習和測試 MCP 服務時,建議選擇“按次付費”。詳細計費規則請參考計費說明。
部署地域:選擇 MCP 服務的部署位置。推薦與您其他云服務保持在同一地域,以優化性能。若不確定如何選擇,可選用“北京”地域。
MCP 服務配置:您可以直接使用以下配置代碼。
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}
說明:通常情況下,MCP 服務提供商會提供詳細的配置代碼,粘貼至此處即可。以Knowledge Graph Memory MCP 服務為例,您可以在MCP 廣場找到這個 MCP 服務,單擊進入詳情頁,找到標題為 NPX
的配置代碼。
3、使用 MCP 服務
部署完成后,您可以將自定義 MCP 服務接入智能體應用和工作流應用。
MCP 最先由 Anthropic 提出,是一個開源、標準的協議。MCP 的詳細介紹和具體實現,請參考 MCP 官網。
百煉支持部署自定義 MCP 服務,目前僅支持 npx 的安裝方式,未來會支持 uvx 和 SSE 的安裝方式。詳細部署方法請參考快速入門。
目前僅支持接入百煉應用,暫不支持在其他 MCP 客戶端使用。
目前暫不支持訪問用戶本地資源(例如本地數據庫)。
智能體編排應用暫不支持 MCP 協議。請您通過智能體或工作流應用接入 MCP 服務。
DeepSeek、QwQ 系列模型暫不支持調用 MCP 服務,請嘗試使用其他模型。
智能體應用會根據提示詞智能判斷是否調用 MCP 服務。請先嘗試調整提示詞,如果問題無法解決,請再嘗試更換效果更好的大模型(如通義千問-Max)。
文章轉載自:阿里云百煉MCP Server 快速入門