跳到主要内容
LangGraph Server 支持特定的环境变量来配置部署。

BG_JOB_ISOLATED_LOOPS

BG_JOB_ISOLATED_LOOPS 设置为 True 以在与服务 API 事件循环分离的独立事件循环中执行后台运行。 如果图/节点的实现包含同步代码,则应将此环境变量设置为 True。在这种情况下,同步代码将阻塞服务 API 事件循环,这可能导致 API 不可用。API 不可用的症状是由于健康检查失败导致应用程序持续重启。 默认为 False

BG_JOB_SHUTDOWN_GRACE_PERIOD_SECS

指定服务器在队列收到关闭信号后等待后台作业完成的时间(以秒为单位)。在此期间之后,服务器将强制终止。默认为 180 秒。设置此项以确保作业在关闭期间有足够的时间干净地完成。在 langgraph-api==0.2.16 中添加。

BG_JOB_TIMEOUT_SECS

可以增加后台运行的超时时间。但是,云部署的基础设施强制 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_SITEDD_ENVDD_SERVICEDD_TRACE_ENABLED)才能正确配置跟踪检测。有关更多详细信息,请参阅 DD_* 环境变量。您可以启用 DD_TRACE_DEBUG=true 并设置 DD_LOG_LEVEL=debug 进行故障排除。
启用 DD_API_KEY(以及 ddtrace-run)可能会覆盖或干扰您可能已集成到应用程序代码中的其他自动检测解决方案(例如 OpenTelemetry)。

LANGCHAIN_TRACING_SAMPLING_RATE

发送到 LangSmith 的跟踪的采样率。有效值:介于 01 之间的任何浮点数。 有关更多详细信息,请参阅 设置跟踪的采样率

LANGGRAPH_AUTH_TYPE

LangGraph Server 部署的身份验证类型。有效值:langsmithnoop 对于 LangSmith 的部署,此环境变量会自动设置。对于本地开发或外部处理身份验证的部署(例如自托管),将此环境变量设置为 noop

LANGGRAPH_POSTGRES_POOL_MAX_SIZE

从 langgraph-api 版本 0.2.12 开始,Postgres 连接池的最大大小(每个副本)可以使用 LANGGRAPH_POSTGRES_POOL_MAX_SIZE 环境变量进行控制。通过设置此变量,您可以确定服务器将与 Postgres 数据库建立的并发连接数的上限。 例如,如果部署扩展到 10 个副本,并且 LANGGRAPH_POSTGRES_POOL_MAX_SIZE 配置为 150,那么最多可以建立 1500 个到 Postgres 的连接。这对于数据库资源有限(或更可用)或需要调整连接行为以提高性能或扩展性的部署特别有用。 默认为 150 个连接。

LANGSMITH_API_KEY

仅适用于 自托管 LangSmith 的部署。 要将跟踪发送到自托管 LangSmith 实例,请将 LANGSMITH_API_KEY 设置为从自托管实例创建的 API 密钥。

LANGSMITH_ENDPOINT

仅适用于 自托管 LangSmith 的部署。 要将跟踪发送到自托管 LangSmith 实例,请将 LANGSMITH_ENDPOINT 设置为自托管实例的主机名。

LANGSMITH_TRACING

LANGSMITH_TRACING 设置为 false 可禁用 LangSmith 的跟踪。 默认为 true

LOG_COLOR

这主要与通过 langgraph dev 命令使用开发服务器相关。将 LOG_COLOR 设置为 true 可在使用默认控制台渲染器时启用 ANSI 颜色控制台输出。将此变量设置为 false 可禁用颜色输出,从而生成单色日志。默认为 true

LOG_LEVEL

配置日志级别。默认为 INFO

LOG_JSON

LOG_JSON 设置为 true 以使用配置的 JSONRenderer 将所有日志消息渲染为 JSON 对象。这会生成结构化日志,可以轻松地由日志管理系统解析或摄取。默认为 false

