环境变量¶
LangGraph Cloud Server 支持特定的环境变量来配置部署。
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 Cloud Server 部署的身份验证类型。有效值：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。
N_JOBS_PER_WORKER¶
LangGraph Cloud 任务队列中每个 worker 的作业数。默认为 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 中的密码。
数据库连接性
- 外部管理的 Postgres 实例必须可由 ECS 集群中的 LangGraph Server 服务访问。BYOC 用户负责确保连接性。
- 例如，如果配置了 AWS RDS Postgres 实例，则可以将其配置在与 ECS 集群相同的 VPC (
langgraph-cloud-vpc) 中，并使用langgraph-cloud-service-sg安全组来确保连接性。