环境变量¶
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 Key)可自动为部署启用 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 Cloud,此环境变量会自动设置。对于本地开发或身份验证在外部处理的部署(例如自托管),将此环境变量设置为 noop
。
LANGSMITH_RUNS_ENDPOINTS
¶
仅适用于带有自有云 (BYOC) 部署和自托管 LangSmith 的情况。
设置此环境变量可使 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。
LANGSMITH_TRACING
¶
将 LANGSMITH_TRACING
设置为 false
可禁用向 LangSmith 的跟踪。
LOG_LEVEL
¶
配置日志级别。默认为 INFO
。
LOG_JSON
¶
将 LOG_JSON
设置为 true
可使用配置的 JSONRenderer
将所有日志消息渲染为 JSON 对象。这会生成结构化日志,日志管理系统可以轻松解析或摄取这些日志。默认为 false
。
LOG_COLOR
¶
这主要与通过 langgraph dev
命令使用开发服务器相关。将 LOG_COLOR
设置为 true
可在使用默认控制台渲染器时启用 ANSI 彩色控制台输出。通过将此变量设置为 false
来禁用颜色输出会产生单色日志。默认为 true
。
N_JOBS_PER_WORKER
¶
LangGraph 服务器任务队列中每个 worker 的作业数。默认为 10
。
POSTGRES_URI_CUSTOM
¶
指定 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 中的密码。
数据库连接
- 自定义 Postgres 实例必须可由 LangGraph 服务器访问。用户负责确保连接。
REDIS_URI_CUSTOM
¶
指定 REDIS_URI_CUSTOM
以使用自定义 Redis 实例。REDIS_URI_CUSTOM
的值必须是有效的Redis 连接 URI。
REDIS_KEY_PREFIX
¶
API Server 0.1.9+ 版本可用
此环境变量在 API Server 0.1.9 及以上版本中受支持。
指定 Redis 键的前缀。这允许通过使用不同的键前缀,多个 LangGraph Server 实例共享同一个 Redis 实例。
默认为 ''
。
REDIS_CLUSTER
¶
仅在自托管部署中允许
Redis Cluster 模式仅在自托管部署模型中可用,LangGraph Cloud SaaS 默认会为您配置一个 Redis 实例。
将 REDIS_CLUSTER
设置为 True
以启用 Redis Cluster 模式。启用后,系统将使用集群模式连接到 Redis。这在连接到 Redis Cluster 部署时很有用。
默认为 False
。