> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 环境变量

为进一步增强平台的灵活性与可维护性，Xpert AI 多智能体平台正式上线 **Env 环境管理功能**。通过该功能，用户可在工作空间中定义多个运行环境，并在其中配置环境变量，应用于智能体、工作流及工具集的各项配置，支持敏感信息剥离、配置复用及环境隔离等关键能力。

***

## 🧩 功能亮点

### ✅ 多环境定义与切换

每个智能体工作空间支持创建多个命名环境（如 `dev`、`test`、`prod`），便于针对不同业务阶段或运行需求进行独立配置管理。

### ✅ 环境变量统一管理

每个环境可定义多个键值对变量，支持在平台中通过统一语法 `{{env.变量名}}` 被引用，应用于智能体模型参数、工具配置、API调用等场景。

### ✅ 全局注入机制

环境变量可在以下对象中被动态解析并注入：

* 智能体配置（如提示词）
* 工作流节点参数 （如 Http params）
* 工具集连接配置（如 API Key）

### ✅ 数字专家发布时绑定环境

在数字专家发布时，**可绑定一个指定环境**，该环境将在终端用户与数字专家对话时自动生效。这使得数字专家可以在不同阶段使用不同提示词、调用API 或工具资源，确保响应行为的一致性和可控性。

### ✅ 运行时环境选择

在运行或测试智能体、工作流任务时，可手动指定使用某个环境，平台会自动加载对应变量集，提升测试效率与场景灵活性。

***

## 🛠 使用方式

### 1. 创建环境

进入工作空间 → 点击“Env”页签 → 创建环境 → 定义变量集：

例如：

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/envs.png?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=06c2b2559a9c4d31aa318cd90ad66ff2" alt="环境管理" width="2320" height="772" data-path="public/img/ai/xpert/envs.png" />

### 2. 引用变量

在智能体、工作流或工具配置中使用 `{{env.变量名}}` 形式进行引用，例如：

<img src="https://mintcdn.com/xpertai/ZGpPZkKu2RpKGlB0/public/img/ai/xpert/use-env-in-agent.png?fit=max&auto=format&n=ZGpPZkKu2RpKGlB0&q=85&s=474991ea9038c38aa8b9487692cd28a8" alt="提示词引用环境变量" width="1708" height="1474" data-path="public/img/ai/xpert/use-env-in-agent.png" />

### 3. 绑定数字专家默认环境

在“数字专家”发布界面，选择要绑定的默认环境。绑定后，所有来自终端用户的对话请求将使用该环境变量运行，确保响应的一致性和安全性。

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/publish-with-env.png?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=c4478b8ad6b62bfa1f87a11832d52132" alt="发布绑定环境" width="1096" height="1160" data-path="public/img/ai/xpert/publish-with-env.png" />

### 4. 手动切换环境测试

在开发或调试过程中，可灵活选择环境运行，模拟不同环境下的行为差异。

<img src="https://mintcdn.com/xpertai/KjFE_c3zPYs4Z9GJ/public/img/ai/xpert/env-variables.png?fit=max&auto=format&n=KjFE_c3zPYs4Z9GJ&q=85&s=ad36a6951ef052076ec44be9dcda7d5d" alt="管理环境变量" width="1710" height="1126" data-path="public/img/ai/xpert/env-variables.png" />

***

**Env 功能的发布**标志着 XpertAI 平台在智能体系统的配置管理、安全控制及企业级多场景部署能力上迈出了关键一步。欢迎立即体验，用更专业的方式构建你专属的 AI 系统！
