logo
開發者文件
搜尋
工具、工作流程與資料表

工具、工作流程與資料表

這些是 LoopAgent 的「行動能力」——配置之後,模型可以在對話中自主呼叫它們去完成目標任務。

工具與 MCP

  • 給 LoopAgent 綁定插件 / MCP 後,模型即可按需呼叫對應的工具。
  • 憑證安全:URL、API Key、鑑權頭等敏感資訊全部保存在平台側,執行也在平台側完成,模型從不接觸你的密鑰。名字類似 key / token / secret 的參數會對模型隱藏,執行時由平台注入。
  • 工具數量不多時,模型直接就能看到並呼叫;數量很多(超過 30 個)時,改為「延遲載入」模式以節省 Tokens 控制成本。

使用要點

  • 工具報錯不會中斷本輪:某個工具呼叫失敗時,工具卡裡會顯示錯誤資訊,模型會轉述或重試,繼續服務。
  • 看不到工具呼叫過程:由 LoopAgent - 輸出的「呼叫過程可見」開關控制(插件級和智慧體級都要打開)。

工具呼叫不到的排查

  1. 智慧體的工具總開關是否打開;
  2. 插件是否已綁定到該智慧體並啟用;
  3. 該操作(action)是否在插件級或智慧體級被禁用;
  4. MCP 檢查白名單是否把該工具排除在外。

工作流程

一個已發布的工作流程可以變成一個工具,模型能像呼叫工具一樣觸發它,工作流程 START 節點的入參就是這個工具的入參。

要讓工作流程變成可呼叫的工具,需要同時滿足三個條件(缺一則工具不出現,且不會報錯):

  1. 智慧體的工作流程總開關打開;
  2. 該工作流程已關聯到這個智慧體;
  3. 該工作流程已發布(只存草稿的工作流程會被跳過)。
  • 改了工作流程草稿不發布,LoopAgent 跑的仍是舊的已發布版本
  • 工作流程的「簡介」要寫清用途,否則模型檢索不到、不會呼叫。
  • 工作流程執行的積分記在工作流程所屬組織帳上。

資料表與圖表

給 LoopAgent 綁定資料表後,模型會自動獲得兩個能力:用自然語言查表,以及把查詢結果畫成圖表模型全程不寫 SQL。

  • 自然語言查表:模型用一句自然語言描述要查什麼,平台負責轉成查詢並返回結果。
  • 生成圖表:把本輪最近一次查詢的結果渲染成柱狀 / 折線 / 圓餅圖等圖表,直接展示給使用者。
  • 必須先查再畫:生成圖表前,同一輪必須先成功查過一次表。使用者新開一輪直接說「畫個圖」而沒先查,會被提示先查一次——這是設計,不是故障。

表來源:LoopAgent 的資料表在它自己的資料節點裡選擇。請在 LoopAgent 的資料節點裡選表,去改智慧體其它位置的資料表設定對 LoopAgent 無效。