langgraph dev) 和本地 Docker 服务器 (langgraph up))如何处理数据。它还描述了与托管 Studio 前端交互时会跟踪哪些数据。
CLI
LangGraph CLI 是用于构建和运行 LangGraph 应用程序的命令行界面;请参阅CLI 指南以了解更多信息。 默认情况下,大多数 CLI 命令在调用时都会记录一个分析事件。这有助于我们更好地优先改进 CLI 体验。每个遥测事件都包含调用进程的操作系统、操作系统版本、Python 版本、CLI 版本、命令名称(dev、up、run 等)以及表示是否向命令传递了标志的布尔值。您可以在此处查看完整的分析逻辑。 您可以通过设置LANGGRAPH_CLI_NO_ANALYTICS=1来禁用所有 CLI 遥测。 LangGraph 服务器
LangGraph 服务器提供了一个持久的执行运行时,它依赖于将应用程序状态、长期记忆、线程元数据、助手和类似资源的检查点持久化到本地文件系统或数据库。除非您有意自定义存储位置,否则此信息会写入本地磁盘(用于langgraph dev)或 PostgreSQL 数据库(用于 langgraph up 和所有部署)。
LangSmith Tracing
当运行 LangGraph 服务器(内存或 Docker)时,可以启用 LangSmith 追踪,以促进更快的调试并提供生产环境中图状态和 LLM 提示的可观测性。您可以通过在服务器的运行时环境中设置LANGSMITH_TRACING=false 来始终禁用追踪。 内存开发服务器
langgraph dev 作为一个单独的 Python 进程运行内存开发服务器,专为快速开发和测试而设计。它将所有检查点和内存数据保存到当前工作目录下的 .langgraph_api 目录中。除了CLI 部分中描述的遥测数据之外,除非您启用了追踪或者您的图代码明确联系了外部服务,否则不会有数据离开机器。 独立服务器
langgraph up 将您的本地软件包构建成 Docker 镜像,并以数据平面的形式运行服务器,该数据平面由三个容器组成:API 服务器、PostgreSQL 容器和 Redis 容器。所有持久化数据(检查点、助手等)都存储在 PostgreSQL 数据库中。Redis 用作事件实时流的发布/订阅连接。您可以通过设置有效的 LANGGRAPH_AES_KEY 环境变量,在保存到数据库之前加密所有检查点。您还可以在 langgraph.json 中指定检查点和跨线程记忆的 TTL,以控制数据存储的时长。所有持久化的线程、记忆和其他数据都可以通过相关的 API 端点删除。 还会进行额外的 API 调用,以确认服务器具有有效的许可证并跟踪已执行的运行和任务数量。API 服务器会定期验证提供的许可证密钥(或 API 密钥)。 如果您已禁用追踪,则除非您的图代码明确联系了外部服务,否则不会在外部持久化用户数据。Studio
Studio 是一个用于与您的 LangGraph 服务器交互的图形界面。它不持久化任何私有数据(您发送到服务器的数据不会发送到 LangSmith)。尽管 Studio 界面在 smith.langchain.com 上提供服务,但它在您的浏览器中运行并直接连接到您的本地 LangGraph 服务器,因此无需将数据发送到 LangSmith。 如果您已登录,LangSmith 会收集一些使用情况分析数据,以帮助改进调试用户体验。这包括:- 页面访问和导航模式
- 用户操作(按钮点击)
- 浏览器类型和版本
- 屏幕分辨率和视口大小
快速参考
总而言之,您可以通过关闭 CLI 分析和禁用追踪来选择退出服务器端遥测。| 变量 | 目的 | 默认 |
|---|---|---|
LANGGRAPH_CLI_NO_ANALYTICS=1 | 禁用 CLI 分析 | 已启用分析 |
LANGSMITH_API_KEY | 启用 LangSmith 追踪 | 追踪已禁用 |
LANGSMITH_TRACING=false | 禁用 LangSmith 追踪 | 取决于环境 |
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。