MOUNT_PREFIX

仅限自托管部署 MOUNT_PREFIX 环境变量仅在自托管部署模型中允许,LangSmith SaaS 不允许此环境变量。
设置 MOUNT_PREFIX 以在特定路径前缀下提供 LangGraph Server。这对于服务器位于需要特定路径前缀的反向代理或负载均衡器后面的部署非常有用。 例如,如果服务器要在 https://example.com/langgraph 下提供,请将 MOUNT_PREFIX 设置为 /langgraph

N_JOBS_PER_WORKER

LangGraph Server 任务队列中每个工作程序的作业数。默认为 10

POSTGRES_URI_CUSTOM

仅适用于混合和自托管部署 自定义 Postgres 实例仅适用于 混合自托管 部署。
指定 POSTGRES_URI_CUSTOM 以使用自定义 Postgres 实例。POSTGRES_URI_CUSTOM 的值必须是有效的 Postgres 连接 URI Postgres:
  • 版本 15.8 或更高。
  • 必须存在初始数据库,并且连接 URI 必须引用该数据库。
控制平面功能
  • 如果指定了 POSTGRES_URI_CUSTOM,控制平面将不会为服务器预置数据库。
  • 如果移除了 POSTGRES_URI_CUSTOM,控制平面将不会为服务器预置数据库,并且不会删除外部管理的 Postgres 实例。
  • 如果移除了 POSTGRES_URI_CUSTOM,修订版的部署将不会成功。一旦指定了 POSTGRES_URI_CUSTOM,它必须始终在部署的生命周期中设置。
  • 如果部署被删除,控制平面将不会删除外部管理的 Postgres 实例。
  • POSTGRES_URI_CUSTOM 的值可以更新。例如,URI 中的密码可以更新。
数据库连接
  • LangGraph Server 必须能够访问自定义 Postgres 实例。用户负责确保连接。

REDIS_CLUSTER

此功能处于 Alpha 阶段。
仅限自托管部署 Redis 集群模式仅在自托管部署模型中可用,LangSmith SaaS 默认会为您预置一个 Redis 实例。
REDIS_CLUSTER 设置为 True 以启用 Redis 集群模式。启用后,系统将使用集群模式连接到 Redis。这在连接到 Redis 集群部署时很有用。 默认为 False

REDIS_KEY_PREFIX

在 API 服务器版本 0.1.9+ 中可用 此环境变量在 API 服务器版本 0.1.9 及更高版本中受支持。
为 Redis 键指定前缀。这允许通过使用不同的键前缀,使多个 LangGraph Server 实例共享同一个 Redis 实例。 默认为 ''

REDIS_URI_CUSTOM

仅适用于混合和自托管部署 自定义 Redis 实例仅适用于 混合自托管 部署。
指定 REDIS_URI_CUSTOM 以使用自定义 Redis 实例。REDIS_URI_CUSTOM 的值必须是有效的 Redis 连接 URI

REDIS_MAX_CONNECTIONS

Redis 连接池的最大大小(每个副本)可以使用 REDIS_MAX_CONNECTIONS 环境变量进行控制。通过设置此变量,您可以确定服务器将与 Redis 实例建立的并发连接数的上限。 例如,如果部署扩展到 10 个副本,并且 REDIS_MAX_CONNECTIONS 配置为 150,那么最多可以建立 1500 个到 Redis 的连接。 默认为 2000

RESUMABLE_STREAM_TTL_SECONDS

Redis 中可恢复流数据的生存时间(以秒为单位)。 当创建运行并流式传输输出时,可以将流配置为可恢复(例如 stream_resumable=True)。如果流是可恢复的,则流的输出会临时存储在 Redis 中。可以通过设置 RESUMABLE_STREAM_TTL_SECONDS 来配置此数据的 TTL。 有关如何实现可恢复流的更多详细信息,请参阅 PythonJS/TS SDK。 默认为 120 秒。
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.