
如何在 Apifox 中發(fā)布多語(yǔ)言的 API 文檔?
根據(jù)是否收取部署費(fèi)用,有以下兩種計(jì)費(fèi)模式:
您可以開(kāi)通百煉預(yù)置的 MCP 服務(wù),也可以部署其他來(lái)源的 MCP 服務(wù),并在智能體和工作流應(yīng)用中使用這些 MCP 服務(wù)。
開(kāi)通后,您可以使用百煉預(yù)置的 MCP 服務(wù)。以“開(kāi)通 Amap Maps MCP 服務(wù)”為例:
您可以通過(guò)百煉智能體應(yīng)用和工作流應(yīng)用使用 MCP 服務(wù)。
在智能體應(yīng)用中,大模型會(huì)根據(jù)用戶(hù)的問(wèn)題,智能判斷是否調(diào)用 MCP 服務(wù)。
說(shuō)明:DeepSeek、QwQ 系列模型不支持使用 MCP 服務(wù)。
前往百煉應(yīng)用管理,打開(kāi)一個(gè)智能體應(yīng)用。
您可以同時(shí)添加至多 5 個(gè) MCP 服務(wù),智能體將根據(jù)用戶(hù)需求調(diào)用合適的 MCP 服務(wù)。
以下是幾個(gè)常見(jiàn)的 MCP 服務(wù)使用場(chǎng)景,供您參考。
路程規(guī)劃逐步思考氣溫趨勢(shì)
請(qǐng)確認(rèn)已添加 Amap Maps MCP 服務(wù),幫助智能體獲取地理信息。
在右側(cè)對(duì)話(huà)窗格中發(fā)送一條測(cè)試消息:“現(xiàn)在出發(fā),從杭州蕭山國(guó)際機(jī)場(chǎng)到杭州西湖景區(qū)。請(qǐng)你提供三種公共交通出行方案”。您將看到智能體多次調(diào)用 MCP 服務(wù),完成路徑規(guī)劃和時(shí)間估算。
MCP 服務(wù)可能有多個(gè)工具。在工作流應(yīng)用中,每個(gè) MCP 節(jié)點(diǎn)只能使用一個(gè)工具。您需要手動(dòng)指定 MCP 節(jié)點(diǎn)的輸入?yún)?shù),再傳遞輸出參數(shù)到下一個(gè)節(jié)點(diǎn)。
使用“Amap Maps”MCP 服務(wù)的“maps_weather”工具,您可以快速構(gòu)建一個(gè)城市天氣查詢(xún)工作流。
為了快速構(gòu)建工作流,示例工作流無(wú)法回答與天氣查詢(xún)無(wú)關(guān)的問(wèn)題。
前往百煉應(yīng)用管理,新建一個(gè)對(duì)話(huà)型工作流應(yīng)用。
刪除開(kāi)始節(jié)點(diǎn)的兩個(gè)默認(rèn)參數(shù)。
說(shuō)明:這一步將用戶(hù)的自然語(yǔ)言解析為 MCP 節(jié)點(diǎn)需要的城市名稱(chēng)。
從左側(cè)工具欄中拖入一個(gè)大模型節(jié)點(diǎn),命名為“信息提取”。請(qǐng)將此節(jié)點(diǎn)連接到開(kāi)始節(jié)點(diǎn),并按照指引填寫(xiě)參數(shù)。
除以下參數(shù)外,其他參數(shù)保持默認(rèn)即可:
參數(shù)名 | 參數(shù)值 |
模型配置 | 通義千問(wèn)-Max |
System Prompt | 你是一個(gè)信息提取專(zhuān)家,你的任務(wù)是幫助“查詢(xún)天氣工具”解析正確的輸入?yún)?shù)。—“查詢(xún)天氣工具”的描述如下:名稱(chēng):maps_weather描述:根據(jù)城市名稱(chēng)或者標(biāo)準(zhǔn)adcode查詢(xún)指定城市的天氣輸入?yún)?shù):city [string] 城市名稱(chēng)或者adcode輸出參數(shù):result [string] 城市的天氣預(yù)報(bào)—你的輸出是“查詢(xún)天氣工具”的輸入,你只需要輸出城市的名稱(chēng)即可。注意:你一次只能輸出一個(gè)城市。 |
User Prompt | 參數(shù)名 參數(shù)值 模型配置 通義千問(wèn)-Max System Prompt 你是一個(gè)信息提取專(zhuān)家,你的任務(wù)是幫助“查詢(xún)天氣工具”解析正確的輸入?yún)?shù)。—“查詢(xún)天氣工具”的描述如下:名稱(chēng):maps_weather描述:根據(jù)城市名稱(chēng)或者標(biāo)準(zhǔn)adcode查詢(xún)指定城市的天氣輸入?yún)?shù):city [string] 城市名稱(chēng)或者adcode輸出參數(shù):result [string] 城市的天氣預(yù)報(bào)—你的輸出是“查詢(xún)天氣工具”的輸入,你只需要輸出城市的名稱(chēng)即可。注意:你一次只能輸出一個(gè)城市。 User Prompt |
說(shuō)明:使用 MCP 節(jié)點(diǎn)前,您通常需要將用戶(hù)的自然語(yǔ)言轉(zhuǎn)換為 MCP 節(jié)點(diǎn)的輸入?yún)?shù)。因此,您需要在 System Prompt 里描述 MCP 服務(wù)的功能和輸入輸出信息,限定大模型的輸出格式。
使用高德 MCP 服務(wù)提供的天氣查詢(xún)工具,接收一個(gè)城市名,返回該城市的天氣信息。
從左側(cè)工具欄中拖入一個(gè) MCP 節(jié)點(diǎn),按照?qǐng)D示選擇 maps_weather 工具,確認(rèn)節(jié)點(diǎn)配置。
請(qǐng)將 MCP 節(jié)點(diǎn)命名為“天氣查詢(xún)工具”,然后將此節(jié)點(diǎn)連接到“信息提取”節(jié)點(diǎn)。
說(shuō)明:點(diǎn)擊節(jié)點(diǎn)左上角的箭頭按鈕,即可展開(kāi)或收起節(jié)點(diǎn)配置。
點(diǎn)擊 MCP 節(jié)點(diǎn)內(nèi) maps_weather 工具的配置按鈕,修改輸入為“引用:信息提取/result”。
說(shuō)明:將 MCP 服務(wù)返回的結(jié)果整理成自然語(yǔ)言,方便用戶(hù)閱讀。
從左側(cè)工具欄中拖入一個(gè)大模型節(jié)點(diǎn),命名為“信息總結(jié)”。請(qǐng)將此節(jié)點(diǎn)連接到“天氣查詢(xún)工具”節(jié)點(diǎn),并按照指引填寫(xiě)參數(shù)。
除以下參數(shù)外,其他參數(shù)保持默認(rèn)即可:
參數(shù)名 | 參數(shù)值 |
模型配置 | 通義千問(wèn)-Max |
System Prompt | 你是一個(gè)信息處理助手,你的任務(wù)是將用戶(hù)輸入的信息整合為自然語(yǔ)言。 |
User Prompt | 您需要鍵入”/”來(lái)呼出變量菜單,選中“天氣查詢(xún)工具 > result” |
將結(jié)果傳遞到結(jié)束節(jié)點(diǎn)后,用戶(hù)才可以看到天氣信息。
請(qǐng)將此節(jié)點(diǎn)連接到“信息總結(jié)”節(jié)點(diǎn),并按照指引填寫(xiě)參數(shù)。
除以下參數(shù)外,其他參數(shù)保持不變。
參數(shù)名 | 參數(shù)值 |
輸入框 | 鍵入”/”來(lái)呼出變量菜單,選中“信息總結(jié) > result |
點(diǎn)擊右上角“測(cè)試”按鈕,輸入“查詢(xún)杭州天氣”,即可看到工作流輸出“杭州”的天氣信息。
除了百煉預(yù)置的 MCP 服務(wù)外,您還可以部署開(kāi)源社區(qū)和其他來(lái)源的自定義 MCP 服務(wù)。百煉會(huì)將您的自定義 MCP 服務(wù)部署至阿里云函數(shù)計(jì)算 FC。
以部署開(kāi)源社區(qū)的 Knowledge Graph Memory MCP 服務(wù)為例:
1、創(chuàng)建 MCP 服務(wù)
前往MCP 管理,點(diǎn)擊創(chuàng)建 MCP 服務(wù)。
2、配置 MCP 服務(wù)
按照以下指引填寫(xiě)配置,確認(rèn)無(wú)誤后提交部署。
服務(wù)名稱(chēng)和描述:填寫(xiě) MCP 服務(wù)的名稱(chēng)和功能簡(jiǎn)介。
安裝方式:當(dāng)前僅支持 npx。
說(shuō)明:npx 是一個(gè)隨 npm 一起安裝的工具,用于快速執(zhí)行 npm 包中的命令行工具或可執(zhí)行文件,它允許在不全局安裝包的情況下直接運(yùn)行命令 ,從而簡(jiǎn)化了項(xiàng)目?jī)?nèi)部模塊的使用流程。
部署方式:學(xué)習(xí)和測(cè)試 MCP 服務(wù)時(shí),建議選擇“按次付費(fèi)”。詳細(xì)計(jì)費(fèi)規(guī)則請(qǐng)參考計(jì)費(fèi)說(shuō)明。
部署地域:選擇 MCP 服務(wù)的部署位置。推薦與您其他云服務(wù)保持在同一地域,以?xún)?yōu)化性能。若不確定如何選擇,可選用“北京”地域。
MCP 服務(wù)配置:您可以直接使用以下配置代碼。
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}
說(shuō)明:通常情況下,MCP 服務(wù)提供商會(huì)提供詳細(xì)的配置代碼,粘貼至此處即可。以Knowledge Graph Memory MCP 服務(wù)為例,您可以在MCP 廣場(chǎng)找到這個(gè) MCP 服務(wù),單擊進(jìn)入詳情頁(yè),找到標(biāo)題為 NPX
的配置代碼。
3、使用 MCP 服務(wù)
部署完成后,您可以將自定義 MCP 服務(wù)接入智能體應(yīng)用和工作流應(yīng)用。
MCP 最先由 Anthropic 提出,是一個(gè)開(kāi)源、標(biāo)準(zhǔn)的協(xié)議。MCP 的詳細(xì)介紹和具體實(shí)現(xiàn),請(qǐng)參考 MCP 官網(wǎng)。
百煉支持部署自定義 MCP 服務(wù),目前僅支持 npx 的安裝方式,未來(lái)會(huì)支持 uvx 和 SSE 的安裝方式。詳細(xì)部署方法請(qǐng)參考快速入門(mén)。
目前僅支持接入百煉應(yīng)用,暫不支持在其他 MCP 客戶(hù)端使用。
目前暫不支持訪問(wèn)用戶(hù)本地資源(例如本地?cái)?shù)據(jù)庫(kù))。
智能體編排應(yīng)用暫不支持 MCP 協(xié)議。請(qǐng)您通過(guò)智能體或工作流應(yīng)用接入 MCP 服務(wù)。
DeepSeek、QwQ 系列模型暫不支持調(diào)用 MCP 服務(wù),請(qǐng)嘗試使用其他模型。
智能體應(yīng)用會(huì)根據(jù)提示詞智能判斷是否調(diào)用 MCP 服務(wù)。請(qǐng)先嘗試調(diào)整提示詞,如果問(wèn)題無(wú)法解決,請(qǐng)?jiān)賴(lài)L試更換效果更好的大模型(如通義千問(wèn)-Max)。
文章轉(zhuǎn)載自:阿里云百煉MCP Server 快速入門(mén)
如何在 Apifox 中發(fā)布多語(yǔ)言的 API 文檔?
在 Golang 中實(shí)現(xiàn) JWT 令牌認(rèn)證
國(guó)產(chǎn)頂流AI大模型:比喻文案生成能力API測(cè)試效果對(duì)比
Claude API 能使用 OpenAI 接口協(xié)議嗎?
天貓商品數(shù)據(jù)爬取方案:官方API與非官方接口實(shí)戰(zhàn)
地圖開(kāi)發(fā)者平臺(tái)對(duì)比:高德、百度、騰訊、必應(yīng)、天地圖等API
讓大模型“聯(lián)網(wǎng)”的第一步?手把手教你調(diào)用搜索API!
API接口安全—webservice、Swagger、WEBpack
從零開(kāi)始認(rèn)識(shí) API,讓網(wǎng)頁(yè)信息成為你的「知識(shí)庫(kù)」
對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力
一鍵對(duì)比試用API 限時(shí)免費(fèi)