> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jaaxis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 建立與管理自訂工具

> 透過自訂工具收集顧客資料，並視需要呼叫外部 API。

自訂工具讓代理為商務任務收集資料，並視需要呼叫外部 API。建立前，請先確認任務、需要的資料與預期結果。

<Steps>
  <Step title="開啟自訂工具">
    開啟代理的「串接」頁面與「自訂工具」卡片，再選擇「新增工具」。
  </Step>

  <Step title="描述任務">
    在「要做什麼？」說明工具應在何時執行，以及需要收集哪些資料。選擇「產生」，或使用「手動新增」自行設定。
  </Step>

  <Step title="檢查收集資料">
    檢查「名稱」、「描述」與「要收集的資料」，逐一確認欄位及替代選項。只有任務需要交由團隊處理時，才開啟「使用此工具後通知真人」。
  </Step>

  <Step title="視需要設定 API">
    若只需收集資料，請保持「呼叫外部 API」關閉。需要呼叫 API 時，請先完成下方設定再儲存。
  </Step>

  <Step title="儲存並驗證">
    選擇「儲存」，確認工具出現在清單中，並檢查「啟用工具」。在「預覽」使用無敏感資料的內容測試，確認收集的資料，以及預期的真人轉接或外部系統結果。
  </Step>
</Steps>

## 選用：呼叫外部 API

請向目標系統的負責人取得 HTTPS 位址、請求方法、必要輸入與允許的操作，不要猜測設定值。

依需求設定「Method」、「Base URL」、「參數」、「Header」與「Body」。憑證只能填入專用 Header 欄位，不要放在描述、知識庫或範例中。已儲存的 Header 值不會顯示；「取代」會更換已儲存的整組 Header。

「發送測試」會實際傳送請求，可能建立或修改資料。請使用安全的測試目標與測試值。測試後，在「資料存取」選擇「完整資料存取」或「限制資料存取」，只允許代理看到需要的回應欄位，再儲存確認過的設定。

## 維護工具

開啟工具即可編輯。關閉「啟用工具」可暫停使用並保留設定。「刪除工具」會移除工具，但不會撤銷已在外部系統完成的操作。

可在[知識庫](/zh-Hant/build/add-knowledge)加入簡短的工具專用指引。請將商務事實與工具使用時機的指示分開維護。
