# 基本概念 #### 智能体沙箱（Agent Sandbox） 智能体沙箱是AgentSphere的核心运行组件，为Agent应用提供安全隔离的执行环境。每个沙箱实例包含独立的CPU、内存、文件系统和网络空间，支持代码执行、浏览器操作、全环境模拟等多种场景。沙箱之间通过MicroVM技术实现内核级隔离，防止沙箱逃逸。 #### 沙箱模板（Template） 沙箱模板是沙箱实例的规格定义，描述了实例创建时的运行环境配置，包括镜像、资源规格、网络配置、存储挂载和环境变量等参数。模板是静态定义，本身不运行任务。 通过模板可以将环境配置标准化和复用，避免每次创建实例时重复配置。一个模板可以创建多个沙箱实例。 #### 沙箱实例（Sandbox） 沙箱实例是基于沙箱模板创建的运行态沙箱，是AgentSphere中实际执行任务的环境。每个实例运行在独立的虚拟化环境中，拥有独立的文件系统、网络空间和进程环境，实例间完全隔离。 #### API Key API Key是调用AgentSphere API和SDK的认证凭证，通过API或SDK操作沙箱资源时（如创建沙箱模板、创建沙箱实例等），需携带API Key进行身份鉴权。 #### 智能体网关（Agent Gateway） 智能体网关是Agent应用出入双向的安全代理网关，作为Agent与外部世界之间的安全集中控制点，实施统一的访问权限控制、内容AI防护、URL管控等治理策略。 #### Agent入站网关部署（Client-to-Agent） 保护外部客户端与华为云内Agent、沙箱之间的通信。确保只有经过许可的客户端可以访问Agent，并对入站流量应用安全策略。 #### Agent出站网关部署（Agent-to-Anywhere） 保护华为云内的Agent与外部服务之间的通信。当Agent访问组织内部系统或第三方MCP服务器时，执行严格的访问权限管理和安全护栏。（即将上线，敬请期待） #### Agent Target（关联目标） 企业批准使用的Agent、沙箱的集中式目录，提供统一管理功能，是Agent Gateway验证连接目标的依据。 #### 智能体身份（Agent Identity） 智能体身份为Agent应用提供端到端的身份与访问控制能力，包括身份认证、安全策略管控、凭证管理和出站授权，确保Agent的身份可信、访问可控。 #### 工作负载身份 工作负载身份（workload Identity）是专门为AI Agent 打造的"数字身份证"。它为 Agent 赋予独立的安全身份，解决的是Agent"从哪来（入站合法性）、能干什么（出站凭据与权限）、出了事找谁（可追溯性）"的根本问题。它是实现企业级、生产可用的 Agentic AI 架构中最底层的安全基石。 Agent Identity为Agent颁发全局唯一的身份标识URN，格式为*agentIdentity:\:\:workloadIdentity:workloadIdentityDirectory/\/\*。并关联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代码，实现自动刷新和最小权限访问。 #### E2B E2B是业界主流的Agent沙箱接口标准。AgentSphere兼容E2B API和SDK，已有E2B应用可迁移至AgentSphere。 E2B提供两个定位不同的SDK：[e2b](https://pypi.org/project/e2b/)和[e2b-code-interpreter](https://pypi.org/project/e2b-code-interpreter/)。 - [e2b](https://pypi.org/project/e2b/)是一个通用的安全沙箱环境，可运行shell命令、操作文件系统、处理Git工作流等。 - [e2b-code-interpreter](https://pypi.org/project/e2b-code-interpreter/)是基于e2b构建的一个"开箱即用"的代码执行工具，是一个专门为"执行代码"这个场景定制的沙箱，支持上下文状态保留。