v1.3.11

透過 MCP 公開的工具

最後更新


連線的 agent 看得到哪些 Agenvoy 工具,以及新工具如何免重啟出現。

公開的工具


工具用途
script_* / ext_*使用者建立、內建與擴充的 script 工具(自磁碟自動探索)。api_* 工具移除於 v1.3.2,殘留的 .json 不會載入
tool_generate_guide回傳工具建置契約。它從 public_api_list 開始:有合適的 API 就直接呼叫,只有找不到或使用者提供的 API 需要 key 時才建立 script 工具。script_tool_generate_guide 仍可呼叫,作為未列出的別名
public_api_listv1.3.2 起為內建工具(原為 api_public_api_list)。不帶 category 時回傳類別名稱;帶類別時回傳各免 key API 的名稱、說明、HTTPS 旗標與文件 URL
edit_tool建立或覆寫工具檔(mode=write)、在檔內做字串取代修正(mode=patch)、丟棄過時工具(mode=remove);tag 為 json(tool.json)或 script(script.py)
test_tool以範例輸入在 sandbox 中執行 script 工具
store_secret以遮蔽輸入取得憑證並直接寫入 keychain
list_tools列出 server 公開的所有工具

橋接工具(public_api_list、edit_tool、test_tool、store_secret)與 Agenvoy 內部 runtime 共用——相同 handler、相同 schema,透過 toolRegister 分派。無重複實作。

Hot reload


Server 透過 fsnotify 監看工具目錄。當工具被建立、修改或刪除時,server 會自動重新掃描並送出 notifications/tools/list_changed — client 無需重連即可刷新工具清單。監看的目錄為 tools/script/、<workDir>/.config/agenvoy/tools/script/ 與 tools/.extension/script/;監看 api/ 目錄的行為移除於 v1.3.2。
EN