跳到内容

环境变量

LangGraph 服务器支持特定的环境变量来配置部署。

BG_JOB_ISOLATED_LOOPS

BG_JOB_ISOLATED_LOOPS 设置为 True 以便在与服务 API 事件循环隔离的独立事件循环中执行后台运行。

如果图/节点的实现包含同步代码,则应将此环境变量设置为 True。在这种情况下,同步代码会阻塞服务 API 事件循环,这可能导致 API 不可用。API 不可用的一个症状是由于健康检查失败导致的应用程序持续重启。

默认为 False

BG_JOB_TIMEOUT_SECS

可以增加后台运行的超时时间。但是,Cloud 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_* 环境变量来配置跟踪Instrumentation。

如果指定了 DD_API_KEY,应用程序进程将包装在 ddtrace-run 命令中。通常需要其他 DD_* 环境变量(例如 DD_SITEDD_ENVDD_SERVICEDD_TRACE_ENABLED)来正确配置跟踪 Instrumentation。有关更多详细信息,请参阅 DD_* 环境变量

LANGCHAIN_TRACING_SAMPLING_RATE

发送到 LangSmith 的跟踪采样率。有效值:01 之间的任何浮点数。

有关更多详细信息,请参阅 LangSmith 文档

LANGGRAPH_AUTH_TYPE

LangGraph 服务器部署的身份验证类型。有效值:langsmith, noop

对于部署到 LangGraph Cloud 的情况,此环境变量会自动设置。对于本地开发或由外部处理身份验证的部署(例如自托管),请将此环境变量设置为 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。

LANGSMITH_TRACING

仅适用于自托管数据平面、自托管控制平面和独立容器

仅在 自托管数据平面自托管控制平面独立容器 部署中可以禁用 LangSmith 跟踪。

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 服务器任务队列中每个工作进程的作业数量。默认为 10

POSTGRES_URI_CUSTOM

仅适用于自托管数据平面和自托管控制平面

自定义 Postgres 实例仅适用于 自托管数据平面自托管控制平面 部署。

指定 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 实例仅适用于 自托管数据平面自托管控制平面 部署。

指定 REDIS_URI_CUSTOM 来使用自定义 Redis 实例。REDIS_URI_CUSTOM 的值必须是有效的 Redis 连接 URI

REDIS_KEY_PREFIX

在 API 服务器版本 0.1.9+ 中可用

API 服务器版本 0.1.9 及以上支持此环境变量。

指定 Redis 键的前缀。这允许通过使用不同的键前缀,使多个 LangGraph 服务器实例共享同一个 Redis 实例。

默认为 ''

REDIS_CLUSTER

仅在自托管部署中允许

Redis 集群模式仅在自托管部署模型中可用,LangGraph Cloud SaaS 默认会为您配置一个 Redis 实例。

REDIS_CLUSTER 设置为 True 以启用 Redis 集群模式。启用后,系统将使用集群模式连接到 Redis。这在连接到 Redis 集群部署时非常有用。

默认为 False

评论