透過 Agent Platform 的 Managed Agents API，只要呼叫一次 API，就能建構代管自主代理。每個代理都採用 Antigravity 框架，在沙箱環境中運作，可進行推論、規劃、使用代理技能、執行程式碼、搜尋網路，以及讀取和寫入檔案。
系統架構
Agent Platform 上的 Managed Agents API 採用兩項重要介面：
| API | 說明 |
|---|---|
| Agents API | 管理代理的控制層。您可以使用這項服務，根據設定建立代理，並設定其執行環境，包括掛接外部資料來源和定義網路許可清單。系統會將這些設定套用至代理的沙箱執行環境。連結外部資料來源和工具時必須經過驗證，相關限制請參閱「安全性與最佳做法」。 |
| Interactions API | 這是資料層，是執行階段與已部署代理通訊及互動的主要介面。這個外掛程式會連結至使用 Agents API 建立的代理。 |
為強化安全性，每個代理都會在獨立的沙箱環境中運作。使用 Cloud Storage 等外部來源自訂環境時，系統會視需要將這些檔案直接載入容器的檔案系統，代理則可將結果寫回 Cloud Storage。詳情請參閱「Agent Platform 沙箱環境中的 Managed Agents API 參考資料」。
安全性與最佳做法
根據預設，每個代理都會在沙箱環境中執行動作，無法存取外部系統、網路或憑證。代理只能與自身沙箱中的檔案、套件和資料互動。
也就是說，代理預設無法發出網路呼叫、存取資料庫，或連上任何正式環境基礎架構。
沙箱以外的任何連線都必須由開發人員明確設定。詳情請參閱「設定網路存取權」。
網路存取設定
請只在用途需要時啟用這項功能，並盡可能縮小存取範圍。
為環境啟用網路存取權後，代理就能連上外部 API、複製公開存放區，以及下載套件。啟用網路存取權前，請考量下列事項：
- 避免公開機密端點。除非您已評估風險，並準備好監控代理的活動，否則請勿將代理指向內部服務、管理面板或資料庫。
- 查看代理動作。啟用網路存取權後，請監控代理的互動情形 (尤其是在初始開發階段)，確認代理只會存取您指定的資源。
憑證最佳做法
如果工作流程需要代理向外部服務 (例如 MCP 伺服器) 進行驗證，您必須負責佈建及設定這些憑證的範圍。請遵循下列規範，降低風險：
- 使用最小權限憑證。建立服務帳戶或 API 金鑰時，請僅授予代理所需的權限。避免傳遞具有廣泛或管理員權限的憑證。
- 建議使用短期權杖。請盡可能使用有時效性的憑證或權杖，而非長期有效的 API 金鑰。
- 請勿傳遞您不希望代理使用的憑證。代理可能會使用任何可存取的憑證，完成您指派的工作。請只提供您願意授予完整存取權的憑證。
- 定期輪替憑證。請比照處理任何程式輔助憑證的方式，定期輪換與代理程式共用的憑證。
連結外部工具和 API
Agents API 支援連結外部工具和 API (例如 MCP 伺服器)，可擴充代理的功能。請注意：
- 仔細評估工具來源。請只連結信任來源的工具。惡意或編寫不當的工具可能會導致資料外洩，或執行非預期的動作。
- 設定工具權限範圍。設定工具時，請授予用途所需的最低權限。如果工具支援唯讀模式，請盡量使用該模式，除非需要寫入權限。
- 先單獨測試。將工具連結至正式環境資料來源前，請先使用範例或合成資料進行測試，確認代理是否能正常使用。
專人監督
代理能推論、規劃，並以高度自主性執行多步驟工作流程。雖然這項功能很強大，但也代表您應採取適當的監督措施，尤其是修改資料或與外部系統互動的工作。
部署前，請務必驗證重要輸出內容，例如生成的程式碼、資料轉換或設定變更。
支援和意見回饋
如需 Agent Platform 的 Managed Agents API 支援，或想提供意見，請傳送電子郵件至公開討論群組：managed-agents-in-agent-platform@google.com。