内置环境变量

了解 AI 对话中自动注入的系统内置环境变量,用于获取会话上下文信息

内置环境变量

除了用户自定义的环境变量外,系统在每次 AI 对话启动时会自动注入一组内置环境变量,用于提供当前会话的上下文信息。插件中的脚本、Skill 和工具都可以直接访问这些变量。

变量列表

变量名说明示例值
JAVIS_WORKSPACE_ID当前工作空间 IDcm5abc123def456
JAVIS_WORKSPACE_NAME当前工作空间名称我的项目
JAVIS_LOGIN_USERNAME当前登录用户名张三
JAVIS_LOGIN_USER_EMAIL当前登录用户邮箱zhangsan@example.com
JAVIS_FRONTEND_BASE_URL前端服务基础 URLhttps://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_TOKENJAVIS_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 执行环境中同时可用

详细的自定义环境变量管理请参考:环境变量管理

相关文档

内置环境变量 | Knodo 文档