Click AI Agent API：把託管 AI 代理串接到產品

白話介紹：Click 到底是做什麼的？

Click 是提供給開發者使用的託管 AI Agent API。你的應用送出任務、指定模型和允許使用的工具，Click 負責執行代理、保存對話歷史，並處理模型呼叫、工具呼叫與執行恢復，再將結果交回產品。

例如，你想在自己的網站加入一個讀取 CSV、分析銷售數字並產生報告的助理，就能讓 Click 承接代理執行。使用者登入、資料存取規則和畫面由你控制；代理可以使用哪些工具、結果是否符合業務要求，也要由應用決定。它適合產品內建助理、文件任務與需要背景執行的多步工作，串接需要後端開發能力。

服務由 Click AI Labs, Inc. 經營。其用途是替團隊維護代理執行與持續會話的基礎設施，減少自行管理模型與工具循環的工作。

第一次串接：準備金鑰、代理與工作階段

1. 在控制台取得 Click 平台 API 金鑰，另備一把支援的模型供應商金鑰。文件要求在建立或修改資源前完成信用卡驗證，既有帳戶可能獲豁免；驗證本身不收費，也不會自動開始付費訂閱。
2. 用 POST /credentials 儲存模型金鑰，保留回傳的憑證 ID。兩種金鑰都應放在後端。
3. 透過 GET /models 取得當前模型目錄，選擇與憑證供應商相符的模型。
4. 用 POST /agents 設定模型、指令與工具，保存 latest_version.id，再以 POST /sessions 建立工作階段。
5. 向 POST /sessions/{session_id}/submissions 送出任務。加入 request_id，重試時可取得原本的提交，避免重複送出。
6. 讀取提交狀態，等待 done、cancelled 或 failed；完成後取得所指向的答案，取消或失敗則檢查原因。

HTTP 202 只表示輸入已儲存，還不能視為任務完成。建議把工作階段 ID 與自己的文件或工單綁定，後續追問便能沿用該會話的歷史。應用轉送訊息或回傳資料前，仍須檢查使用者權限。

用 MCP 與 HTTP 工具連接自己的系統

Click 可連接 MCP Streamable HTTP 伺服器或自訂 HTTP 端點，連線地址必須是公開可達的 HTTPS。建立 connection 後，再明確授予工具使用權限；HTTP 工具使用 JSON Schema 定義參數，平台以 JSON POST 呼叫，文件列出的逾時為 120 秒。

以查詢客戶工單為例，可以提供僅允許讀取指定客戶資料的 API，使用使用者範圍內的短效權杖。Click 執行工具呼叫，後端負責判斷這位使用者究竟能讀什麼。預算、業務核准和結果驗收也由應用負責。

內建能力包含網頁搜尋、瀏覽器自動化和檔案／命令沙箱。除了 Click 託管沙箱，文件亦列出 Blaxel、Daytona；瀏覽器可使用自備 Browserbase 憑證。不同供應商有各自的設定與成本，應依實際任務選擇。

背景任務、事件串流與檔案交付

透過 GET /sessions/{session_id}/events 可以顯示文字增量、工具進度與任務狀態。每次連線先收到完整 snapshot，再收到後續事件；重新連線時，以新快照取代本機狀態，才能正確恢復畫面。串流斷線不會停止代理工作，進入 standby 後串流會關閉。

長任務可訂閱帶簽章的 submission.updated、artifact.created Webhook。收到通知後，再讀取指定資源確認當前結果，讓使用者不必一直開著原頁面等待。

檔案任務適合使用 Click 託管沙箱：以 POST /files 上傳輸入，在提交中引用檔案 ID，讓代理處理工作副本，再用 publish_file 保存交付物。應用接著查詢 artifacts 並以 GET /files/{file_id} 下載。要取得可交付的報告，必須確認檔案已發布，並檢查內容；沙箱工作檔案本身不等於持久輸出。

免費方案與美元費用怎麼看？

以下依 2026 年 11 月 3 日核實的官方定價，採美元月費，並非新臺幣報價或臺灣付款方式保證。

• Free：每月 US$0。 2 個並行駐留會話、100 MB 檔案空間，每月 1 小時託管沙箱、1 小時託管瀏覽器與 100 次搜尋。
• Pro：每月 US$199。 50 個並行駐留會話、10 GB 空間，每月 100 小時託管沙箱、100 小時託管瀏覽器與 5,000 次搜尋。
• Enterprise：客製報價。 容量與額度依約定配置。

模型採 BYOK，因此模型供應商費用要另外計算，自備外部沙箱等服務也可能另行計費。儲存空間是當前容量，不是每月新增額度；託管資源由租戶內的代理與會話共用。Free 依 UTC 自然月重置，Pro 依付費帳期重置。

並行計算包含持有執行環境的活躍和閒置會話，standby 不計入。額度耗盡時工具可能拒絕執行，進行中的任務也可能停止；文件表示不會自動收取超額費用。評估成本時應同時觀察模型用量、託管時間與所需並行數。

資料處理與使用者權限要先釐清

隱私聲明列出的處理資料包含指令、訊息、檔案、工具請求及結果和連接憑證。執行代理時，內容可能傳送給模型與工具供應商，並適用對方政策。

官方團隊可能因導入協助、支援、排錯及服務改善存取服務內容；資料依合理需要保留，沒有統一固定天數。處理地點可能包含美國及其他國家，不宜推定為臺灣在地處理、零保留或保證不訓練。

金鑰應放在指定憑證設定或 API，避免出現在提示詞和上傳檔案；政策要求不要提交高度敏感且受監管的資料。應先定義允許提供的資料欄位及工具權限，再測試代理的輸出與錯誤處理。

常見問題

Click 可以免費使用嗎？

可以從 Free 開始，但並行、空間、託管時間與搜尋都有上限。模型呼叫使用自己的金鑰，可能產生額外模型費用，資源寫入通常也需要信用卡驗證。

還需要另外準備模型 API 金鑰嗎？

需要。Click 平台金鑰用來操作代理 API，模型供應商金鑰則用來呼叫選定模型。可用供應商與模型以 GET /models 回傳為準。

能串接既有 MCP 與業務 API 嗎？

可以。建立公開 HTTPS connection 並授予工具權限即可依文件串接。使用者驗證、資料授權與重要操作的業務核准仍由自己的應用執行。

官方開發資源

• API 參考文件：查閱事件、工具、Webhook 與檔案介面。
• 官方快速入門：完成第一個代理工作階段與任務。
• 服務條款與支援資訊：核對託管服務條件及官方支援方式。