内置环境变量
了解 AI 对话中自动注入的系统内置环境变量,用于获取会话上下文信息
内置环境变量
除了用户自定义的环境变量外,系统在每次 AI 对话启动时会自动注入一组内置环境变量,用于提供当前会话的上下文信息。插件中的脚本、Skill 和工具都可以直接访问这些变量。
变量列表
| 变量名 | 说明 | 示例值 |
|---|---|---|
JAVIS_WORKSPACE_ID | 当前工作空间 ID | cm5abc123def456 |
JAVIS_WORKSPACE_NAME | 当前工作空间名称 | 我的项目 |
JAVIS_LOGIN_USERNAME | 当前登录用户名 | 张三 |
JAVIS_LOGIN_USER_EMAIL | 当前登录用户邮箱 | zhangsan@example.com |
JAVIS_FRONTEND_BASE_URL | 前端服务基础 URL | https://javis.example.com |
JAVIS_AUTH_TOKEN | 认证令牌(用于调用后端 API) | jvs_xxx... |
JAVIS_PLUGIN_BASE_ROOT | 插件根目录(仅沙箱模式) | /plugins |
JAVIS_IM_SOURCE | 消息来源 | 钉钉机器人:dingtalk、飞书机器人:feishu、企微机器人:wecom、web 页面(含 IM 工作台):无 |
注意:内置环境变量使用
JAVIS_前缀,该前缀为系统保留,用户自定义变量不允许使用此前缀。
使用示例
Bash 脚本
#!/bin/bash
echo "当前工作空间: $JAVIS_WORKSPACE_NAME"
echo "当前用户: $JAVIS_LOGIN_USERNAME"Python
import os
workspace_name = os.environ.get('JAVIS_WORKSPACE_NAME', '')
user_email = os.environ.get('JAVIS_LOGIN_USER_EMAIL', '')
print(f"工作空间: {workspace_name}, 用户邮箱: {user_email}")调用后端 API
使用 JAVIS_AUTH_TOKEN 和 JAVIS_FRONTEND_BASE_URL 可以调用后端 API:
curl -X GET "${JAVIS_FRONTEND_BASE_URL}/api/v1/workspaces/${JAVIS_WORKSPACE_ID}" \
-H "Authorization: Bearer ${JAVIS_AUTH_TOKEN}"安全提示:
JAVIS_AUTH_TOKEN包含用户认证信息,请勿在日志中输出或分享给第三方。
与自定义环境变量的关系
- 内置环境变量由系统自动注入,无需手动配置
- 用户自定义环境变量不允许使用
JAVIS_等系统保留前缀,因此不会与内置变量冲突 - 两者在 Skill 执行环境中同时可用
详细的自定义环境变量管理请参考:环境变量管理