配置运行环境

为智能体自定义运行环境。

环境（Environment）定义智能体运行位置（“哪里运行”），涵盖出网网络配置、会话存储等配置项。被智能体关联后禁止修改。

环境是独立于智能体的运行沙箱。一个环境可以被多个智能体引用。

适用场景

智能体需要调用公网API
当智能体需要访问公网上的第三方服务（如天气API、新闻API）时，选择公网访问。
智能体需要访问企业内网数据
当智能体需要查询企业内部数据库、访问内网微服务时，选择私网访问并配置VPC。

选型建议

表1 网络访问模式对比表
对比维度	公网访问	私网访问
适用场景	智能体仅需访问公网服务	智能体需访问企业内网资源
Skill支持	支持添加Skill	支持添加Skill
网络隔离	流量经互联网出口	流量不经过互联网
配置复杂度	低，无需额外配置	高，需配置VPC/子网/安全组
创建后可修改	否	否

表2 存储类型选型表
存储类型	适用场景	特点	数量限制
会话存储	保存会话上下文、中间结果	每会话独立空间，不可取消	仅支持1个
SFS Turbo	高性能共享文件存储	低时延、弹性扩容，支持多主机同时挂载	最多5个
OBS	对象存储，保存产生的文件	弹性、低成本，适合大量非结构化数据	最多10个（≤5个桶）

费用说明

创建环境本身免费，但依赖云服务将产生按需费用：SFS Turbo、OBS、VPC（NAT网关、EIP）按各自规则计费，具体请参考SFS Turbo按需计费、OBS按需计费、NAT网关按需计费和弹性公网IP按需计费。

约束与限制

每个租户可以创建1000个环境。

前提条件

已开通AgentArts服务，并在“管理中心 > 授权管理”完成依赖云服务授权。

创建环境

出网网络配置在环境创建后不可修改。请在创建前确认网络访问需求（公网/私网），并提前准备好VPC、子网、安全组等资源。

在Managed Agents页面，选择“环境”页签，单击“创建环境”，配置环境参数。创建后，环境显示在环境列表中。

图1 创建环境

基本信息

环境的基本信息，便于查找、调用和管理。

图2 基本信息

表3 基本信息
参数	说明
名称	环境的展示名称，供用户在列表中快速识别与检索该环境。系统默认生成以environment开头的名称，可以自定义。创建后，不可修改。由2~40个字符组成，包含小写字母、数字和-，且必须以小写字母开头、以小写字母或数字结尾。
描述（可选）	环境的描述信息，帮助用户快速理解该环境。由0~4096个字符组成。

网络配置

Managed Agents环境提供出网网络配置能力。

沙箱向外发起网络请求的能力，是基础设施层的安全边界，优先级高于系统提示词、工具权限，即使提示词被注入攻击，网络层依然可以拦截非法访问。

出网网络配置在环境创建后，不可修改。

公网访问：通过互联网出口访问公网上的服务。默认公网访问。
私网访问：打通企业私有VPC内网，只能访问内网资源，流量不经过互联网。配置完成后，建议在智能体中发起测试请求，验证VPC内网连通性。

VPC免费，但NAT网关、EIP会产生按需费用，具体请参考NAT网关按需计费和弹性公网IP按需计费。

当选择“私网访问”时，需配置如下参数：
- 选择已配置的VPC，默认显示第一个。如未配置，请单击“新建VPC”，具体请参考创建虚拟私有云和子网。
- 选择已配置的子网，默认显示第一个。如未配置，请单击“新建子网”，具体请参考创建虚拟私有云和子网。
- 选择已配置的安全组，默认显示第一个。如未配置，请单击“新建安全组”，具体请参考创建安全组。

存储配置

存储配置决定沙箱中文件的挂载方式、数据保留时长、产物输出路径，和网络配置一样属于底层资源配置。优先级高于系统提示词、工具权限。存储配置完成后，可在环境详情页的“存储配置”区域确认各存储类型的挂载状态。

SFS Turbo、OBS会产生按需费用，具体请参考SFS Turbo计费说明和OBS按需计费。

图3 存储配置

