借助 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。