AgentKit Studio
参考

环境变量参考

Studio 读取的 132 个环境变量名,按「可配置 / 平台注入 / 禁止修改」三档与命名空间分组。

三档口径

Studio 从进程环境读取 132 个变量名:其中 8 个是直接 process.env.X 读取,其余经注入的 env 参数或 *_ENV_NAMES 常量数组转发。

档位标识条数含义
可配置configurable36运维或开发者可以显式设置,未设置时走代码默认值。
平台注入platform84由容器、托管运行时或桌面外壳注入,手工设置通常会被覆盖或不生效。
禁止修改forbidden12Studio 会读取,但值必须由凭证服务或设置界面持有;不要写进 shell profile、.env 或 CI 变量。

凭证只从设置界面写入

标为「禁止修改」的变量由凭证服务或设置界面持有。把它们写进 shell profile、.env 或 CI 变量会绕过 Studio 的凭证边界,并在日志中出现。

命名空间分布

命名空间条数说明
AGENTKIT55Studio 自身的配置项。
KSADK30Skill、沙箱、记忆库与知识库的运行参数。
AGENTENGINE11AgentEngine 控制面注入的运行时身份与端点。
OTEL10OpenTelemetry 标准导出变量。
OTHER10未归入命名空间的独立变量。
DSH5DSH 宿主(home、agents home、可观测性)。
E2B4E2B 沙箱后端。
KSYUN3金山云签名凭证。
CODEX1Codex App Server 的 home 与可执行文件。
GITHUB1GitHub 访问令牌。
KS31KS3 对象存储桶与端点。
OPENAI1OpenAI 兼容端点与密钥。

全量清单

按命名空间分组,每条给出第一次读取的源码位置。同名变量在多处读取时只列第一处。

