內建工具(與系統 MCP)
平台隨附的工具 — 潛在客戶收集、文件、後續追蹤、網頁搜尋,以及自動安裝的時間/天氣/位置伺服器。
list_toolsupdate_agent你不需要自行建置通用工具——平台已隨附提供。使用 update_agent(name, add_tools=[…]) 掛載該代理程式工作所需的工具;保持工具數量精簡(請參閱 設計原則)。請務必以 list_tools() 確認你租用戶中的確切名稱——這才是唯一事實來源。
tools=[…]會取代整個列表;add_tools/remove_tools則變更單一項目。 僅傳入你心中所想工具的tools=參數,會靜默地遺漏所有你未先讀取的現有工具——這在生產環境中曾發生過,且直到某個功能無法運作前都無人察覺。僅在你明確意指「恰好此集合」時才使用tools=,並無論如何都要讀取回傳的代理程式以確認最終列表。技能(add_skills/remove_skills)與知識庫(add_knowledge_bases/remove_knowledge_bases)也有相同的配對參數。
內建工具
| 工具 | 功能說明 |
|---|---|
web_search | 在開放網路搜尋資訊。 |
save_contact | 將最終使用者的聯絡資料儲存至其檔案——這是平台的潛在客戶收集 / 記錄途徑。回傳一個真實的參考代碼(類似 AB2C-D3EF 格式),代理程式會轉述給使用者;請在該使用者的詳細資料頁面(recent_refs)上查詢這些代碼。 |
export_document | 為對話產生結構化文件(品牌化的摘要 / 報告)。 |
schedule_followup | 主動在稍後進行後續追蹤(「2天後再檢查」)或預約使用者要求的手機回撥——訊息會由系統自動發送。回傳一個可追蹤至排定任務的真實預約參考編號。對於絕對時間(「明天上午 10 點」),請指示模型傳入 run_at(本地 ISO 日期時間 + 可選的 tz)——伺服器會解析使用者的時區;手算的 delay_seconds 僅適用於相對時間,且模型常會算錯。時間範圍:最多 7 天。 |
schedule_reminder | 為最終使用者設定提醒;list_reminders / cancel_reminder 用於管理這些提醒。 |
compute_chart | 以程式碼方式計算衍生數據系列——佔比、成長百分比、累計總和、固定費率下的預測,或計量計費(基本費用 + 額度 + 每單位超額費用)。已自動掛載至任何已有工具的代理程式,因此你很少需要手動新增它。請參閱 回答中的圖表。 |
load_skill 也是內建的,但你不需要掛載它——當技能的 description 相符時,模型會自行拉取技能。
list_tools() # 你租用戶中可用的確切名稱
update_agent(name="Support", add_tools=["save_contact", "schedule_followup"]) # 增量更新——保留現有項目使用 save_contact 儲存聯絡資料會填充使用者記錄;結合代理程式上的 ask_forms,結構化的資料收集會以記錄形式落地,你可以在主控台中進行檢視。
平台會自動備份這兩項功能。 當最終使用者的訊息包含明確的信號——電話號碼 / 電子郵件(任何語言,包括拼寫出的數字和帶空格的格式),或類似「明天早上打給我」的回撥請求——且已啟用 save_contact / schedule_followup 時,平台會在每個回合注入提示,提醒模型在回答前呼叫該工具。在生產後端進行基準測試後,這將最弱模型的潛在客戶收集合規率從約 85% 提升至 100%,且零誤報儲存(該提示帶有「錯誤時忽略」的逃生機制,因此過度熱心的偵測器不會導致錯誤資料)。你免費獲得此功能——無需配置;你的技能仍應在 description 中說明觸發條件(請參閱 撰寫技能),此提示僅是安全網,而非替代品。
系統 MCP——已安裝
每個租用戶都有一個預設啟用的內建 system MCP 伺服器,提供免鑰匙的工具,用於本地時間、天氣和 IP 地理定位(城市 / 區域 / 時區)。你無需註冊它——它就在這裡。其工具會與上述內建工具一同顯示在 list_tools() 中,隨時可供掛載。
因此,「使用者所在地的天氣如何?」或「他們的本地時間是什麼?」等功能开箱即用——平台會注入最終使用者的客戶端 IP,因此無需設定即可提供與位置相關的回答。