环境变量¶
LangGraph 云服务器支持使用特定的环境变量来配置部署。
BG_JOB_ISOLATED_LOOPS¶
将 BG_JOB_ISOLATED_LOOPS 设置为 True，以便在与服务 API 事件循环分离的独立事件循环中执行后台运行任务。
如果图/节点的实现包含同步代码，则应将此环境变量设置为 True。在这种情况下，同步代码会阻塞服务 API 事件循环，这可能会导致 API 不可用。API 不可用的一个表现是由于健康检查失败而导致应用程序持续重启。
默认值为 False。
BG_JOB_TIMEOUT_SECS¶
可以增加后台运行的超时时间。不过，云 SaaS 部署的基础设施对 API 请求强制实施 1 小时的超时限制。这意味着客户端和服务器之间的连接将在 1 小时后超时。此设置不可配置。
后台运行的执行时间可以超过 1 小时，但如果运行时间超过 1 小时，客户端必须重新连接到服务器（例如，通过 POST /threads/{thread_id}/runs/{run_id}/stream 加入流）以获取运行的输出。
默认值为 3600。
DD_API_KEY¶
指定 DD_API_KEY（即您的 Datadog API 密钥），以自动为部署启用 Datadog 跟踪功能。指定其他 DD_* 环境变量 来配置跟踪检测。
如果指定了 DD_API_KEY，应用程序进程将被包装在 ddtrace-run 命令 中。通常需要其他 DD_* 环境变量（例如 DD_SITE、DD_ENV、DD_SERVICE、DD_TRACE_ENABLED）来正确配置跟踪检测。有关更多详细信息，请参阅DD_* 环境变量。
LANGCHAIN_TRACING_SAMPLING_RATE¶
发送到 LangSmith 的跟踪数据的采样率。有效值：0 到 1 之间的任意浮点数。
有关更多详细信息，请参阅 LangSmith 文档。
LANGGRAPH_AUTH_TYPE¶
LangGraph 云服务器部署的身份验证类型。有效值：langsmith、noop。
对于部署到 LangGraph 云的情况，此环境变量会自动设置。对于本地开发或身份验证由外部处理的部署（例如自托管），请将此环境变量设置为 noop。
LANGSMITH_RUNS_ENDPOINTS¶
仅适用于使用自托管 LangSmith 的自带云 (BYOC) 部署。
设置此环境变量，可让 BYOC 部署将跟踪信息发送到自托管的 LangSmith 实例。LANGSMITH_RUNS_ENDPOINTS 的值是一个 JSON 字符串：{"<SELF_HOSTED_LANGSMITH_HOSTNAME>":"<LANGSMITH_API_KEY>"}。
SELF_HOSTED_LANGSMITH_HOSTNAME 是自托管 LangSmith 实例的主机名。BYOC 部署必须能够访问该主机名。LANGSMITH_API_KEY 是从自托管 LangSmith 实例生成的 LangSmith API 密钥。
LOG_LEVEL¶
配置日志级别。默认为 INFO。
N_JOBS_PER_WORKER¶
LangGraph 云任务队列中每个工作进程的作业数量。默认为 10。
POSTGRES_URI_CUSTOM¶
仅适用于自带云（BYOC）部署。
指定 POSTGRES_URI_CUSTOM 以使用外部管理的 Postgres 实例。POSTGRES_URI_CUSTOM 的值必须是有效的 Postgres 连接 URI。
Postgres： - 版本为 15.8 或更高。 - 必须存在一个初始数据库，并且连接 URI 必须引用该数据库。
控制平面功能：
- 如果指定了 POSTGRES_URI_CUSTOM，LangGraph 控制平面将不会为服务器配置数据库。
- 如果移除了 POSTGRES_URI_CUSTOM，LangGraph 控制平面将不会为服务器配置数据库，也不会删除外部管理的 Postgres 实例。
- 如果移除了 POSTGRES_URI_CUSTOM，修订版本的部署将不会成功。一旦指定了 POSTGRES_URI_CUSTOM，在部署的生命周期内必须始终设置该值。
- 如果删除了部署，LangGraph 控制平面将不会删除外部管理的 Postgres 实例。
- 可以更新 POSTGRES_URI_CUSTOM 的值。例如，可以更新 URI 中的密码。
数据库连接性：
- ECS 集群中的 LangGraph 服务器服务必须能够访问外部管理的 Postgres 实例。BYOC 用户负责确保连接性。
- 例如，如果配置了一个 AWS RDS Postgres 实例，可以将其与 ECS 集群配置在同一个 VPC（langgraph-cloud-vpc）中，并使用 langgraph-cloud-service-sg 安全组来确保连接性。
REDIS_URI_CUSTOM¶
仅适用于自带云（BYOC）部署。
指定 REDIS_URI_CUSTOM 以使用外部管理的 Redis 实例。REDIS_URI_CUSTOM 的值必须是有效的 Redis 连接 URI。