基本概念

沙箱模板（Template）

沙箱模板是沙箱实例的规格定义，描述了实例创建时的运行环境配置，包括镜像、资源规格、网络配置、存储挂载和环境变量等参数。模板是静态定义，本身不运行任务。

通过模板可以将环境配置标准化和复用，避免每次创建实例时重复配置。一个模板可以创建多个沙箱实例。

沙箱实例（Sandbox）

沙箱实例是基于沙箱模板创建的运行态沙箱，是AgentSphere中实际执行任务的环境。每个实例运行在独立的虚拟化环境中，拥有独立的文件系统、网络空间和进程环境，实例间完全隔离。

API Key

API Key是调用AgentSphere API和SDK的认证凭证，通过API或SDK操作沙箱资源时（如创建沙箱模板、创建沙箱实例等），需携带API Key进行身份鉴权。

Agent入站网关部署（Client-to-Agent）

保护外部客户端与华为云内Agent、沙箱之间的通信。确保只有经过许可的客户端可以访问Agent，并对入站流量应用安全策略。

Agent出站网关部署（Agent-to-Anywhere）

保护华为云内的Agent与外部服务之间的通信。当Agent访问组织内部系统或第三方MCP服务器时，执行严格的访问权限管理和安全护栏。（即将上线，敬请期待）

Agent Target（关联目标）

企业批准使用的Agent、沙箱的集中式目录，提供统一管理功能，是Agent Gateway验证连接目标的依据。

工作负载身份

工作负载身份（workload Identity）是专门为AI Agent 打造的“数字身份证”。它为 Agent 赋予独立的安全身份，解决的是Agent“从哪来（入站合法性）、能干什么（出站凭据与权限）、出了事找谁（可追溯性）”的根本问题。它是实现企业级、生产可用的 Agentic AI 架构中最底层的安全基石。

Agent Identity为Agent颁发全局唯一的身份标识URN，格式为agentIdentity:<region>:<account-id>:workloadIdentity:workloadIdentityDirectory/<workload-directory-id>/<workload-identity-name>。并关联Agent的入站认证类型（JWT、IAM、API Key），在用户访问Agent时，使用工作负载配置的认证类型进行认证。

工作负载访问令牌

工作负载访问令牌（workload Access Token，简称WAT）是专门为Agent工作负载身份颁发的临时访问凭据，其中包含了工作负载身份和用户的身份信息，用于从凭证库（Token Vault）中换取出站访问凭证进而访问第三方外部工具。

凭证库

凭证库（Token Vault）负责加密存储（KMS）和管理外部资源的凭证，包括 OAuth 2.0 访问令牌、刷新令牌、客户端凭证（client credentials）以及API Keys。这些凭证由凭证提供商（Credential Provider）在认证流程完成后生成并安全存储到 Token Vault，确保敏感信息不暴露在Agent代码或运行环境中。Token Vault通过严格的访问控制机制，仅允许持有有效WAT的Agent访问凭证。

凭证提供商

凭证提供商（Credential Provider）负责管理Agent访问外部资源认证配置，内置支持Google、GitHub、Slack、Salesforce等主流服务的预配置端点，也允许通过自定义OAuth 2.0配置扩展到任意兼容服务器。该组件负责编排完整的认证流程（包括用户同意、授权码交换等），从而让Agent开发者无需手动实现复杂OAuth逻辑或硬编码凭证。认证成功后，生成的短期访问令牌、刷新令牌或API keys将自动存储到凭证库（Token Vault）中，并通过SDK注解（如@requires_access_token）安全注入Agent代码，实现自动刷新和最小权限访问。