如何隔離 AI Agent 的 API Key、錢包與資產

哪些秘密絕不能進入 Prompt？

seed phrase、原始私鑰、提款／管理 key、完整 API token、OTP 與恢復碼都不得進入。

遮罩後的識別碼可供追蹤，但模型不需要知道可直接使用的秘密。還要檢查 debug dump、錯誤訊息、RAG 文件和支援對話，因為秘密常從這些旁路回到上下文。

如何留下證據： 建立禁止資料分類和自動掃描位置清單。

API Key 要如何依功能拆分？

按提供者、環境、資源和動作拆成唯讀、交易、提款與管理等最小 scope。

每個 key 還需來源限制、速率、預算、到期和 owner。若提供者不支援細粒度權限，應在代理前加受控服務，而不是把全能 key 直接交給 Agent。

如何留下證據： 保存 key ID 後四碼、scope、consumer、來源、期限和撤銷人。

錢包需要什麼隔離？

測試、營運、收費與國庫錢包應分離，簽章服務不向 Agent 暴露 key。

營運錢包只保留工作所需小額，合約限制資產、目的地、方法和期間額度。國庫轉移走獨立、多方且較慢的流程，不能由同一 orchestration 路徑升權。

如何留下證據： 保存地址用途、餘額上限、owner/module、allowance 和補資金流程。

如何留下紀錄而不洩漏秘密？

記錄穩定識別碼、scope、結果和遮罩欄位，不保存可重播的 header 或簽章材料。

結構化 log 在寫入前就應 redact；不能依賴事後人工刪除。trace 權限也要分層，備份、錯誤追蹤和第三方 observability 必須納入資料流。

如何留下證據： 用測試 canary 驗證應用、queue、log、備份和告警均不留原值。

什麼證據能證明輪替真的有效？

用測試憑證演練新 key 上線、舊 key 失效、服務恢復和備份清除。

只更新 vault 值不代表所有 worker、快取和 CI 已停止使用舊 key。演練應量測撤銷時間、錯誤告警、回滾和是否存在無人擁有的 consumer。

如何留下證據： 保存輪替時間線、舊 key 拒絕結果、服務健康和殘留掃描。

驗證工作簿

以下檢查卡把研究變成可重做紀錄。它們不產生投資建議，而是要求保存證據、反例、版本、限制與會改變結論的條件。

常見問題