> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Server 更新日志

<Callout icon="rss" color="#4F46E5" iconType="regular">
  **订阅**：我们的更新日志包含一个 [RSS 订阅源](https://docs.langchain.com/langsmith/agent-server-changelog/rss.xml)，可与 [Slack](https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack)、[电子邮件](https://zapier.com/apps/email/integrations/rss/1441/send-new-rss-feed-entries-via-email)、Discord 机器人如 [Readybot](https://readybot.io/) 或 [RSS Feeds to Discord Bot](https://rss.app/en/bots/rssfeeds-discord-bot) 以及其他订阅工具集成。
</Callout>

[Agent Server](/langsmith/agent-server) 是一个用于创建和管理基于代理的应用程序的 API 平台。它提供内置持久化、任务队列，并支持大规模部署、配置和运行助手（代理工作流）。本更新日志记录了 Agent Server 版本的所有重要更新、功能和修复。

<Update label="2026-04-30" tags={["agent-server"]}>
  ## v0.8.5

  * 修复了 Datadog 和 npm 报告的 langgraph JavaScript 依赖中的安全漏洞。
</Update>

<Update label="2026-04-29" tags={["agent-server"]}>
  ## v0.8.4

  * 在访问日志中包含 trace/span ID，以改善 Datadog 和 OTel 中的跟踪关联。
</Update>

<Update label="2026-04-28" tags={["agent-server"]}>
  ## v0.8.3

  * 新增对基于 IAM 的身份验证支持，可在集群模式下与 Google Cloud Memorystore 配合使用，以实现安全访问。
</Update>

<Update label="2026-04-27" tags={["agent-server"]}>
  ## v0.8.2

  * 修复了 `langgraph-api` 队列入口点在仅 IPv6 集群上无法正确启动的问题，确保健康/指标服务器正确绑定 IPv6 字面量。
</Update>

<Update label="2026-04-23" tags={["agent-server"]}>
  ## v0.8.1

  * 通过在线程状态和运行端点中跳过大型 `values` 列（当不需要完整线程主体时），提升了性能。
  * 限制了检查点摄取批处理大小和延迟窗口，以最小化长时间运行的事务和行锁争用，并新增了用于批处理大小和延迟控制的配置标志。
</Update>

<Update label="2026-04-16" tags={["agent-server"]}>
  ## v0.8.0

  * 将默认队列系统切换为 Redis，确保改进排序和效率。
  * 通过默认启用 SSRF 保护、阻止高风险 IP 范围以及通过 DNS 固定和逐跳检查改进验证，增强了网络钩子安全性。
  * 将 hono 从版本 4.12.12 更新至 4.12.14，以解决安全性和类型处理改进问题。
</Update>

<Update label="2026-04-15" tags={["agent-server"]}>
  ## v0.7.103

  * 解决了 checkpoint\_delete\_queue 的迁移版本冲突，确保正确执行，并为未来的迁移添加了重复版本检测。
</Update>

<Update label="2026-04-14" tags={["agent-server"]}>
  ## v0.7.102

  * 通过合并多个中断块并确保一致的中断返回行为，改进了并行中断的处理。
  * 更新了 Vite 依赖以修补安全漏洞 CVE-2026-39363 和 CVE-2026-39364。
  * 由于 `1.9.10` 清单缺少 `arm64` 支持，将 Datadog 镜像版本固定为 `1.9.9`。
</Update>

<Update label="2026-04-14" tags={["agent-server"]}>
  ## v0.7.101

  * 将 Go 标准库升级至 1.25.9，以解决高严重性漏洞 CVE-2026-32280 和 CVE-2026-32282。
  * 改进了 DD 和 OTEL 追踪器中的错误传播，以处理 UserInterrupt 异常而不引发生成器错误。
</Update>

<Update label="2026-04-10" tags={["agent-server"]}>
  ## v0.7.100

  * 实现了检查点的后台删除，以改善线程删除和修剪性能，减少 I/O 压力并提高效率。
  * 将 `@hono/node-server` 从 1.19.12 升级至 1.19.13，以修复 Serve Static Middleware 的安全问题。
  * 将 hono 从版本 4.12.9 更新至 4.12.12，包括针对中间件和实用程序的关键安全补丁。
  * 将 hono 库升级至版本 4.12.12，解决了多个安全漏洞。
  * 为构建依赖项实施了严格的版本锁定，以确保构建的一致性。
</Update>

<Update label="2026-04-09" tags={["agent-server"]}>
  ## v0.7.99

  * 更新了 OpenAPI 配置，以防止在使用带有路径前缀的 Istio 时，`/docs` “试用”请求出现 405 错误。
  * 在 `queue_with_signal` 中将 `signal.raise_signal(SIGINT)` 替换为 `sys.exit`，以提高关闭可靠性并处理卡住的线程。
  * 为执行器客户端添加了可选的 TLS 配置，为现有的非回环部署保留了向后兼容的明文行为。
  * 调整了 Datadog API 密钥配置的优先级顺序，以确保正确使用密钥。
</Update>

<Update label="2026-04-06" tags={["agent-server"]}>
  ## v0.7.98

  * 修复了 `langgraph dev` 中的导入问题，确保开发服务器无需环境变量即可工作，并添加了回归测试。
</Update>

<Update label="2026-04-06" tags={["agent-server"]}>
  ## v0.7.97

  * 改进了 JS 图的错误传播，确保从 `/assistants/<ID>/schemas` 端点获得更清晰的错误消息。
  * 确保当环境变量如 `LANGGRAPH_SERVER_HOST` 设置为 IPv6 地址时，启动稳定。
  * 通过在 `EqAuthFilter` 中使用 `->>` 进行字符串值过滤，增强了查询性能，从而能够使用 B-tree 索引。
</Update>

<Update label="2026-04-03" tags={["agent-server"]}>
  ## v0.7.96

  * 通过禁用嵌套循环并在指定时遵守较低的 `statement_timeout` 设置，增强了数据库性能。
</Update>

<Update label="2026-04-03" tags={["agent-server"]}>
  ## v0.7.95

  * 通过确保在模块加载时导入 `ddtrace`，解决了 `BlockingError`，防止初始化期间的异步上下文冲突。
  * 将 `ddtrace` 上下文传播到工作器，确保 `langgraph.graph_load` 具有父 span，而不是作为根 span 发出。
  * 为 `PATCH /threads/{id}` 添加了对 `Prefer: return=minimal` 的支持，通过返回 204 状态码且无响应体来提高效率。
  * 通过动态端口发现增强了 `run_server`，当默认端口（`2024`）被占用时自动选择可用端口。
</Update>

<Update label="2026-03-31" tags={["agent-server"]}>
  ## v0.7.94

  * 解决了 JavaScript 安装在重试超时后错误地成功的问题，确保正确的失败处理。
  * 在图工厂加载周围添加了 `langgraph.graph_load` ddtrace span，以提高 APM 可见性。
</Update>

<Update label="2026-03-31" tags={["agent-server"]}>
  ## v0.7.93

  * 在 `core-api` 模式下启用了从环境变量读取 `FF_OPTIMIZED_STREAMING` 标志的支持。
</Update>

<Update label="2026-03-31" tags={["agent-server"]}>
  ## v0.7.92

  * 修复了 `keep_latest` 线程可能无限期累积检查点的问题，通过在运行完成后重新创建 `thread_ttl` 条目。
  * 通过缓存 `importlib.metadata.packages_distributions()` 改进了导入性能，显著减少了在使用 `ddtrace` 与 Google API 包时的启动时间。
</Update>

<Update label="2026-03-29" tags={["agent-server"]}>
  ## v0.7.91

  * 将 cryptography 依赖从 46.0.5 升级至 46.0.6，以解决与对等名称验证中名称约束相关的安全问题。
  * 引入了使用 Redis Streams 的优化流式传输实现，采用新的协议版本（v2），以获得更好的性能和可恢复性，具有有效载荷压缩和对 Redis Cluster 读副本的支持。
</Update>

<Update label="2026-03-27" tags={["agent-server"]}>
  ## v0.7.90

  * 改进了 DR 流程中的错误处理，并为测试设置了 30 秒的默认超时，以确保及时跟踪 CI 失败。
  * 将 picomatch 从 4.0.3 升级至 4.0.4，以解决关键安全漏洞。
</Update>

<Update label="2026-03-25" tags={["agent-server"]}>
  ## v0.7.89

  * 增强了队列服务器指标，并建立了对 OpenTelemetry SDK 的要求。
  * 为 `COUNTER_RUN_FAILED_AFTER_RETRY` 指标添加了缺失的标签，以提高监控准确性。
</Update>

<Update label="2026-03-24" tags={["agent-server"]}>
  ## v0.7.87

  * 实现了因 Redis 相关流错误导致的运行失败重试，并添加了警告日志以提高可见性。
</Update>

<Update label="2026-03-23" tags={["agent-server"]}>
  ## v0.7.86

  * 在所有镜像中将默认 `DD_TRACE_ENABLED` 设置为 `false`，以减少非 Datadog 部署的 Orchestrion 日志噪音。
</Update>

<Update label="2026-03-23" tags={["agent-server"]}>
  ## v0.7.84

  * 将嘈杂的警告级别日志降级为信息级别，以减少日志混乱，专注于信息性状态消息，如许可证精简模式和跟踪已禁用。
  * 通过 Orchestrion DD APM 跟踪增强了 Go `core-api-grpc`，实现自动检测和改进的跟踪上下文传播。
</Update>

<Update label="2026-03-19" tags={["agent-server"]}>
  ## v0.7.82

  * 通过保留 `kind` 判别器并在响应中使用小写状态/角色（适用于所有客户端方法名称格式），确保了 A2A 协议合规性。
</Update>

<Update label="2026-03-18" tags={["agent-server"]}>
  ## v0.7.79

  * 引入了 `swr` 函数的测试版，以改进数据获取能力。
  * 在所有 Dockerfile 和 `go.mod` 中将 Go 运行时升级至版本 1.25.8，以解决多个 CVE。
</Update>

<Update label="2026-03-17" tags={["agent-server"]}>
  ## v0.7.77

  * 引入了 `HTTP_MAX_REQUEST_BODY_BYTES` 配置，将 HTTP 请求主体大小限制为 300MB，对超大请求返回 413 错误，以防止内存耗尽。
  * 在 JS 图工厂中添加了通过配置访问存储和检查点器的支持，以促进深度代理初始化。
  * 将 `pyasn1` 依赖从版本 0.6.2 更新至 0.6.3，以增强安全性并修复解析问题。
  * 为流端点添加了检测，以记录首字节时间（TTFB）和响应大小，改进了访问日志详情。
</Update>

<Update label="2026-03-17" tags={["agent-server"]}>
  ## v0.7.76

  * 放宽了 `starlette-sse` 版本范围，以提高依赖兼容性。
</Update>

<Update label="2026-03-17" tags={["agent-server"]}>
  ## v0.7.75

  * 在 `Runs.Enter` 中正确关闭流以防止缓冲区问题，并添加了用于窗口大小的可配置环境变量。
</Update>

<Update label="2026-03-16" tags={["agent-server"]}>
  ## v0.7.74

  * 清理了队列关闭操作期间的一些错误日志。
</Update>

<Update label="2026-03-16" tags={["agent-server"]}>
  ## v0.7.73

  * 通过避免对大型 JSONB 值进行不必要的反序列化，改进了使用 `extract` 的线程搜索性能。
</Update>

<Update label="2026-03-13" tags={["agent-server"]}>
  ## v0.7.72

  * 将 undici 包从版本 7.22.0 更新至 7.24.0，以解决多个安全漏洞。
</Update>

<Update label="2026-03-13" tags={["agent-server"]}>
  ## v0.7.71

  * 通过从 Threads State Checkpoint 和 Runs 创建方法中移除未使用的参数，清理了 API。
  * 修复了使用 `strategy=delete` 的 `POST /threads/prune`，确保线程记录被完全移除，而不仅仅是检查点数据。
  * 在响应对象中添加了 A2A 1.0 `kind` 判别器，移除了 `{"task": ...}` 包装器，并修复了 Anthropic 流元数据问题。
  * 为 Redis 队列添加了自定义加密支持，以增强数据安全性。
</Update>

<Update label="2026-03-11" tags={["agent-server"]}>
  ## v0.7.69

  * 为定时任务添加了可选的 `timezone` 字段，允许在用户指定的时区计算 `next_run_date`，默认为 UTC。
  * 修正了认证异常中 401 状态码的处理，以防止错误地默认为 403。
</Update>

<Update label="2026-03-10" tags={["agent-server"]}>
  ## v0.7.68

  * 修复了非 DR 检查点 AES JSON 的问题，以改进功能并扩展测试覆盖范围。
  * 修复了 A2A 流，使其根据规范正确地将中断工件作为单独的 `artifact-update` 事件发出。
  * 通过仅提取经过验证和安全的成员，确保了安全的 tarfile 提取，以防止任意文件写入漏洞。
  * 通过要求认证中间件中的 `noauth` 路径精确匹配，增强了安全性。
  * 修复了在多任务策略回滚期间将过时的检查点值写入线程状态的问题。
</Update>

<Update label="2026-03-06" tags={["agent-server"]}>
  ## v0.7.66

  * 当 `LANGGRAPH_CHECKPOINTER` 未设置时，为默认检查点器配置添加了对 `LS_CHECKPOINTER_BACKEND` 的回退。
</Update>

<Update label="2026-03-05" tags={["agent-server"]}>
  ## v0.7.65

  * 修复了 `messages-tuple` 流模式中的一个错误，其中 `tool_call_chunks` 包含 `args_json` 而不是 `args`，阻止了消息重建并导致错误。
</Update>

<Update label="2026-03-05" tags={["agent-server"]}>
  ## v0.7.64

  * 启用通过 `LS_MONGODB_URI` 或 `MONGODB_URI` 环境变量设置 MongoDB 检查点器 URI，并具有优先级规则。
</Update>

<Update label="2026-03-04" tags={["agent-server"]}>
  ## v0.7.63

  * 修复了一个可能通过无效运行耗尽工作器而导致队列实例死锁的错误。
</Update>

<Update label="2026-03-02" tags={["agent-server"]}>
  ## v0.7.61

  * 修复了一个竞态条件，以确保健康和指标服务器的优雅关闭。
</Update>

<Update label="2026-02-27" tags={["agent-server"]}>
  ## v0.7.59

  * 更新了 Redis 队列以使用带线程的 zset，通过消除不必要的锁定和优化索引，将 CPU 使用率降低了 25% 并提高了性能。
</Update>

<Update label="2026-02-26" tags={["agent-server"]}>
  ## v0.7.58

  * 在 `storage_postgres/uv.lock` 中将 `langgraph-checkpoint` 升级至 4.0.0，以解决 CVE-2026-27794，并对依赖固定问题进行了调整。
</Update>

<Update label="2026-02-26" tags={["agent-server"]}>
  ## v0.7.57

  * 修复了一个阻止所有用户创建与系统图关联的定时任务的回归问题。
</Update>

<Update label="2026-02-25" tags={["agent-server"]}>
  ## v0.7.56

  * 在存储 HTTP API 端点中添加了对 `ttl`、`index` 和 `refresh_ttl` 参数的支持，以与 SDK 和进程内存储接口保持一致。
  * 在 `GET /threads/{thread_id}` 端点中添加了对 `?include=ttl` 查询参数的支持，以返回 TTL 信息。
  * 更新了指标报告，以准确统计 PostgreSQL 和 Redis 连接，确保 GRPC 和 Python 指标之间的一致性。
</Update>

<Update label="2026-02-25" tags={["agent-server"]}>
  ## v0.7.55

  * 修复了在新定时任务调度器后端中导致重复运行调度的错误。
  * 重构了 `GET /docs` 端点，从静态 OpenAPI 规范读取，以提高与自定义入口配置的兼容性。
</Update>

<Update label="2026-02-24" tags={["agent-server"]}>
  ## v0.7.54

  * 解决了 gRPC 服务的自定义加密上下文因硬编码值而无法正确加载的问题。
</Update>

<Update label="2026-02-24" tags={["agent-server"]}>
  ## v0.7.52

  * 当提供 `feedback_keys` 时，在 `/wait` 和 `/join` 端点响应中添加了反馈 URL，位于 `__feedback__` 键下。
  * 为分布式运行时添加了 feedback\_keys 支持，包括使用 langsmith-go SDK 生成预签名反馈令牌。
  * 将 Werkzeug 从版本 3.1.5 升级至 3.1.6，以解决 Windows 上多段路径中特殊设备名称的安全问题。
  * 将 Go 运行时升级至 1.25.7，以解决漏洞扫描中发现的关键和高严重性 CVE。
</Update>

<Update label="2026-02-22" tags={["agent-server"]}>
  ## v0.7.51

  * 改进了上游中断期间的许可证检查弹性，包括缓存回退、24 小时宽限期和 Redis 条目的自动清理。
  * 确保当 `LANGSERVE_GRAPHS` 配置更改时，助手描述和名称在启动时同步。
  * 通过引入两级协议层次结构并修复能力检测以直接支持扩展方法，增强了检查点器 API。
</Update>

<Update label="2026-02-20" tags={["agent-server"]}>
  ## v0.7.49

  * 请求有效载荷中的保留元数据键现在会被静默剥离，而不是导致 422 错误，从而改善用户体验。
  * 修复了存储默认 TTL 未应用于未显式指定 TTL 参数写入的项目的问题。
</Update>

<Update label="2026-02-19" tags={["agent-server"]}>
  ## v0.7.46

  * 网络钩子中的结构化错误有效载荷现在包含 `error` 和 `message` 字段，取代了以前的扁平字符串格式，这可能会影响解析 `error` 字段的系统。
  * 扩展了存储认证测试，增加了命名空间重写，以增强命名空间处理和跨用户隔离。
</Update>

<Update label="2026-02-19" tags={["agent-server"]}>
  ## v0.7.45

  * 在所有处理路径中将空字节替换为 U+FFFD，以防止键冲突。
</Update>

<Update label="2026-02-19" tags={["agent-server"]}>
  ## v0.7.44

  * 增加数据库 URI 解析器的灵活性
  * 对某些有效载荷添加额外验证
</Update>

<Update label="2026-02-18" tags={["agent-server"]}>
  ## v0.7.40

  * 通过确保在未提供 `metadata` 和 `config` 时将其填充为空对象 `{}` 而不是 `null`，修复了助手创建中的回归问题。
</Update>

<Update label="2026-02-17" tags={["agent-server"]}>
  ## v0.7.39

  * 确保在分布式运行时操作中正确传递认证配置，以提高执行器功能。
  * 为使用基于 RHEL 容器的企业客户添加了基于 Red Hat UBI-9 的 Docker 镜像支持。
  * 为分布式运行时添加了优雅关闭交接，允许进行中的运行无需使用重试尝试即可转移到下一个 Pod。
</Update>

<Update label="2026-02-17" tags={["agent-server"]}>
  ## v0.7.38

  * 在线程中添加了 `state_updated_at` 字段，用于跟踪有意义的状态更改，允许基于这些更改进行过滤和排序。
  * 在核心系统中添加了调度定时任务的支持。
  * 确保在代理卡中准确显示 `https` 协议，使用 x-forwarded-proto 头以实现正确的 A2A 客户端功能。
</Update>

<Update label="2026-02-15" tags={["agent-server"]}>
  ## v0.7.37

  * 在 BYOC 检查点器适配器中为 `acopy_thread`、`aprune` 和 `adelete_for_runs` 添加了通用回退，简化了自定义检查点器的实现。
</Update>

<Update label="2026-02-13" tags={["agent-server"]}>
  ## v0.7.36

  * 更新了 A2A 协议支持至 v1.0 RC，重命名了 JSON-RPC 方法，添加了 ListTasks 处理程序，并增强了角色、状态和部分格式，以改进集成和合规性。
  * 改进了 `Crons.search()` 和 `Crons.count()` 的认证过滤，以防止未授权的线程信息访问。
  * 修复了 BYOC 检查点器在复制、回滚和命名空间过滤操作中的缺陷，确保在不同存储后端之间正确处理。
</Update>

<Update label="2026-02-13" tags={["agent-server"]}>
  ## v0.7.35

  * 为 MCP `tools/call` 和 A2A `message/send` 和 `message/stream` 端点添加了可选的 `context` 参数，允许中间件从头注入运行时上下文。
</Update>

<Update label="2026-02-13" tags={["agent-server"]}>
  ## v0.7.33

  * 通过移除自定义检查点器测试跳过、改进类型化序列化以及添加缺失的 Redis 方法，增强了 Redis 测试夹具。
  * 通过清理单引号 HTML onload 属性中的消息名称，解决了 handle\_ui 端点中的存储型 XSS 漏洞。
  * 修复了 `put_item` 中的授权绕过问题，确保认证处理程序正确重写命名空间。
  * 在运行创建期间强制执行助手所有权检查，防止在未拥有的助手上执行，同时确保系统助手对所有认证用户可访问。
  * 当使用 LANGGRAPH\_AES\_KEY 时，在 Go 检查点器中实现了检查点 blob 和写入的 AES 加密。
  * 实现了初始检查点器 gRPC 服务程序，包含所有必要的方法和转换辅助工具。
</Update>

<Update label="2026-02-11" tags={["agent-server"]}>
  ## v0.7.32

  * 清理了流和 A2A 响应中的错误消息，以保护敏感信息，如数据库连接字符串和内部主机名。
  * 修复了 `join_run_stream` 中的一个错误，以正确处理多个 `stream_mode` 参数，确保正确解析字符串化的 JSON 列表。
  * 为 Node.js 24 镜像添加了构建、测试和发布流程，支持最新的 LTS 版本。
  * 通过添加新功能和改进元数据丰富性，增强了自定义检查点器适配器，以实现一致的 API 响应。
  * 在执行器 Docker 镜像中为 langgraph 库添加了更严格的版本约束，以防止意外升级。
  * 通过清理 SSE 事件和 id 字段以防止 CR/LF 注入，增强了安全性。
  * 修复了一个导致定时任务创建的运行使用默认加密上下文而不是正确传播指定上下文的问题。
</Update>

<Update label="2026-02-11" tags={["agent-server"]}>
  ## v0.7.31

  * 修正了元数据读取功能，以确保准确的数据处理。
</Update>

<Update label="2026-02-10" tags={["agent-server"]}>
  ## v0.7.30

  * 传播定时任务元数据以获得更全面的调度信息。
  * 在 `PATCH` 请求上合并定时任务元数据，通过保留现有数据与其他端点保持一致。
</Update>

<Update label="2026-02-10" tags={["agent-server"]}>
  ## v0.7.29

  * 细化了定时任务创建的认证语义，以防止权限提升并确保定时任务、线程和助手的独立过滤。
  * 验证了 tar 文件条目，以防止 cloudflared 下载过程中的目录遍历漏洞。
  * 在 `SearchThreadsRequest` 中添加了 IDs 过滤器，以简化线程端点操作。
  * 更新了回退机制，使用 Python Postgres 连接处理线程状态，修复了工作器完成检查点的问题。
  * 引入了 Redis 队列实现的初始版本（具有功能标志），并持续更新。
</Update>

<Update label="2026-02-07" tags={["agent-server"]}>
  ## v0.7.28

  * MCP 和 gRPC 的内部维护和稳定性改进。
</Update>

<Update label="2026-02-07" tags={["agent-server"]}>
  ## v0.7.27

  * 通过移除常见消息类型改进了 MCP 工具输入模式，以获得更清晰的工具定义。
  * 为 MCP 工具添加了名称清理，以确保有效的工具名称。
</Update>

<Update label="2026-02-07" tags={["agent-server"]}>
  ## v0.7.26

  * 在入口处添加了系统键验证。
</Update>

<Update label="2026-02-06" tags={["agent-server"]}>
  ## v0.7.25

  * 将 Python 队列工作器切换为使用核心 go `Runs.next()`。
  * 修复了长查询监控器中的监控问题。
</Update>

<Update label="2026-02-06" tags={["agent-server"]}>
  ## v0.7.24

  * 优化了 Postgres 连接处理，以防止在高负载下达到连接限制，并移除了不必要的错误日志。
  * 切换到使用 gRPC 的新后端进行运行管理和流处理。
</Update>

<Update label="2026-02-05" tags={["agent-server"]}>
  ## v0.7.23

  * 修正了 `RunCommand` 中 `input` 字段的解组过程，以确保准确的数据映射并启用以前被阻止的 JS 测试。
  * 通过在执行开始前完全订阅，确保了运行流的竞态条件处理，并添加了对 `FF_LOG_DROPPED_EVENTS` 环境变量的支持。
</Update>

<Update label="2026-02-04" tags={["agent-server"]}>
  ## v0.7.22

  * 确保 `get_store()` 在自定义路由中工作，从而可以从用户定义的 Starlette 端点访问存储。
</Update>

<Update label="2026-02-05" tags={["agent-server"]}>
  ## v0.7.21

  * 支持 PATCH /crons/{cron_id}
</Update>

<Update label="2026-02-04" tags={["agent-server"]}>
  ## v0.7.19

  * 核心 API 的自定义加密改进。
</Update>

<Update label="2026-02-04" tags={["agent-server"]}>
  ## v0.7.18

  * 更新线程流以用于核心 API。
</Update>

<Update label="2026-02-03" tags={["agent-server"]}>
  ## v0.7.17

  * OTEL 的检测现在需要通过 `LS_APM_OTEL_ENABLED=true` 显式启用，以提供更好的控制。
</Update>

<Update label="2026-02-03" tags={["agent-server"]}>
  ## v0.7.16

  * 将线程流切换到新的 gRPC 后端，以提高性能。
  * 在 DR 中引入了副本跟踪，以增强 Studio 的评估能力。
</Update>

<Update label="2026-02-03" tags={["agent-server"]}>
  ## v0.7.15

  * 添加了通过新的 `is_enabled` 字段暂停定时任务的支持，仅允许执行已启用的定时任务。
  * 引入了 gRPC 服务器对 JSON 加密和解密操作的支持。
</Update>

<Update label="2026-02-02" tags={["agent-server"]}>
  ## v0.7.14

  * 确保选定的系统字段被排除在自定义加密之外，以防止对非敏感数据进行不必要的加密。
  * 引入了带有单元测试的自定义检查点器适配器，以验证实现检查。
</Update>

<Update label="2026-01-29" tags={["agent-server"]}>
  ## v0.7.13

  * 修复了一个当设置了挂载前缀时，应用程序状态未在请求中正确保留的错误。
</Update>

<Update label="2026-01-28" tags={["agent-server"]}>
  ## v0.7.11

  * 添加了配置以控制哪些有效载荷字段可以暴露给网络钩子。
  * 更新了 `/api/langgraph_api/js` 组中的所有依赖项，包括 `@langchain/core`、`hono`、`@types/react` 和 `prettier`，至最新版本，以提高性能和安全性。
  * 将 `hono` 从版本 4.11.4 升级至 4.11.7，以解决中间件中的多个安全漏洞。
</Update>

<Update label="2026-01-27" tags={["agent-server"]} rss={{ title: "2026-01-27 - agent-server" }}>
  ## v0.7.10

  * 将 gRPC 服务器启动超时增加至 1 分钟，以防止与核心服务器偶尔出现的连接超时。
  * 将 @langchain/langgraph 从版本 1.1.0 更新至 1.1.2，为 StateGraph 引入了混合模式支持，并为 GraphNode 和 ConditionalEdgeRouter 实用程序引入了类型包模式。
</Update>

<Update label="2026-01-23" tags={["agent-server"]} rss={{ title: "2026-01-23 - agent-server" }}>
  ## v0.7.9

  * A2A `messageId` 现在映射到 LangChain 消息 ID，以实现跨协议的正确消息跟踪。
</Update>

<Update label="2026-01-22" tags={["agent-server"]} rss={{ title: "2026-01-22 - agent-server" }}>
  ## v0.7.7

  * 确保在 gRPC 序列化期间保留检查点元数据中的自定义可配置字段。
</Update>

<Update label="2026-01-21" tags={["agent-server"]} rss={{ title: "2026-01-21 - agent-server" }}>
  ## v0.7.5

  * 在设置线程状态时，强制对值、中断和错误进行自定义加密，解决了以前的不一致问题。
  * 在 `message/stream` 和 `message/send` 路由中添加了 A2A 验证检查，针对 `parts`、`role` 和 `messageId` 字段。
  * 添加了原生 A2A 中断支持：当图被中断时，现在返回 `input-required` 状态。在 `message/stream` 和 `message/send` 请求中使用新的 `command` 参数，通过 `Command` 有效载荷恢复。
  * 在 `/a2a/{assistant_id}/` 下挂载了 `.well-known/agent-card.json`，用于 A2A 代理发现。
  * 在 `tasks/cancel` 中为任务存在检查添加了适当的 A2A 错误代码。
</Update>

<Update label="2026-01-21" tags={["agent-server"]} rss={{ title: "2026-01-21 - agent-server" }}>
  ## v0.7.4

  * 修复了 Redis URL 解析中 `ssl_cert_reqs` 字段的错误，确保与 redis-go 兼容。
  * 添加了用于流运行的 gRPC 客户端，由 `FF_USE_CORE_API` 功能标志控制。
</Update>

<Update label="2026-01-20" tags={["agent-server"]} rss={{ title: "2026-01-20 - agent-server" }}>
  ## v0.7.2

  * 将 `@langchain/langgraph` 更新至版本 1.1.0，为图节点和条件边引入了类型实用程序，以增强 TypeScript 人体工程学。
</Update>

<Update label="2026-01-17" tags={["agent-server"]} rss={{ title: "2026-01-17 - agent-server" }}>
  ## v0.7.0

  * 默认切换到使用 Go 助手实现，以提高性能。
  * 添加了 `LANGGRAPH_AES_JSON_KEYS` 配置，以使用密钥名称允许列表对指定的 JSON 字段启用 AES 加密。
</Update>

<Update label="2026-01-16" tags={["agent-server"]} rss={{ title: "2026-01-16 - agent-server" }}>
  ## v0.6.39

  * 为 Python `core-api` 添加了 `Threads.State()` 的 gRPC 客户端支持，改进了线程 ID 和运行计数操作。
</Update>

<Update label="2026-01-15" tags={["agent-server"]} rss={{ title: "2026-01-15 - agent-server" }}>
  ## v0.6.36

  * 验证了认证过滤器中 `$and` 和 `$or` 的长度，并优化了不必要的根级过滤器。
</Update>

<Update label="2026-01-12" tags={["agent-server"]} rss={{ title: "2026-01-12 - agent-server" }}>
  ## v0.6.35

  * 通过移除 `code` 字段并标准化所有错误以返回带有 `detail` 字段的 JSON，统一了错误格式。
</Update>

<Update label="2026-01-12" tags={["agent-server"]} rss={{ title: "2026-01-12 - agent-server" }}>
  ## v0.6.34

  * 针对功能标志控制的内部环境的小修复（未发布）。
</Update>

<Update label="2026-01-12" tags={["agent-server"]} rss={{ title: "2026-01-12 - agent-server" }}>
  ## v0.6.33

  * 针对功能标志控制的内部环境的小修复（未发布）。
</Update>

<Update label="2026-01-11" tags={["agent-server"]} rss={{ title: "2026-01-11 - agent-server" }}>
  ## v0.6.32

  * 针对功能标志控制的内部环境的小修复（未发布）。
</Update>

<Update label="2026-01-11" tags={["agent-server"]} rss={{ title: "2026-01-11 - agent-server" }}>
  ## v0.6.31

  * 正确遵守了 disable\_a2a 设置，以确保准确的配置处理。
</Update>

<Update label="2026-01-09" tags={["agent-server"]} rss={{ title: "2026-01-09 - agent-server" }}>
  ## v0.6.29

  * 修复小错误。
</Update>

<Update label="2026-01-09" tags={["agent-server"]} rss={{ title: "2026-01-09 - agent-server" }}>
  ## v0.6.28

  * 添加了对 `ParentCommand` 的支持，以正确地将控制传播到父图，增强了命令处理和导航。
  * 添加了用于管理运行操作的 Python gRPC 客户端，增强了 Go 和 Python 实现之间的一致性。
</Update>

<Update label="2026-01-08" tags={["agent-server"]} rss={{ title: "2026-01-08 - agent-server" }}>
  ## v0.6.27

  * 修复了处理空线程元数据时的回归问题。
</Update>

<Update label="2026-01-08" tags={["agent-server"]} rss={{ title: "2026-01-08 - agent-server" }}>
  ## v0.6.26

  * 修复了持久化 gRPC 服务器的端口配置问题。
</Update>

<Update label="2026-01-08" tags={["agent-server"]} rss={{ title: "2026-01-08 - agent-server" }}>
  ## v0.6.25

  * 在执行器层运行核心 API gRPC 服务器，以支持图中的回环 API 调用，并移除了禁用服务器的不必要配置。
</Update>

<Update label="2026-01-07" tags={["agent-server"]} rss={{ title: "2026-01-07 - agent-server" }}>
  ## v0.6.24

  * 修复了执行器层中存活探针的行为，解决了版本 0.6.23 的问题。
</Update>

<Update label="2026-01-07" tags={["agent-server"]} rss={{ title: "2026-01-07 - agent-server" }}>
  ## v0.6.23

  * 将 gRPC 服务器健康检查与存活探针中的 `/ok` 端点集成，以确保正确的启动协调。
  * 撤销了先前禁用检查点器的更改，并添加了仅在测试期间启用 RemoteCheckpointer 的条件。
  * 在检查点元数据中抑制了 `langgraph_auth_*` 和 `langgraph_request_id` 字段，以防止包含临时用户数据。
</Update>

<Update label="2026-01-06" tags={["agent-server"]} rss={{ title: "2026-01-06 - agent-server" }}>
  ## v0.6.22

  * 解决了使用仅 blob 自定义加密时因缺少加密上下文而导致的错误，确保无错误地正常运行。
</Update>

<Update label="2026-01-06" tags={["agent-server"]} rss={{ title: "2026-01-06 - agent-server" }}>
  ## v0.6.21

  * 引入了用于运行操作的 Python gRPC 客户端，包括 `Search`、`Get`、`Delete`、`Cancel`、`Stats` 和 `Sweep`，并更新了 API 实现和新的单元测试套件用于枚举映射。
</Update>

<Update label="2026-01-06" tags={["agent-server"]} rss={{ title: "2026-01-06 - agent-server" }}>
  ## v0.6.19

  * 在引擎服务器中重现了 `get_state` 和 `update_state` 的 OSS 实现，并重新启用了 `test_weather_subgraph`。
</Update>

<Update label="2026-01-05" tags={["agent-server"]} rss={{ title: "2026-01-05 - agent-server" }}>
  ## v0.6.18

  * 添加了为自托管企业用户强制执行特定许可证声明的功能，从而可以远程禁用 Agent Builder 产品。
  * 添加了新的 Prune 端点以更好地管理资源。
  * 在 Pregel 中将图配置与调用配置合并，优先考虑调用设置。
  * 在 GET /threads/{id} 端点中引入了 `include=ttl` 查询参数，用于可选的 TTL 信息检索，而不影响标准读取性能。
  * 引入了 `keep_latest` TTL 策略，通过核心 API 在修剪旧检查点时保留最新状态。
</Update>

<Update label="2025-12-31" tags={["agent-server"]} rss={{ title: "2025-12-31 - agent-server" }}>
  ## v0.6.17

  * 确保在删除代理时停止正在进行的运行，以防止遗留进程。
</Update>

<Update label="2025-12-30" tags={["agent-server"]} rss={{ title: "2025-12-30 - agent-server" }}>
  ## v0.6.16

  * 精简并整合了 Go 持久层中的运行操作，提高了跨包的效率和一致性。
</Update>

<Update label="2025-12-26" tags={["agent-server"]} rss={{ title: "2025-12-26 - agent-server" }}>
  ## v0.6.15

  * 改进了将自定义路由文档字符串转换为 OpenAPI 模式内容的实用程序，在解析文档字符串时添加了错误处理，适用于具有自定义 Starlette 应用程序的用户。
</Update>

<Update label="2025-12-23" tags={["agent-server"]} rss={{ title: "2025-12-23 - agent-server" }}>
  ## v0.6.12

  * 改进了 resolve\_embeddings 使其更健壮，允许多次调用而不会出错。
  * 将 `@langchain/langgraph` 从版本 1.0.4 更新至 1.0.7，添加了对远程图上 resumableStreams 的支持，并取消了对 toolsCondition 的弃用。
  * 实现了 `RemoteCheckpointer` 以启用子图检查点，增强了任务执行可靠性。
</Update>

<Update label="2025-12-20" tags={["agent-server"]} rss={{ title: "2025-12-20 - agent-server" }}>
  ## v0.6.11

  * 使最大重试次数可配置，以增强自定义性。
</Update>

<Update label="2025-12-20" tags={["agent-server"]} rss={{ title: "2025-12-20 - agent-server" }}>
  ## v0.6.10

  * 确保运行取消仅处理 'message' 类型的 Redis 事件，提高了发布订阅客户端的可靠性。
  * 为存储 API `value` 字段添加了自定义加密，允许用户选择要加密的密钥以增强安全性。
  * 通过更新 TeeStream 以单独处理事件类型，启用了子图自定义事件的流处理。
</Update>

<Update label="2025-12-18" tags={["agent-server"]} rss={{ title: "2025-12-18 - agent-server" }}>
  ## v0.6.9

  * 强制为自定义加密使用稳定的 JSON 键，移除了特定于模型类型的自定义 JSON 函数，并改进了双重加密场景的错误处理。
</Update>

<Update label="2025-12-18" tags={["agent-server"]} rss={{ title: "2025-12-18 - agent-server" }}>
  ## v0.6.8

  * 添加了分析功能以增强性能分析和监控。
</Update>

<Update label="2025-12-18" tags={["agent-server"]} rss={{ title: "2025-12-18 - agent-server" }}>
  ## v0.6.7

  * 记录了服务器启动时间，以改进监控和诊断。
</Update>

<Update label="2025-12-17" tags={["agent-server"]} rss={{ title: "2025-12-17 - agent-server" }}>
  ## v0.6.5

  * 在导入时添加了警告日志，以提高可见性。
</Update>

<Update label="2025-12-16" tags={["agent-server"]} rss={{ title: "2025-12-16 - agent-server" }}>
  ## v0.6.4

  * 通过并行化元数据和配置过程增强了自定义加密，为 thread.config 和一些检查点添加了加密，改进了测试和模式一致性。
  * 确保 Go 服务器在队列入口点以 `core-api` 模式启动，以实现一致的运行时行为。
</Update>

<Update label="2025-12-15" tags={["agent-server"]} rss={{ title: "2025-12-15 - agent-server" }}>
  ## v0.6.2

  * 解决了当指定 `mount_prefix` 时导致中间件被重复调用的问题。
</Update>

<Update label="2025-12-15" tags={["agent-server"]} rss={{ title: "2025-12-15 - agent-server" }}>
  ## v0.6.0

  此次要版本更新了流 API `/join-stream` 和 `/stream` 关于 `last-event-id` 参数的行为，以符合 SSE 规范。以前，传递 last-event-id 会返回该消息以及任何后续消息。今后，这些 API 将仅返回提供的 last-event-id 之后的新消息。例如，对于以下流，以前传递 last-event-id `2` 将返回 id 为 `2` 和 `3` 的消息，但现在将仅返回 id 为 `3` 的消息：

  ```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  {
      "id": 1,
      "event": "message",
      "data": {
          "content": "Excluded"
      }
  },
  {
      "id": 2,
      "event": "message",
      "data": {
          "content": "Passed last-event-id"
      }
  },
  {
      "id": 3,
      "event": "message",
      "data": {
          "content": "Included"
      }
  }
  ```

  此版本更新还包括一些修复，包括一个在运行流中暴露意外内部事件的错误。
</Update>

<Update label="2025-12-12" tags={["agent-server"]} rss={{ title: "2025-12-12 - agent-server" }}>
  ## v0.5.42

  * 修改了 Go 服务器，仅依赖 CLI `-service` 标志来确定服务模式，忽略全局设置的 `FF_USE_CORE_API`，以提高部署特异性。
</Update>

<Update label="2025-12-11" tags={["agent-server"]} rss={{ title: "2025-12-11 - agent-server" }}>
  ## v0.5.41

  通过确保正确初始化 ENTERPRISE\_SAAS 全局标志，修复了混合模式下定时任务的问题。
</Update>

<Update label="2025-12-10" tags={["agent-server"]} rss={{ title: "2025-12-10 - agent-server" }}>
  ## v0.5.39

  * 完成了运行和定时任务的自定义加密实现，并简化了加密过程。
  * 引入了在 `values` 和 `updates` 流模式下流式传输子图事件的支持。
</Update>

<Update label="2025-12-10" tags={["agent-server"]} rss={{ title: "2025-12-10 - agent-server" }}>
  ## v0.5.38

  * 实现了线程的完整自定义加密，确保所有线程数据都得到适当保护和加密。
  * 确保 Redis 尝试标志一致过期，以防止过时数据。
  * 添加了核心认证和对 OR/AND 过滤器的支持，增强了安全性和灵活性。
</Update>

<Update label="2025-12-09" tags={["agent-server"]} rss={{ title: "2025-12-09 - agent-server" }}>
  ## v0.5.37

  为助手计数 API 添加了 `name` 参数，以提高搜索灵活性。
</Update>

<Update label="2025-12-09" tags={["agent-server"]} rss={{ title: "2025-12-09 - agent-server" }}>
  ## v0.5.36

  * 引入了可配置的网络钩子支持，允许用户自定义提交的网络钩子和头。
  * 在根目录添加了 `/ok` 端点，以便于健康检查和简化配置。
</Update>

<Update label="2025-12-08" tags={["agent-server"]} rss={{ title: "2025-12-08 - agent-server" }}>
  ## v0.5.34

  引入了自定义加密中间件，允许用户定义自己的加密方法以增强数据保护。
</Update>

<Update label="2025-12-08" tags={["agent-server"]} rss={{ title: "2025-12-08 - agent-server" }}>
  ## v0.5.33

  将 Uvicorn 的 keep-alive 超时设置为 75 秒，以防止偶尔出现 502 错误并改善连接处理。
</Update>

<Update label="2025-12-06" tags={["agent-server"]} rss={{ title: "2025-12-06 - agent-server" }}>
  ## v0.5.32

  引入了 OpenTelemetry 遥测代理，支持 New Relic 集成。
</Update>

<Update label="2025-12-05" tags={["agent-server"]} rss={{ title: "2025-12-05 - agent-server" }}>
  ## v0.5.31

  添加了 Py-Spy 分析，以改进部署性能分析，但覆盖范围有限制。
</Update>

<Update label="2025-12-05" tags={["agent-server"]} rss={{ title: "2025-12-05 - agent-server" }}>
  ## v0.5.30

  * 始终配置回环传输客户端以提高可靠性。
  * 确保为 JS 中的远程非流方法传递认证头。
</Update>

<Update label="2025-12-04" tags={["agent-server"]} rss={{ title: "2025-12-04 - agent-server" }}>
  ## v0.5.28

  * 引入了更快的、基于 Rust 的 uuid7 实现以提高性能，现在用于 langsmith 和 langchain-core。
  * 在 PostgreSQL 认证过滤器中添加了对 `$or` 和 `$and` 的支持，以在认证检查中启用复杂逻辑。
  * 限制了 psycopg 和 psycopg-pool 版本，以防止启动时无限期等待。
</Update>

<Update label="2025-11-26" tags={["agent-server"]} rss={{ title: "2025-11-26 - agent-server" }}>
  ## v0.5.27

  * 确保带过滤器的 `runs.list` 仅返回运行字段，防止包含不正确的状态数据。
  * (JS) 将 `uuid` 从版本 10.0.0 更新至 13.0.0，将 `exit-hook` 从版本 4.0.0 更新至 5.0.1。
</Update>

<Update label="2025-11-24" tags={["agent-server"]} rss={{ title: "2025-11-24 - agent-server" }}>
  ## v0.5.26

  解决了在 JavaScript 环境中未使用 AsyncBatchedStore 时 `store.put` 的问题。
</Update>

<Update label="2025-11-22" tags={["agent-server"]} rss={{ title: "2025-11-22 - agent-server" }}>
  ## v0.5.25

  * 引入了通过新端点按 `name` 搜索助手的能力。
  * 在 JavaScript 中将 store\_get 返回类型转换为元组，以确保类型一致性。
</Update>

<Update label="2025-11-21" tags={["agent-server"]} rss={{ title: "2025-11-21 - agent-server" }}>
  ## v0.5.24

  * 为 Datadog 添加了执行器指标，并增强了核心流 API 指标，以实现更好的性能跟踪。
  * 禁用了 Redis Go 维护通知，以防止在低于 8 的 Redis 版本中因不支持的命令而导致启动错误。
</Update>

<Update label="2025-11-20" tags={["agent-server"]} rss={{ title: "2025-11-20 - agent-server" }}>
  ## v0.5.20

  解决了执行器服务在处理大消息时发生的错误。
</Update>

<Update label="2025-11-19" tags={["agent-server"]} rss={{ title: "2025-11-19 - agent-server" }}>
  ## v0.5.19

  将内置的 langchain-core 升级至版本 1.0.7，以解决提示格式漏洞。
</Update>

<Update label="2025-11-19" tags={["agent-server"]} rss={{ title: "2025-11-19 - agent-server" }}>
  ## v0.5.18

  引入了具有 `on_run_completed: {keep,delete}` 的持久化定时任务线程，以增强定时任务管理和检索选项。
</Update>

<Update label="2025-11-19" tags={["agent-server"]} rss={{ title: "2025-11-19 - agent-server" }}>
  ## v0.5.17

  增强了任务处理以支持多个中断，与开源功能保持一致。
</Update>

<Update label="2025-11-18" tags={["agent-server"]} rss={{ title: "2025-11-18 - agent-server" }}>
  ## v0.5.15

  为 `Resume` 和 `Goto` 命令添加了自定义 JSON 解组，以修复映射样式空恢复解释问题。
</Update>

<Update label="2025-11-14" tags={["agent-server"]} rss={{ title: "2025-11-14 - agent-server" }}>
  ## v0.5.14

  确保 `pg make start` 命令在启用 core-api 时正常工作。
</Update>

<Update label="2025-11-13" tags={["agent-server"]} rss={{ title: "2025-11-13 - agent-server" }}>
  ## v0.5.13

  支持 `include` 和 `exclude`（`includes` 和 `excludes` 的复数形式键），因为文档错误地声称支持该功能。现在服务器接受任一形式。
</Update>

<Update label="2025-11-10" tags={["agent-server"]} rss={{ title: "2025-11-10 - agent-server" }}>
  ## v0.5.11

  * 确保在流式传输线程时一致地应用认证处理程序，与最近的安全实践保持一致。
  * 将 `undici` 依赖从版本 6.21.3 升级至 7.16.0，引入了各种性能改进和错误修复。
  * 将 `p-queue` 从版本 8.0.1 更新至 9.0.0，引入了新功能和破坏性更改，包括移除 `throwOnTimeout` 选项。
</Update>

<Update label="2025-11-10" tags={["agent-server"]} rss={{ title: "2025-11-10 - agent-server" }}>
  ## v0.5.10

  在队列 /ok 处理程序中实现了健康检查调用，以提高 Kubernetes 存活和就绪探针的兼容性。
</Update>

<Update label="2025-11-09" tags={["agent-server"]} rss={{ title: "2025-11-09 - agent-server" }}>
  ## v0.5.9

  * 解决了在 SIGINT 中断期间 `elapsed` 变量导致“未绑定局部变量错误”的问题。
  * 将“中断”状态映射到 A2A 的“input-required”状态，以实现更好的任务状态对齐。
</Update>

<Update label="2025-11-07" tags={["agent-server"]} rss={{ title: "2025-11-07 - agent-server" }}>
  ## v0.5.8

  * 确保在启动 langgraph-ui 时将环境变量作为字典传递，以与 `uvloop` 兼容。
  * 在 Go 中实现了运行的 CRUD 操作，简化了 JSON 合并并提高了事务可读性，以 PostgreSQL 为参考。
</Update>

<Update label="2025-11-07" tags={["agent-server"]} rss={{ title: "2025-11-07 - agent-server" }}>
  ## v0.5.7

  将无重试 Redis 客户端替换为重试客户端，以更有效地处理连接错误，并降低了相应的日志记录严重性。
</Update>

<Update label="2025-11-06" tags={["agent-server"]} rss={{ title: "2025-11-06 - agent-server" }}>
  ## v0.5.6

  * 添加了待处理时间指标，以更好地了解任务等待时间。
  * 将 `pb.Value` 替换为 `ChannelValue`，以简化代码结构。
</Update>

<Update label="2025-11-05" tags={["agent-server"]} rss={{ title: "2025-11-05 - agent-server" }}>
  ## v0.5.5

  使 Redis `health_check_interval` 更频繁且可配置，以更好地处理空闲连接。
</Update>

<Update label="2025-11-05" tags={["agent-server"]} rss={{ title: "2025-11-05 - agent-server" }}>
  ## v0.5.4

  实现了带有 `OPT_REPLACE_SURROGATES` 的 `ormsgpack`，并更新以兼容影响自定义认证依赖项的最新 FastAPI 版本。
</Update>

<Update label="2025-11-03" tags={["agent-server"]} rss={{ title: "2025-11-03 - agent-server" }}>
  ## v0.5.2

  在启动期间为 PostgreSQL 连接添加了重试逻辑，以提高部署可靠性，并改进了错误日志记录以便于调试。
</Update>

<Update label="2025-11-03" tags={["agent-server"]} rss={{ title: "2025-11-03 - agent-server" }}>
  ## v0.5.1

  * 解决了持久化与 LangChain.js 的 createAgent 功能无法正常工作的问题。
  * 通过改进数据库连接池和 gRPC 客户端重用，优化了助手 CRUD 性能，减少了大型有效载荷的延迟。
</Update>

<Update label="2025-10-31" tags={["agent-server"]} rss={{ title: "2025-10-31 - agent-server" }}>
  ## v0.5.0

  此次要版本现在要求 langgraph-checkpoint 版本高于 3.0，以防止早期版本的 langgraph-checkpoint 库中的反序列化漏洞。
  `langgraph-checkpoint` 库与 `langgraph` 次要版本 0.4、0.5、0.6 和 1.0 兼容。

  此版本移除了对使用“json”类型保存的有效载荷的反序列化的默认支持，这从来不是默认设置。
  默认情况下，对象使用 msgpack 序列化。在某些不常见的情况下，有效载荷使用较旧的“json”模式序列化。如果这些有效载荷包含自定义 python 对象，除非您提供 `serde` 配置，否则它们将不再可反序列化：

  ```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  {
      "checkpointer": {
          "serde": {
              "allowed_json_modules": [
                  ["my_agent", "my_file", "SomeType"],
              ]
          }
      }
  }
  ```
</Update>

<Update label="2025-10-29" tags={["agent-server"]} rss={{ title: "2025-10-29 - agent-server" }}>
  ## v0.4.47

  * 使用 TypeAdapter 验证并自动更正环境配置类型。
  * 添加了对 LangChain.js 和 LangGraph.js 版本 1.x 的支持，确保兼容性。
  * 将 hono 库从版本 4.9.7 更新至 4.10.3，解决了 CORS 中间件安全问题并增强了 JWT 受众验证。
  * 引入了模块化基准测试框架，添加了对助手和流的支持，并改进了现有的斜坡基准测试方法。
  * 引入了用于核心线程 CRUD 操作的 gRPC API，并更新了 Python 和 TypeScript 客户端。
  * 将 `hono` 包从版本 4.9.7 更新至 4.10.2，包括 JWT 受众验证的安全改进。
  * 将 `hono` 依赖从版本 4.9.7 更新至 4.10.3，以修复安全问题并改进 CORS 中间件处理。
  * 引入了线程的基本 CRUD 操作，包括创建、获取、修补、删除、搜索、计数和复制，支持 Go、gRPC 服务器以及 Python 和 TypeScript 客户端。
</Update>

<Update label="2025-10-21" tags={["agent-server"]} rss={{ title: "2025-10-21 - agent-server" }}>
  ## v0.4.46

  添加了一个选项以启用从子图事件进行消息流，使用户可以更好地控制事件通知。
</Update>

<Update label="2025-10-21" tags={["agent-server"]} rss={{ title: "2025-10-21 - agent-server" }}>
  ## v0.4.45

  * 实现了对自定义路由授权的支持，由 `enable_custom_route_auth` 标志控制。
  * 将默认跟踪设置为关闭，以提高性能并简化调试。
</Update>

<Update label="2025-10-18" tags={["agent-server"]} rss={{ title: "2025-10-18 - agent-server" }}>
  ## v0.4.44

  使用 Redis 键前缀处理许可证相关键，以防止与现有设置冲突。
</Update>

<Update label="2025-10-16" tags={["agent-server"]} rss={{ title: "2025-10-16 - agent-server" }}>
  ## v0.4.43

  实现了 Redis 连接的健康检查，以防止它们空闲退出。
</Update>

<Update label="2025-10-15" tags={["agent-server"]} rss={{ title: "2025-10-15 - agent-server" }}>
  ## v0.4.40

  * 通过解决竞态条件并添加测试以确保一致行为，防止了可恢复运行和线程流中的重复消息。
  * 确保在确认发布订阅订阅之前运行不会启动，以防止启动时消息丢失。
  * 将平台从 langgraph 重命名，以提高清晰度和品牌知名度。
  * 使用后重置 PostgreSQL 连接以防止锁持有，并改进了事务问题的错误报告。
</Update>

<Update label="2025-10-10" tags={["agent-server"]} rss={{ title: "2025-10-10 - agent-server" }}>
  ## v0.4.39

  * 将 `hono` 从版本 4.7.6 升级至 4.9.7，解决了与 `bodyLimit` 中间件相关的安全问题。
  * 允许自定义基础认证 URL 以增强灵活性。
  * 使用 'uv' 将 'ty' 依赖固定到稳定版本，以防止意外的 linting 失败。
</Update>

<Update label="2025-10-08" tags={["agent-server"]} rss={{ title: "2025-10-08 - agent-server" }}>
  ## v0.4.38

  * 将 `LANGSMITH_API_KEY` 替换为 `LANGSMITH_CONTROL_PLANE_API_KEY`，以支持需要许可证验证的混合部署。
  * 引入了自托管日志摄取支持，可通过 `SELF_HOSTED_LOGS_ENABLED` 和 `SELF_HOSTED_LOGS_ENDPOINT` 环境变量进行配置。
</Update>

<Update label="2025-10-06" tags={["agent-server"]} rss={{ title: "2025-10-06 - agent-server" }}>
  ## v0.4.37

  复制线程需要创建权限，以确保正确的授权。
</Update>

<Update label="2025-10-03" tags={["agent-server"]} rss={{ title: "2025-10-03 - agent-server" }}>
  ## v0.4.36

  * 改进了错误处理，并在扫描循环中添加了延迟，以便在 Redis 停机或取消错误期间更平稳地运行。
  * 更新了队列入口点，以便在启用 `FF_USE_CORE_API` 时启动核心 API gRPC 服务器。
  * 在助手端点中引入了对无效配置的检查，以确保与其他端点保持一致。
</Update>

<Update label="2025-10-02" tags={["agent-server"]} rss={{ title: "2025-10-02 - agent-server" }}>
  ## v0.4.35

  * 解决了核心 API 中的时区问题，确保准确的时间数据检索。
  * 引入了新的 `middleware_order` 设置，以在自定义中间件之前应用认证中间件，允许对受保护路由配置进行更精细的控制。
  * 在 Redis 客户端创建期间发生错误时记录 Redis URL。
  * 改进了 Go 引擎/运行时上下文传播，以确保一致的执行流程。
  * 从执行器入口点移除了不必要的 `assistants.put` 调用，以简化流程。
</Update>

<Update label="2025-10-01" tags={["agent-server"]} rss={{ title: "2025-10-01 - agent-server" }}>
  ## v0.4.34

  阻止未授权用户更新线程 TTL 设置，以增强安全性。
</Update>

<Update label="2025-10-01" tags={["agent-server"]} rss={{ title: "2025-10-01 - agent-server" }}>
  ## v0.4.33

  * 通过记录 `LockNotOwnedError` 并将初始池迁移锁超时延长至 60 秒，改进了 Redis 锁的错误处理。
  * 更新了 BaseMessage 模式以与最新的 langchain-core 版本保持一致，并同步了构建依赖项以实现一致的本地开发。
</Update>

<Update label="2025-09-30" tags={["agent-server"]} rss={{ title: "2025-09-30 - agent-server" }}>
  ## v0.4.32

  * 在 API 镜像中添加了 GO 持久层，支持 PostgreSQL 的 GRPC 服务器操作，并增强了可配置性。
  * 当发生超时时将状态设置为错误，以改进错误处理。
</Update>

<Update label="2025-09-30" tags={["agent-server"]} rss={{ title: "2025-09-30 - agent-server" }}>
  ## v0.4.30

  * 添加了对使用 `stream_mode="events"` 时上下文的支持，并为此功能添加了新测试。
  * 添加了对使用 `$LANGGRAPH_SERVER_PORT` 覆盖服务器端口的支持，并移除了不必要的 Dockerfile `ARG` 以简化配置。
  * 在线程删除 CTE 中对所有表引用应用授权过滤器，以增强安全性。
  * 引入了自托管指标摄取功能，当设置相应的环境变量时，允许每分钟将指标发送到 OTLP 收集器。
  * 确保 `set_latest` 函数正确更新版本的名称和描述。
</Update>

<Update label="2025-09-26" tags={["agent-server"]} rss={{ title: "2025-09-26 - agent-server" }}>
  ## v0.4.29

  确保在所有场景中正确清理 redis 发布订阅连接。
</Update>

<Update label="2025-09-25" tags={["agent-server"]} rss={{ title: "2025-09-25 - agent-server" }}>
  ## v0.4.28

  * 为队列指标服务器添加了格式参数，以增强自定义性。
  * 修正了 CLI 中 `MOUNT_PREFIX` 环境变量的使用，以与文档保持一致并防止混淆。
  * 添加了一个功能，当消息因无订阅者而被丢弃时记录警告，可通过功能标志控制。
  * 在 Node 镜像中添加了对 Bookworm 和 Bullseye 发行版的支持。
  * 通过将执行器定义从 `langgraph-go` 仓库移出，整合了执行器定义，提高了可管理性，并更新了检查点器设置方法以用于服务器迁移。
  * 确保为 a2a 发送正确的响应头，提高了兼容性和通信能力。
  * 整合了 PostgreSQL 检查点实现，为 `/core` 目录添加了 CI 测试，修复了 RemoteStore 测试错误，并通过事务增强了 Store 实现。
  * 为队列服务器添加了 PostgreSQL 迁移，以防止在执行迁移之前添加图而导致错误。
</Update>

<Update label="2025-09-23" tags={["agent-server"]} rss={{ title: "2025-09-23 - agent-server" }}>
  ## v0.4.27

  将 `coredis` 替换为 `redis-py`，以改善高流量负载下的连接处理和可靠性。
</Update>

<Update label="2025-09-22" tags={["agent-server"]} rss={{ title: "2025-09-22 - agent-server" }}>
  ## v0.4.24

  * 添加了根据 A2A 规范为 A2A 调用返回完整消息历史记录的功能。
  * 在 Dockerfile 中添加了 `LANGGRAPH_SERVER_HOST` 环境变量，以支持双栈模式的自定义主机设置。
</Update>

<Update label="2025-09-22" tags={["agent-server"]} rss={{ title: "2025-09-22 - agent-server" }}>
  ## v0.4.23

  使用更快的消息编解码器进行 redis 流处理。
</Update>

<Update label="2025-09-19" tags={["agent-server"]} rss={{ title: "2025-09-19 - agent-server" }}>
  ## v0.4.22

  将长流处理移植到运行流、加入和取消端点，以改进流管理。
</Update>

<Update label="2025-09-18" tags={["agent-server"]} rss={{ title: "2025-09-18 - agent-server" }}>
  ## v0.4.21

  * 添加了 A2A 流功能，并使用 A2A SDK 增强了测试。
  * 添加了 Prometheus 指标以跟踪图、中间件和认证中的语言使用情况，以获得更好的洞察。
  * 修复了开源软件中与块消息转换相关的错误。
  * 从发布订阅订阅中移除了 await，以减少集群测试中的不稳定性，并在关闭套件中添加了重试以增强 API 稳定性。
</Update>

<Update label="2025-09-11" tags={["agent-server"]} rss={{ title: "2025-09-11 - agent-server" }}>
  ## v0.4.20

  优化了 Pubsub 初始化以防止开销并解决订阅时序问题，确保更平稳的运行执行。
</Update>

<Update label="2025-09-11" tags={["agent-server"]} rss={{ title: "2025-09-11 - agent-server" }}>
  ## v0.4.19

  通过解决版本 3.2.10 中引入的函数检查，移除了 psycopg 的警告。
</Update>

<Update label="2025-09-11" tags={["agent-server"]} rss={{ title: "2025-09-11 - agent-server" }}>
  ## v0.4.17

  过滤掉带有挂载前缀的日志，以减少日志输出中的噪音。
</Update>

<Update label="2025-09-10" tags={["agent-server"]} rss={{ title: "2025-09-10 - agent-server" }}>
  ## v0.4.16

  * 在 a2a 中添加了对隐式线程创建的支持，以简化操作。
  * 改进了分布式运行时流中的错误序列化和发出，实现了更全面的测试。
</Update>

<Update label="2025-09-09" tags={["agent-server"]} rss={{ title: "2025-09-09 - agent-server" }}>
  ## v0.4.13

  * 在健康端点中监控队列状态，以确保在 PostgreSQL 初始化失败时正确运行。
  * 解决了扫描 ID 长度不相等的问题，以提高日志清晰度。
  * 通过避免重新序列化 DR 有效载荷，使用 msgpack 字节检查进行类似 json 的解析，增强了流输出。
</Update>

<Update label="2025-09-04" tags={["agent-server"]} rss={{ title: "2025-09-04 - agent-server" }}>
  ## v0.4.12

  * 确保即使在遇到数据库连接问题时也返回指标。
  * 优化了更新流以防止不必要的数据传输。
  * 在 `storage_postgres/langgraph-api-server` 中将 `hono` 从版本 4.9.2 升级至 4.9.6，以改进 URL 路径解析安全性。
  * 为 LangSmith 访问调用添加了重试和内存缓存，以提高对单次故障的弹性。
</Update>

<Update label="2025-09-04" tags={["agent-server"]} rss={{ title: "2025-09-04 - agent-server" }}>
  ## v0.4.11

  在线程更新中添加了对 TTL（生存时间）的支持。
</Update>

<Update label="2025-09-04" tags={["agent-server"]} rss={{ title: "2025-09-04 - agent-server" }}>
  ## v0.4.10

  在分布式运行时中，更新了最终检查点 -> 线程设置的序列化逻辑。
</Update>

<Update label="2025-09-02" tags={["agent-server"]} rss={{ title: "2025-09-02 - agent-server" }}>
  ## v0.4.9

  * 在搜索端点中添加了按 ID 过滤搜索结果的支持，以实现更精确的查询。
  * 为助手端点包含了可配置的头，以增强请求自定义。
  * 实现了一个简单的 A2A 端点，支持代理卡检索、任务创建和任务管理。
</Update>

<Update label="2025-08-30" tags={["agent-server"]} rss={{ title: "2025-08-30 - agent-server" }}>
  ## v0.4.7

  停止包含 x-api-key 以增强安全性。
</Update>

<Update label="2025-08-29" tags={["agent-server"]} rss={{ title: "2025-08-29 - agent-server" }}>
  ## v0.4.6

  修复了加入流时的竞态条件，防止重复的启动事件。
</Update>

<Update label="2025-08-29" tags={["agent-server"]} rss={{ title: "2025-08-29 - agent-server" }}>
  ## v0.4.5

  * 确保检查点器在队列之前和之后正确启动和停止，以提高关闭和启动效率。
  * 解决了当队列被取消时工作器被过早取消的问题。
  * 通过添加 Redis 无法唤醒工作器时的回退，防止队列终止。
</Update>

<Update label="2025-08-28" tags={["agent-server"]} rss={{ title: "2025-08-28 - agent-server" }}>
  ## v0.4.4

  * 将无状态运行的自定义认证 thread\_id 设置为 None，以防止冲突。
  * 通过添加唤醒工作器和 Redis 锁实现，改进了 Go 运行时中的 Redis 信号，并更新了扫描逻辑。
</Update>

<Update label="2025-08-27" tags={["agent-server"]} rss={{ title: "2025-08-27 - agent-server" }}>
  ## v0.4.3

  * 为线程流添加了流模式，以改进数据处理。
  * 为运行添加了持久性参数，以改进数据持久化。
</Update>

<Update label="2025-08-27" tags={["agent-server"]} rss={{ title: "2025-08-27 - agent-server" }}>
  ## v0.4.2

  确保在创建运行之前初始化发布订阅，以防止因缺少消息而导致错误。
</Update>

<Update label="2025-08-25" tags={["agent-server"]} rss={{ title: "2025-08-25 - agent-server" }}>
  ## v0.4.0

  次要版本 0.4 带来了许多改进以及一些破坏性更改。

  * 在线程流中正确发出尝试消息。
  * 通过仅在线程 ID 中使用哈希进行集群映射，减少了集群冲突，优先考虑 stream\_thread\_cache 的效率。
  * 引入了线程的流端点，以跟踪顺序执行的运行中的所有输出。
  * 使 PostgreSQL 中的过滤器查询构建器对格式错误的表达式更加健壮，并改进了验证以防止潜在的安全风险。

  此次要版本还包括一些破坏性更改，以提高服务的可用性和安全性：

  * 在此次要版本中，我们停止了自动将头作为可配置值包含在运行中的做法。您可以通过在代理服务器配置中设置 **configurable\_headers** 来选择特定模式。
  * 运行流事件 ID（用于可恢复流）现在采用 `ms-seq` 格式，而不是以前的格式。我们保留了对旧格式的向后兼容性，但建议在新代码中使用新格式。
</Update>

<Update label="2025-08-25" tags={["agent-server"]} rss={{ title: "2025-08-25 - agent-server" }}>
  ## v0.3.4

  * 为 Redis/PG 连接池添加了自定义 Prometheus 指标，并将队列服务器切换到 Uvicorn/Starlette 以改进监控。
  * 通过更正 shell 命令格式恢复了 Wolfi 镜像构建，并添加了用于使用 nginx 进行测试的 Makefile 目标。
</Update>

<Update label="2025-08-22" tags={["agent-server"]} rss={{ title: "2025-08-22 - agent-server" }}>
  ## v0.3.3

  * 为特定的 Redis 调用添加了超时，以防止工作器保持活动状态。
  * 更新了 Golang 运行时，并为不支持的功能添加了 pytest 跳过，包括对将存储传递给节点和消息流的初始支持。
  * 引入了反向代理设置，用于提供组合的 Python 和 Node.js 图，由 nginx 处理服务器路由，以便为 Node.js API 服务器提供 Postgres/Redis 后端。
</Update>

<Update label="2025-08-21" tags={["agent-server"]} rss={{ title: "2025-08-21 - agent-server" }}>
  ## v0.3.1

  为池添加了语句超时，以防止长时间运行的查询。
</Update>

<Update label="2025-08-21" tags={["agent-server"]} rss={{ title: "2025-08-21 - agent-server" }}>
  ## v0.3.0

  * 设置了默认 15 分钟的语句超时，并实现了对长时间运行查询的监控，以确保系统效率。
  * 停止将运行可配置值传播到线程配置，因为如果您指定 checkpoint\_id，这可能会在后续运行中导致问题。这是一个**轻微的破坏性更改**，因为线程值将不再自动反映最近运行的联合配置。然而，我们认为这种行为更直观。
  * 通过在 ops.py 中处理通道名称中的事件数据，增强了与旧工作器版本的兼容性。
</Update>

<Update label="2025-08-20" tags={["agent-server"]} rss={{ title: "2025-08-20 - agent-server" }}>
  ## v0.2.137

  修复了未绑定的局部变量错误，并改进了线程中断或错误的日志记录，以及类型更新。
</Update>

<Update label="2025-08-20" tags={["agent-server"]} rss={{ title: "2025-08-20 - agent-server" }}>
  ## v0.2.136

  * 添加了增强的日志记录以帮助调试 metaview 问题。
  * 将执行器和运行时升级到最新版本，以提高性能和稳定性。
</Update>

<Update label="2025-08-19" tags={["agent-server"]} rss={{ title: "2025-08-19 - agent-server" }}>
  ## v0.2.135

  确保异步协程被正确等待，以防止潜在的运行时错误。
</Update>

<Update label="2025-08-18" tags={["agent-server"]} rss={{ title: "2025-08-18 - agent-server" }}>
  ## v0.2.134

  增强了搜索功能，通过允许用户选择特定列进行查询结果，提高了性能。
</Update>

<Update label="2025-08-18" tags={["agent-server"]} rss={{ title: "2025-08-18 - agent-server" }}>
  ## v0.2.133

  * 为定时任务、线程和助手添加了计数端点，以增强数据跟踪（#1132）。
  * 改进了 SSH 功能，以提高可靠性和稳定性。
  * 将 @langchain/langgraph-api 更新至版本 0.0.59，以修复无效状态模式问题。
</Update>

<Update label="2025-08-15" tags={["agent-server"]} rss={{ title: "2025-08-15 - agent-server" }}>
  ## v0.2.132

  * 添加了 Go 语言镜像以增强项目兼容性和功能。
  * 打印了 JS 工作器的内部 PID，以便通过 SIGUSR1 信号进行进程检查。
  * 解决了尝试插入重复运行时发生的 `run_pkey` 错误。
  * 添加了 `ty run` 命令，并切换为使用 uuid7 生成运行 ID。
  * 实现了初始 Golang 运行时以扩展语言支持。
</Update>

<Update label="2025-08-14" tags={["agent-server"]} rss={{ title: "2025-08-14 - agent-server" }}>
  ## v0.2.131

  在 JS 中添加了对带有描述的 `object agent spec` 的支持。
</Update>

<Update label="2025-08-13" tags={["agent-server"]} rss={{ title: "2025-08-13 - agent-server" }}>
  ## v0.2.130

  * 添加了功能标志（FF\_RICH\_THREADS=false）以在运行创建时禁用线程更新，减少锁争用并简化线程状态处理。
  * 为 `aput` 和 `apwrite` 操作使用现有连接，以提高性能。
  * 改进了解码问题的错误处理，以提高数据处理可靠性。
  * 从日志中排除了头，以提高安全性同时保持运行时功能。
  * 修复了阻止将槽映射到单个节点的错误。
  * 在 JS 部署中添加了调试日志以跟踪节点执行，以便更好地诊断问题。
  * 将默认多任务策略更改为入队，通过消除在新运行插入期间获取进行中运行的需要，提高了吞吐量。
  * 优化了 `Runs.next` 和 `Runs.sweep` 的数据库操作，以减少冗余查询并提高效率。
  * 通过跳过不必要的进行中运行查询，提高了运行创建速度。
</Update>

<Update label="2025-08-11" tags={["agent-server"]} rss={{ title: "2025-08-11 - agent-server" }}>
  ## v0.2.129

  * 停止将内部 LGP 字段传递给上下文，以防止破坏类型检查。
  * 暴露了 content-location 头，以确保 API 中正确的可恢复行为。
</Update>

<Update label="2025-08-08" tags={["agent-server"]} rss={{ title: "2025-08-08 - agent-server" }}>
  ## v0.2.128

  确保助手中的 `configurable` 和 `context` 同步更新，防止设置错误并支持更平滑的版本过渡。
</Update>

<Update label="2025-08-08" tags={["agent-server"]} rss={{ title: "2025-08-08 - agent-server" }}>
  ## v0.2.127

  从可恢复流中排除未请求的流模式，以优化功能。
</Update>

<Update label="2025-08-08" tags={["agent-server"]} rss={{ title: "2025-08-08 - agent-server" }}>
  ## v0.2.126

  * 使访问日志记录器头可配置，以增强日志灵活性。
  * 对 Runs.stats 函数进行了去抖动，以减少昂贵调用的频率并提高性能。
  * 为扫描器引入了去抖动，以提高性能和效率（#1147）。
  * 为 TTL 扫描获取了锁，以防止在扩展操作期间数据库被大量访问。
</Update>

<Update label="2025-08-06" tags={["agent-server"]} rss={{ title: "2025-08-06 - agent-server" }}>
  ## v0.2.125

  更新了跟踪上下文副本以使用新格式，确保兼容性。
</Update>

<Update label="2025-08-06" tags={["agent-server"]} rss={{ title: "2025-08-06 - agent-server" }}>
  ## v0.2.123

  为队列副本添加了入口点，以改进部署管理。
</Update>

<Update label="2025-08-06" tags={["agent-server"]} rss={{ title: "2025-08-06 - agent-server" }}>
  ## v0.2.122

  在 `join` 中使用持久化的中断状态，以确保在完成后正确处理用户的中断状态。
</Update>

<Update label="2025-08-06" tags={["agent-server"]} rss={{ title: "2025-08-06 - agent-server" }}>
  ## v0.2.121

  * 将事件合并到单个通道，以防止竞态条件并优化启动性能。
  * 确保在队列工作器上调用自定义生命周期，以便正确设置，并添加了测试。
</Update>

<Update label="2025-08-04" tags={["agent-server"]} rss={{ title: "2025-08-04 - agent-server" }}>
  ## v0.2.120

  * 恢复了运行的原始流行为，确保根据 `stream_mode` 设置一致地包含中断事件。
  * 优化了 `Runs.next` 查询，将平均执行时间从约 14.43ms 减少到约 2.42ms，提高了性能。
  * 添加了对流模式 "tasks" 和 "checkpoints" 的支持，标准化了 UI 命名空间，并升级了 `@langchain/langgraph-api` 以增强功能。
</Update>

<Update label="2025-07-31" tags={["agent-server"]} rss={{ title: "2025-07-31 - agent-server" }}>
  ## v0.2.117

  在线程上添加了复合索引，以便基于所有者的认证进行更快的搜索，并将默认排序顺序更新为 `updated_at`，以提高查询性能。
</Update>

<Update label="2025-07-31" tags={["agent-server"]} rss={{ title: "2025-07-31 - agent-server" }}>
  ## v0.2.116

  将默认历史检查点数量从 10 减少到 1，以优化性能。
</Update>

<Update label="2025-07-31" tags={["agent-server"]} rss={{ title: "2025-07-31 - agent-server" }}>
  ## v0.2.115

  优化了缓存重用，以提高应用程序性能和效率。
</Update>

<Update label="2025-07-30" tags={["agent-server"]} rss={{ title: "2025-07-30 - agent-server" }}>
  ## v0.2.113

  通过使用 `X-Pagination-Total` 和 `X-Pagination-Next` 更新响应头，改进了线程搜索分页，以实现更好的导航。
</Update>

<Update label="2025-07-30" tags={["agent-server"]} rss={{ title: "2025-07-30 - agent-server" }}>
  ## v0.2.112

  * 确保同步日志记录方法被等待，并添加了 linter 以防止将来发生。
  * 修复了 JavaScript 任务未为 JS 图正确填充的问题。
</Update>

<Update label="2025-07-29" tags={["agent-server"]} rss={{ title: "2025-07-29 - agent-server" }}>
  ## v0.2.111

  通过在连接打开时立即启动心跳，修复了 JS 图流失败的问题。
</Update>

<Update label="2025-07-29" tags={["agent-server"]} rss={{ title: "2025-07-29 - agent-server" }}>
  ## v0.2.110

  在保留流行为的同时，为加入操作添加了中断作为默认值。
</Update>

<Update label="2025-07-28" tags={["agent-server"]} rss={{ title: "2025-07-28 - agent-server" }}>
  ## v0.2.109

  修复了当未设置 `config_type` 时配置模式缺失的问题，确保更可靠的配置。
</Update>

<Update label="2025-07-28" tags={["agent-server"]} rss={{ title: "2025-07-28 - agent-server" }}>
  ## v0.2.108

  为 LangGraph v0.6 兼容性做好了准备，支持新的上下文 API 并修复了错误。
</Update>

<Update label="2025-07-27" tags={["agent-server"]} rss={{ title: "2025-07-27 - agent-server" }}>
  ## v0.2.107

  * 为认证过程实现了缓存，以提高性能和效率。
  * 通过合并计数和选择查询，优化了数据库性能。
</Update>

<Update label="2025-07-27" tags={["agent-server"]} rss={{ title: "2025-07-27 - agent-server" }}>
  ## v0.2.106

  使日志流可恢复，增强了重新连接时的可靠性和用户体验。
</Update>

<Update label="2025-07-27" tags={["agent-server"]} rss={{ title: "2025-07-27 - agent-server" }}>
  ## v0.2.105

  添加了堆转储端点，用于将内存堆信息保存到文件。
</Update>

<Update label="2025-07-25" tags={["agent-server"]} rss={{ title: "2025-07-25 - agent-server" }}>
  ## v0.2.103

  使用正确的元数据端点来解决数据检索问题。
</Update>

<Update label="2025-07-24" tags={["agent-server"]} rss={{ title: "2025-07-24 - agent-server" }}>
  ## v0.2.102

  * 在 wait 方法中捕获中断事件，以保留 langgraph 0.5.0 的先前行为。
  * 在 JavaScript 环境中添加了对 SDK structlog 的支持，以增强日志记录能力。
</Update>

<Update label="2025-07-24" tags={["agent-server"]} rss={{ title: "2025-07-24 - agent-server" }}>
  ## v0.2.101

  更正了自托管部署的元数据端点。
</Update>

<Update label="2025-07-22" tags={["agent-server"]} rss={{ title: "2025-07-22 - agent-server" }}>
  ## v0.2.99

  * 通过添加内存缓存和更有效地处理 Redis 连接错误，改进了许可证检查。
  * 重新加载了助手，以保留手动创建的助手，同时丢弃从配置文件中移除的助手。
  * 撤销了更改，以确保 gen UI 的 UI 命名空间是有效的 JavaScript 属性名称。
  * 确保生成 UI 的 UI 命名空间是有效的 JavaScript 属性名称，提高了 API 合规性。
  * 增强了错误处理，对无法处理的实体请求返回 422 状态码。
</Update>

<Update label="2025-07-19" tags={["agent-server"]} rss={{ title: "2025-07-19 - agent-server" }}>
  ## v0.2.98

  为 langgraph 节点添加了上下文，以改进日志过滤和跟踪可见性。
</Update>

<Update label="2025-07-19" tags={["agent-server"]} rss={{ title: "2025-07-19 - agent-server" }}>
  ## v0.2.97

  * 改进了与主循环上 ckpt 摄取工作器的互操作性，以防止任务调度问题。
  * 将队列工作器启动延迟到迁移完成之后，以防止过早执行。
  * 通过添加特定元数据和改进的响应代码，增强了线程状态错误处理，以便在创建期间状态更新失败时提供更好的清晰度。
  * 在检索线程状态时暴露了中断 ID，以提高 API 透明度。
</Update>

<Update label="2025-07-17" tags={["agent-server"]} rss={{ title: "2025-07-17 - agent-server" }}>
  ## v0.2.96

  为可配置头模式添加了回退机制，以更有效地处理排除/包含设置。
</Update>

<Update label="2025-07-17" tags={["agent-server"]} rss={{ title: "2025-07-17 - agent-server" }}>
  ## v0.2.95

  * 如果 future 已完成，则避免设置它，以防止冗余操作。
  * 通过将 `typing.TypedDict` 切换为 `typing_extensions.TypedDict`，解决了低于 3.12 的 Python 版本的 CI 兼容性错误。
</Update>

<Update label="2025-07-16" tags={["agent-server"]} rss={{ title: "2025-07-16 - agent-server" }}>
  ## v0.2.94

  * 通过省略 langgraph 版本 0.5 及更高版本的待处理发送，提高了性能。
  * 改进了服务器启动日志，以便在设置 DD\_API\_KEY 环境变量时提供更清晰的警告。
</Update>

<Update label="2025-07-16" tags={["agent-server"]} rss={{ title: "2025-07-16 - agent-server" }}>
  ## v0.2.93

  移除了运行元数据的 GIN 索引，以提高性能。
</Update>

<Update label="2025-07-16" tags={["agent-server"]} rss={{ title: "2025-07-16 - agent-server" }}>
  ## v0.2.92

  启用了 blob 和检查点的复制功能，提高了数据管理灵活性。
</Update>

<Update label="2025-07-16" tags={["agent-server"]} rss={{ title: "2025-07-16 - agent-server" }}>
  ## v0.2.91

  通过内联小值（null、数字、字符串等）减少了对 `checkpoint_blobs` 表的写入。这意味着我们不需要为未更新的通道存储额外的值。
</Update>

<Update label="2025-07-16" tags={["agent-server"]} rss={{ title: "2025-07-16 - agent-server" }}>
  ## v0.2.90

  通过节点本地后台队列改进了检查点写入。
</Update>

<Update label="2025-07-15" tags={["agent-server"]} rss={{ title: "2025-07-15 - agent-server" }}>
  ## v0.2.89

  通过移除外键，将检查点写入与线程/运行状态解耦，并更新了日志记录器以防止超时相关故障。
</Update>

<Update label="2025-07-14" tags={["agent-server"]} rss={{ title: "2025-07-14 - agent-server" }}>
  ## v0.2.88

  移除了 `run` 表中 `thread` 的外键约束，以简化数据库模式。
</Update>

<Update label="2025-07-14" tags={["agent-server"]} rss={{ title: "2025-07-14 - agent-server" }}>
  ## v0.2.87

  为 Redis 工作器信号添加了更详细的日志，以改进调试。
</Update>

<Update label="2025-07-11" tags={["agent-server"]} rss={{ title: "2025-07-11 - agent-server" }}>
  ## v0.2.86

  在 `/mcp` 端点中遵守工具描述，以符合预期功能。
</Update>

<Update label="2025-07-10" tags={["agent-server"]} rss={{ title: "2025-07-10 - agent-server" }}>
  ## v0.2.85

  为 `runs/wait` 添加了对 `on_disconnect` 字段的支持，并包含了断开连接日志以便于调试。
</Update>

<Update label="2025-07-09" tags={["agent-server"]} rss={{ title: "2025-07-09 - agent-server" }}>
  ## v0.2.84

  移除了不必要的状态更新以简化线程处理，并将版本更新为 0.2.84。
</Update>

<Update label="2025-07-09" tags={["agent-server"]} rss={{ title: "2025-07-09 - agent-server" }}>
  ## v0.2.83

  * 将可恢复流的默认生存时间减少到 2 分钟。
  * 增强了数据提交逻辑，根据许可证配置将数据发送到 Beacon 和 LangSmith 实例。
  * 当配置了端点时，启用了将自托管数据提交到 LangSmith 实例。
</Update>

<Update label="2025-07-03" tags={["agent-server"]} rss={{ title: "2025-07-03 - agent-server" }}>
  ## v0.2.82

  通过使用 join 实现锁，解决了后台运行中的竞态条件，确保跨 CTE 的可靠执行。
</Update>

<Update label="2025-07-03" tags={["agent-server"]} rss={{ title: "2025-07-03 - agent-server" }}>
  ## v0.2.81

  通过减少初始等待时间优化了运行流，以提高对较旧或不存在运行的响应能力。
</Update>

<Update label="2025-07-03" tags={["agent-server"]} rss={{ title: "2025-07-03 - agent-server" }}>
  ## v0.2.80

  更正了 `logger.ainfo()` API 调用中的参数传递，以解决 TypeError。
</Update>

<Update label="2025-07-02" tags={["agent-server"]} rss={{ title: "2025-07-02 - agent-server" }}>
  ## v0.2.79

  * 通过更正 JSON 序列化以正确处理尾部斜杠，修复了远程图检查点中的 JsonDecodeError。
  * 引入了一个配置标志，以在所有路由中全局禁用网络钩子。
</Update>

<Update label="2025-07-02" tags={["agent-server"]} rss={{ title: "2025-07-02 - agent-server" }}>
  ## v0.2.78

  * 为网络钩子调用添加了超时重试，以提高可靠性。
  * 添加了 HTTP 请求指标，包括请求计数和延迟直方图，以增强监控能力。
</Update>

<Update label="2025-07-02" tags={["agent-server"]} rss={{ title: "2025-07-02 - agent-server" }}>
  ## v0.2.77

  * 添加了 HTTP 指标以改进性能监控。
  * 更改了 Redis 缓存分隔符，以减少与子图消息名称的冲突，并更新了缓存行为。
</Update>

<Update label="2025-07-01" tags={["agent-server"]} rss={{ title: "2025-07-01 - agent-server" }}>
  ## v0.2.76

  更新了 Redis 缓存分隔符，以防止与子图消息冲突。
</Update>

<Update label="2025-06-30" tags={["agent-server"]} rss={{ title: "2025-06-30 - agent-server" }}>
  ## v0.2.74

  在隔离的循环中调度网络钩子，以确保线程安全操作并防止 PYTHONASYNCIODEBUG=1 时出错。
</Update>

<Update label="2025-06-27" tags={["agent-server"]} rss={{ title: "2025-06-27 - agent-server" }}>
  ## v0.2.73

  * 修复了无限帧循环问题，并由于 structlog 的意外行为移除了 dict\_parser。
  * 在运行取消期间发生死锁时抛出 409 错误，以优雅地处理锁冲突。
</Update>

<Update label="2025-06-27" tags={["agent-server"]} rss={{ title: "2025-06-27 - agent-server" }}>
  ## v0.2.72

  * 确保与未来的 langgraph 版本兼容。
  * 实现了 409 响应状态，以处理取消期间的死锁问题。
</Update>

<Update label="2025-06-26" tags={["agent-server"]} rss={{ title: "2025-06-26 - agent-server" }}>
  ## v0.2.71

  改进了日志记录，以提高日志类型的清晰度和详细程度。
</Update>

<Update label="2025-06-26" tags={["agent-server"]} rss={{ title: "2025-06-26 - agent-server" }}>
  ## v0.2.70

  改进了错误处理，以更好地区分和记录由用户引起的 TimeoutErrors 与内部运行超时。
</Update>

<Update label="2025-06-26" tags={["agent-server"]} rss={{ title: "2025-06-26 - agent-server" }}>
  ## v0.2.69

  为定时任务 API 添加了排序和分页，并更新了模式定义以提高准确性。
</Update>

<Update label="2025-06-26" tags={["agent-server"]} rss={{ title: "2025-06-26 - agent-server" }}>
  ## v0.2.66

  修复了使用 `on_not_exist="create"` 创建具有相同 thread\_id 的多个运行时出现的 404 错误。
</Update>

<Update label="2025-06-25" tags={["agent-server"]} rss={{ title: "2025-06-25 - agent-server" }}>
  ## v0.2.65

  * 确保仅在必要时返回 `assistant_versions` 中的字段。
  * 确保内存和 PostgreSQL 用户的数据类型一致，改进了内部认证处理。
</Update>

<Update label="2025-06-24" tags={["agent-server"]} rss={{ title: "2025-06-24 - agent-server" }}>
  ## v0.2.64

  为版本条目添加了描述，以提高清晰度。
</Update>

<Update label="2025-06-23" tags={["agent-server"]} rss={{ title: "2025-06-23 - agent-server" }}>
  ## v0.2.62

  * 改进了 JS Studio 中自定义认证的用户处理。
  * 在指标端点中添加了 Prometheus 格式的运行统计信息，以便更好地监控。
  * 在指标端点中添加了 Prometheus 格式的运行统计信息。
</Update>

<Update label="2025-06-20" tags={["agent-server"]} rss={{ title: "2025-06-20 - agent-server" }}>
  ## v0.2.61

  为 Redis 连接设置了最大空闲时间，以防止不必要的打开连接。
</Update>

<Update label="2025-06-20" tags={["agent-server"]} rss={{ title: "2025-06-20 - agent-server" }}>
  ## v0.2.60

  * 增强了错误日志记录，以包含字典操作的回溯详细信息。
  * 添加了 `/metrics` 端点，以暴露队列工作器指标用于监控。
</Update>

<Update label="2025-06-18" tags={["agent-server"]} rss={{ title: "2025-06-18 - agent-server" }}>
  ## v0.2.57

  * 从可重试异常中移除了 CancelledError，以允许本地中断，同时保持工作器的可重试性。
  * 引入了中间件，以便在收到 SIGINT 后，在完成进行中的请求后优雅地关闭服务器。
  * 减少了存储在检查点中的元数据，仅包含必要的信息。
  * 改进了加入运行中的错误处理，以便在存在错误时返回错误详细信息。
</Update>

<Update label="2025-06-17" tags={["agent-server"]} rss={{ title: "2025-06-17 - agent-server" }}>
  ## v0.2.56

  通过添加 SIGTERM 信号的处理程序，提高了应用程序稳定性。
</Update>

<Update label="2025-06-17" tags={["agent-server"]} rss={{ title: "2025-06-17 - agent-server" }}>
  ## v0.2.55

  * 改进了队列入口点中的取消处理。
  * 改进了队列入口点中的取消处理。
</Update>

<Update label="2025-06-16" tags={["agent-server"]} rss={{ title: "2025-06-16 - agent-server" }}>
  ## v0.2.54

  * 增强了许可证验证期间 LuaLock 超时的错误消息。
  * 通过要求显式 ::text 转换修复了自定义认证中的 \$contains 过滤器，并相应地更新了测试。
  * 确保项目和租户 ID 格式化为 UUID，以保持一致性。
</Update>

<Update label="2025-06-13" tags={["agent-server"]} rss={{ title: "2025-06-13 - agent-server" }}>
  ## v0.2.53

  * 解决了时序问题，确保队列仅在图注册后启动。
  * 通过在单个查询中设置线程和运行状态，提高了性能，并改进了检查点写入期间的错误处理。
  * 将默认后台宽限期减少到 3 分钟。
</Update>

<Update label="2025-06-12" tags={["agent-server"]} rss={{ title: "2025-06-12 - agent-server" }}>
  ## v0.2.52

  * 现在当省略一个图时记录预期的图，以提高可追溯性。
  * 为可恢复流实现了生存时间（TTL）功能。
  * 通过添加唯一索引并优化行锁定，提高了查询效率和一致性。
</Update>

<Update label="2025-06-12" tags={["agent-server"]} rss={{ title: "2025-06-12 - agent-server" }}>
  ## v0.2.51

  * 通过将任务标记为准备重试来处理 `CancelledError`，改进了工作器进程中的错误管理。
  * 在元数据和日志中添加了 LG API 版本和请求 ID，以便更好地跟踪。
  * 在元数据和日志中添加了 LG API 版本和请求 ID，以提高可追溯性。
  * 通过并发创建索引，提高了数据库性能。
  * 确保仅在设置 Redis 运行标记后才提交 postgres 写入，以防止竞态条件。
  * 通过添加 thread\_id/running 上的唯一索引、优化行锁并确保确定性运行选择，提高了查询效率和可靠性。
  * 通过确保仅在设置 Redis 运行标记后才进行 Postgres 更新，解决了竞态条件。
</Update>

<Update label="2025-06-07" tags={["agent-server"]} rss={{ title: "2025-06-07 - agent-server" }}>
  ## v0.2.46

  在 Threads 状态 `update()` 和 `bulk()` 命令中保留事务特性，同时为每个操作引入新连接。
</Update>

<Update label="2025-06-05" tags={["agent-server"]} rss={{ title: "2025-06-05 - agent-server" }}>
  ## v0.2.45

  * 通过包含跟踪上下文增强了流功能。
  * 从 Crons.search 函数中移除了不必要的查询。
  * 解决了为多个定时任务调度下一次运行时的连接重用问题。
  * 从 Crons.search 函数中移除了不必要的查询，以提高效率。
  * 通过改进连接重用，解决了调度下一次定时任务运行的问题。
</Update>

<Update label="2025-06-04" tags={["agent-server"]} rss={{ title: "2025-06-04 - agent-server" }}>
  ## v0.2.44

  * 增强了工作器逻辑，以便在达到 Redis 消息限制时退出管道并继续。
  * 为 Redis 消息大小引入了上限，并提供了跳过大于 128 MB 消息的选项，以提高性能。
  * 确保管道始终正确关闭，以防止资源泄漏。
</Update>

<Update label="2025-06-04" tags={["agent-server"]} rss={{ title: "2025-06-04 - agent-server" }}>
  ## v0.2.43

  * 通过省略元数据调用中的日志并确保值流中的输出模式合规性，提高了性能。
  * 确保连接在使用后正确关闭。
  * 使输出格式严格遵守指定的模式。
  * 停止在元数据请求中发送内部日志，以提高隐私性。
</Update>

<Update label="2025-06-04" tags={["agent-server"]} rss={{ title: "2025-06-04 - agent-server" }}>
  ## v0.2.42

  * 添加了时间戳以跟踪请求运行的开始和结束。
  * 在配置设置中添加了跟踪器信息。
  * 添加了对带有跟踪上下文的流的支持。
</Update>

<Update label="2025-06-03" tags={["agent-server"]} rss={{ title: "2025-06-03 - agent-server" }}>
  ## v0.2.41

  添加了锁定机制以防止管道执行中的错误。
</Update>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [连接这些文档](/use-these-docs) 到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/agent-server-changelog.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>