环境变量档位首次读取
AGENTKIT_STUDIO_HOST_URL可配置src/authoring-tools.mjs
AGENTKIT_STUDIO_HOST_SESSION_TOKEN禁止修改src/authoring-tools.mjs
AGENTKIT_HOME可配置src/authoring-tools.mjs
AGENTKIT_STUDIO_NATIVE_HARNESS平台注入src/build-engine.mjs
AGENTKIT_RUNTIME_TOKEN禁止修改src/bundle-host.mjs
AGENTKIT_BUNDLE_SOURCE平台注入src/bundle-source.mjs
AGENTKIT_BUNDLE_SHA256平台注入src/bundle-source.mjs
AGENTKIT_STUDIO_DSH_PLUGIN_INDEX可配置src/dsh-plugin-catalog.mjs
AGENTKIT_STUDIO_GITHUB_TOKEN禁止修改src/dsh-plugin-discovery.mjs
AGENTKIT_STUDIO_DISCOVERY_CACHE可配置src/dsh-plugin-discovery.mjs
AGENTKIT_RUNTIME_TIMEOUT_MS平台注入src/frozen-build-runtime.mjs
AGENTKIT_RUNTIME_AGENT_ID平台注入src/frozen-build-runtime.mjs
AGENTKIT_RUNTIME_BUILD_ID平台注入src/frozen-build-runtime.mjs
AGENTKIT_EXECUTION_POLICY_DEFAULT可配置src/frozen-build-runtime.mjs
AGENTKIT_EXECUTION_POLICY_MAX可配置src/frozen-build-runtime.mjs
AGENTKIT_MANAGED_SESSIONS可配置src/frozen-build-runtime.mjs
AGENTKIT_DEPLOYMENT_VERSION平台注入src/frozen-build-runtime.mjs
AGENTKIT_RUNTIME_HOST平台注入src/frozen-build-runtime.mjs
AGENTKIT_RUNTIME_PORT平台注入src/frozen-build-runtime.mjs
AGENTKIT_STRICT_RESOURCES可配置src/host/bootstrap.mjs
AGENTKIT_STUDIO_BUNDLE_DIR平台注入src/host/bootstrap.mjs
AGENTKIT_STUDIO_WORKSPACE平台注入src/host/bootstrap.mjs
AGENTKIT_STUDIO_NATIVE_CHROMIUM_EXECUTABLE平台注入src/host/bootstrap.mjs
AGENTKIT_MCP_INVOCATION_IDENTITY可配置src/host/services/resources.mjs
AGENTKIT_ENGINE_SERVICE_TOKEN禁止修改src/host/services/star-harness-worker.mjs
AGENTKIT_KS3_ENDPOINT_MODE可配置src/ks3-endpoints.mjs
AGENTKIT_MCP_BUSINESS_IDENTITY可配置src/managed-runtime-actions.mjs
AGENTKIT_MODEL_API_KEY禁止修改src/managed-runtime-definition.mjs
AGENTKIT_MANAGED_CODEX_API可配置src/managed-runtime-definition.mjs
AGENTKIT_ENGINE_SERVICE_URL平台注入src/managed-runtime-definition.mjs
AGENTKIT_ENGINE_SERVICE_CA_FILE平台注入src/managed-runtime-definition.mjs
AGENTKIT_ENGINE_SERVICE_WORKSPACE平台注入src/managed-runtime-definition.mjs
AGENTKIT_USER_HOME平台注入src/managed-runtime-host.mjs
AGENTKIT_WORKSPACE_ROOT可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_MODEL可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_SANDBOX可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_APPROVAL_POLICY可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_REASONING_SUMMARY可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_TIMEOUT_MS可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_IDLE_TIMEOUT_MS可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_STREAM_IDLE_TIMEOUT_MS可配置src/managed-runtime-host.mjs
AGENTKIT_CODEX_MODEL_IDLE_TIMEOUT_MS可配置src/managed-runtime-host.mjs
AGENTKIT_PROMPT_PREDICTION_ENABLED可配置src/prompt-prediction/host.mjs
AGENTKIT_PROMPT_PREDICTION_AUDIT可配置src/prompt-prediction/host.mjs
AGENTKIT_CODEX_BIN可配置src/providers/codex-command.mjs
AGENTKIT_ENGINE_SERVICE_WORKSPACES平台注入src/providers/engine-service-workspaces.mjs
AGENTKIT_ENGINE_SERVICE_MODEL平台注入src/providers/engine-service-workspaces.mjs
AGENTKIT_STUDIO_NATIVE_APPLICATION_PREVIEW_ORIGIN平台注入src/providers/engine-service-workspaces.mjs
AGENTKIT_STUDIO_NATIVE_APPLICATION_PREVIEW_ENTRY平台注入src/providers/engine-service-workspaces.mjs
AGENTKIT_STUDIO_DEPLOYMENT_TYPE平台注入src/studio-deployments.mjs
AGENTKIT_STUDIO_DESKTOP_VERSION平台注入src/studio-version.mjs
AGENTKIT_STUDIO_DSH_VERSION平台注入src/studio-version.mjs
AGENTKIT_TEMPLATE_SERVER_URL可配置src/template-catalog-source.mjs
AGENTKIT_TEMPLATE_CATALOG_FILE可配置src/template-catalog-source.mjs
AGENTKIT_TEMPLATE_ENVIRONMENT可配置src/template-catalog-source.mjs
KSADK_TRAFFIC_SOURCE平台注入src/aicp-resource-connection.mjs
KSADK_LOCAL_SKILLS_DIR平台注入src/host/bootstrap.mjs
KSADK_MODEL_COMPAT_RULE平台注入src/host/services/star-harness-release.mjs
KSADK_KB_DATASET_ID平台注入src/knowledge-tools.mjs
KSADK_KB_TOP_K平台注入src/knowledge-tools.mjs
KSADK_KB_SEARCH_METHOD平台注入src/knowledge-tools.mjs
KSADK_KB_SCORE_THRESHOLD平台注入src/knowledge-tools.mjs
KSADK_KB_RERANKING_ENABLE平台注入src/knowledge-tools.mjs
KSADK_LTM_BACKEND平台注入src/legacy-memory-tools.mjs
KSADK_LTM_INDEX平台注入src/legacy-memory-tools.mjs
KSADK_LTM_APP_NAME平台注入src/legacy-memory-tools.mjs
KSADK_LTM_NAMESPACE平台注入src/legacy-memory-tools.mjs
KSADK_LTM_TOP_K平台注入src/legacy-memory-tools.mjs
KSADK_LTM_SCENE_ID平台注入src/legacy-memory-tools.mjs
KSADK_LTM_FORCE_INMEMORY平台注入src/legacy-memory-tools.mjs
KSADK_LTM_HTTP_TOKEN禁止修改src/legacy-memory-tools.mjs
KSADK_MEMORY_DB_PATH平台注入src/legacy-memory-tools.mjs
KSADK_LTM_HTTP_URL平台注入src/legacy-memory-tools.mjs
KSADK_SANDBOX_BACKEND平台注入src/providers/native-e2b-host.mjs
KSADK_SANDBOX_TEMPLATE_ID平台注入src/providers/native-e2b-host.mjs
KSADK_SKILL_RUNTIME_TEMPLATE_ID平台注入src/providers/native-e2b-host.mjs
KSADK_SANDBOX_TIMEOUT平台注入src/providers/native-e2b-host.mjs
KSADK_SKILL_RUNTIME_TIMEOUT平台注入src/providers/native-e2b-host.mjs
KSADK_SANDBOX_ALLOW_INTERNET_ACCESS平台注入src/providers/native-e2b-host.mjs
KSADK_SKILL_RUNTIME_ALLOW_INTERNET_ACCESS平台注入src/providers/native-e2b-host.mjs
KSADK_SANDBOX_TYPE平台注入src/providers/native-e2b-host.mjs
KSADK_SKILL_SPACE_IDS平台注入src/providers/native-skill-host.mjs
KSADK_SKILL_RUNTIME_BACKEND平台注入src/providers/native-skill-runtime.mjs
KSADK_SKILL_PROJECT_NAME平台注入src/providers/native-skill-runtime.mjs
KSADK_SKILL_ARTIFACT_PROJECT平台注入src/providers/native-skill-runtime.mjs
AGENTENGINE_INNER_KOP_URL平台注入src/host/bootstrap.mjs
AGENTENGINE_INNER_IAM_URL平台注入src/host/bootstrap.mjs
AGENTENGINE_MANIFEST_PATH平台注入src/host/bootstrap.mjs
AGENTENGINE_NETWORK_MODE平台注入src/ks3-endpoints.mjs
AGENTENGINE_RESOURCE_SERVER_URL平台注入src/managed-resource-client.mjs
AGENTENGINE_AGENT_ID平台注入src/managed-runtime-definition.mjs
AGENTENGINE_AGENT_VERSION_ID平台注入src/managed-runtime-definition.mjs
AGENTENGINE_MANAGED_RUNTIME_NAME平台注入src/managed-runtime-manifest.mjs
AGENTENGINE_MANAGED_RUNTIME_VERSION平台注入src/managed-runtime-manifest.mjs
AGENTENGINE_MANIFEST_PROTOCOL平台注入src/managed-runtime-manifest.mjs
AGENTENGINE_MANIFEST_SHA256平台注入src/managed-runtime-manifest.mjs
OTEL_EXPORTER_OTLP_PROTOCOL平台注入src/managed-runtime-host.mjs
OTEL_EXPORTER_OTLP_HEADERS平台注入src/managed-runtime-host.mjs
OTEL_EXPORTER_OTLP_ENDPOINT平台注入src/managed-runtime-host.mjs
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT平台注入src/managed-runtime-host.mjs
OTEL_EXPORTER_OTLP_TRACES_HEADERS平台注入src/managed-runtime-host.mjs
OTEL_EXPORTER_OTLP_TRACES_PROTOCOL平台注入src/managed-runtime-host.mjs
OTEL_EXPORTER_OTLP_TRACES_CERTIFICATE平台注入src/managed-runtime-host.mjs
OTEL_EXPORTER_OTLP_CERTIFICATE平台注入src/managed-runtime-host.mjs
OTEL_SERVICE_NAME平台注入src/managed-runtime-host.mjs
OTEL_RESOURCE_ATTRIBUTES平台注入src/managed-runtime-host.mjs
PATH可配置src/host/services/star-harness-release.mjs
STUDIO_DOWNLOAD_PROD_KS3_BUCKET平台注入src/ks3-release-store.mjs
DOWNLOAD_PROD_KS3_BUCKET平台注入src/ks3-release-store.mjs
CLOUD_MONITOR_OTLP_ENDPOINT平台注入src/managed-runtime-host.mjs
CLOUD_MONITOR_OTLP_TRACES_ENDPOINT平台注入src/managed-runtime-host.mjs
CLOUD_MONITOR_OTLP_HEADERS平台注入src/managed-runtime-host.mjs
CLOUD_MONITOR_OTLP_PROTOCOL平台注入src/managed-runtime-host.mjs
CLOUD_MONITOR_OTLP_TRACES_PROTOCOL平台注入src/managed-runtime-host.mjs
CLOUD_MONITOR_OTLP_TRACES_HEADERS平台注入src/managed-runtime-host.mjs
CLOUD_MONITOR_APP_KEY禁止修改src/managed-runtime-host.mjs
DSH_PLUGIN_INDEX_URL可配置src/dsh-plugin-catalog.mjs
DSH_OTEL_CA_PEM_BASE64平台注入src/managed-runtime-host.mjs
DSH_OBSERVABILITY_CAPTURE_CONTENT平台注入src/managed-runtime-host.mjs
DSH_HOME可配置src/providers/native-dsh-tools.mjs
DSH_AGENTS_HOME可配置src/providers/native-dsh-tools.mjs
E2B_API_URL可配置src/providers/native-e2b-host.mjs
E2B_DOMAIN可配置src/providers/native-e2b-host.mjs
E2B_API_KEY禁止修改src/providers/native-e2b-host.mjs
E2B_SANDBOX_URL可配置src/providers/native-e2b-sdk-transport.mjs
KSYUN_ACCESS_KEY禁止修改src/bundle-source.mjs
KSYUN_SECRET_KEY禁止修改src/bundle-source.mjs
KSYUN_SESSION_TOKEN禁止修改src/bundle-source.mjs
CODEX_HOME可配置src/model-credential-sync.mjs
GITHUB_TOKEN禁止修改src/dsh-plugin-discovery.mjs
KS3_BUCKET平台注入src/ks3-release-store.mjs
OPENAI_BASE_URL可配置src/managed-runtime-definition.mjs