表4 存储配置参数说明
参数	说明
会话存储	会话级别的持久化存储，用于保存会话上下文、中间结果、用户偏好等。存储资源由后台服务统一托管，每个会话拥有独立存储空间。配置后不可取消，仅支持1个。挂载路径为/home、/mnt、/data、/tmp及其子目录，不能包含“..”，最大长度为4000字符。
SFS Turbo	当“出网网络配置”选择“私网访问”时，支持此参数。高性能分布式共享文件存储服务，支持多云主机、容器同时挂载访问，提供低时延、弹性扩容的持久化文件存储能力。最多添加5个SFS Turbo类型的存储，且SFS Turbo仅在私网访问下支持配置。单击“添加”，详细参数配置请参考表5。
OBS	当“出网网络配置”选择“私网访问”时，支持此参数。用于保存会话过程中产生的文件等，存储资源为用户的OBS桶。最多只能选择5个不同的OBS桶，最多添加10个OBS类型的存储，且OBS仅在私网访问下支持配置。单击“添加”，详细参数配置请参考表5。

表5 添加存储参数说明
类型	参数	说明
会话存储	挂载路径	输入会话存储将被挂载的具体目录路径。配置后，每个会话在持久化存储中拥有独立的子目录，这些子目录将作为状态存储挂载到该路径。挂载路径为/home、/mnt、/data、/tmp及其子目录，不能包含“..”，最大长度为4000字符。存在多个挂载时（包括OBS、SFS Turbo、会话存储之间），禁止使用相同或存在包含关系的路径。
SFS Turbo	文件系统	选择文件系统。如未创建，单击“创建文件系统”，详细操作说明请参考创建文件系统。配置后单击刷新。说明： SFS Turbo和智能体运行时中的出网网络配置必须在同一VPC内，SFS Turbo文件系统使用的安全组需放通NFS协议使用的端口号，具体信息请参考VPC的安全组是否影响高性能弹性文件服务的使用，安全组需要放通运行时出站的子网网段访问SFS Turbo。选择的文件系统需为NFS协议。 AgentArts部署智能体运行时时挂载NFS文件系统的soft/hard的模式为hard模式，关于soft/hard的模式详情信息请查看挂载SFS Turbo文件系统到Linux云服务器。为了您的信息安全，请勿在文件系统中存放敏感数据。
	存储路径	输入文件系统中数据的存储路径。存储路径以“/”开头，不能包含“..”，最大长度4000字符，默认为/。
	挂载路径	输入文件系统中数据的挂载路径，使得该目录下的文件和目录可以被访问。挂载路径为/home、/mnt、/data、/tmp及其子目录，不能包含相对路径，最大长度为4000字符。存在多个挂载时（包括OBS、SFS Turbo、会话存储之间），禁止使用相同或存在包含关系的路径。同一智能体运行时的多个版本挂载在同一目录时会自动共享。说明：挂载路径的Linux文件系统权限，继承自SFS Turbo存储路径的原有权限（SFS Turbo根目录权限为任何用户可读写）。此权限不支持通过chmod/chown等命令修改。
	读写权限	选择对挂载文件系统的读写权限。读写：可以读取、写入和修改文件系统中的数据，默认为读写。说明： Linux文件系统权限和读写权限两者必须同时允许，读写才能成功，如果任一项禁止，读写操作将失败。只读：只能读取文件系统中的数据，不能写入或修改数据。
OBS	OBS桶	选择已创建的OBS桶。如未创建，单击“创建OBS桶”，详细操作说明请参考创建桶。配置后单击刷新。说明：挂载路径的OBS文件系统权限，继承自OBS存储路径的原有权限（OBS根目录默认权限为任何用户可读写）。此权限不支持通过chmod/chown等命令修改。 OBS仅支持桶类型，暂不支持并行文件系统。为了您的信息安全，请勿在文件系统中存放敏感数据。
	存储路径 (可选)	输入OBS桶内的子目录路径。挂载OBS桶内的指定子路径，当配置为空时挂载整个桶根目录；非空时挂载桶内指定子目录，必须以'/'开头，支持大小写字母、数字及 ! _ - . * ' ( ) / 等字符且不能包含'..'，路径长度为最大1024字符。
	挂载路径	输入OBS桶挂载到容器内的路径。挂载路径为/home、/mnt、/data、/tmp及其子目录，不能包含相对路径，最大长度为4000字符。存在多个挂载时（包括OBS、SFS Turbo、会话存储之间），禁止使用相同或存在包含关系的路径。说明：挂载路径的Linux文件系统权限继承自OBS桶存储路径的原有权限。此权限不支持通过chmod/chown等命令修改。
	读写权限	选择对挂载OBS桶的读写权限。读写：可以读取、写入和修改OBS桶中的数据，默认为读写。说明： Linux文件系统权限和读写权限两者必须同时允许，读写才能成功，如果任一项禁止，读写操作将失败。只读：只能读取OBS桶中的数据，不能写入或修改数据。