常见配置

变量默认值作用
AGENTKIT_HOME~/.agentkitStudio 数据目录:授权、缓存、云 Skill
DSH_HOME~/.dshDSH 宿主目录;开发时建议指到临时目录
DSH_AGENTS_HOME~/.agents原生工具解析 Agent 目录的根
AGENTKIT_STUDIO_DSH_PLUGIN_INDEX空远程插件索引的 HTTPS 地址;空表示只用内置目录
AGENTKIT_EXECUTION_POLICY_DEFAULTworkspace-write新建 Agent 的默认执行策略
AGENTKIT_EXECUTION_POLICY_MAXworkspace-write允许 Agent 申请的最高执行策略
AGENTKIT_STRICT_RESOURCES空设为真值时资源缺失直接失败,而不是降级
AGENTKIT_PROMPT_PREDICTION_ENABLED空开启下一句提示
CODEX_HOME~/.codexCodex App Server 的 home
OPENAI_BASE_URL空OpenAI 兼容端点,容器部署时由平台注入

完整默认值以源码为准;本表的「默认值」列只写代码里能读到的回退值。

版本与兼容性

项值说明
环境变量名132改名即破坏性变更
直读8process.env.X 字面量
Host 转发30*_ENV_NAMES 常量数组声明
平台注入84手工设置会被覆盖

开发者入口

内容源码位置
全局配置解析src/global-config.mjs
可观测性src/observability-otel.mjs
Host 转发白名单src/managed-runtime-host.mjs
容器部署环境src/container-deployment-env.mjs
插件索引地址src/dsh-plugin-index.mjs

相关测试:

测试文件位置
container-deployment-env.test.mjstests/container-deployment-env.test.mjs
global-config.test.mjstests/global-config.test.mjs
portable-bundle.test.mjstests/portable-bundle.test.mjs
observability-otel.test.mjstests/observability-otel.test.mjs

本页导航