Skip to main content
一旦您创建了导出任务，就可以使用本页上的 API 来跟踪其进度、检查单个运行，并在需要时停止它。本页还介绍了 LangSmith 如何自动处理故障，以及在导出因重试次数耗尽而失败后应采取的措施。 本页涵盖：
适用于自托管、欧盟 (GCP) 和美国 (AWS) SaaS 版本对于自托管安装、欧盟 (GCP) (eu.api.smith.langchain.com) 或美国 (AWS) (aws.api.smith.langchain.com)，请更新以下请求中的 LangSmith URL。

​
监控导出状态

要监控导出任务的状态，请使用以下 cURL 命令： 
curl --request GET \
  --url 'https://api.smith.langchain.com/api/v1/bulk-exports/{export_id}' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant-Id: YOUR_WORKSPACE_ID'
将 {export_id} 替换为您要监控的导出的 ID。此命令检索指定导出任务的当前状态。

​
列出导出的运行记录

一个导出通常被分解为多个运行，每个运行对应要导出的特定日期分区。 要列出与特定导出关联的所有运行，请使用以下 cURL 命令： 
curl --request GET \
  --url 'https://api.smith.langchain.com/api/v1/bulk-exports/{export_id}/runs' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant-Id: YOUR_WORKSPACE_ID'
此命令获取与指定导出相关的所有运行，提供运行 ID、状态、创建时间、导出行数等详细信息。

​
列出所有导出

要检索所有导出任务的列表，请使用以下 cURL 命令： 
curl --request GET \
  --url 'https://api.smith.langchain.com/api/v1/bulk-exports' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant-Id: YOUR_WORKSPACE_ID'
此命令返回所有导出任务的列表及其当前状态和创建时间戳。

​
停止导出

要停止现有的导出，请使用以下 cURL 命令： 
curl --request PATCH \
  --url 'https://api.smith.langchain.com/api/v1/bulk-exports/{export_id}' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'X-Tenant-Id: YOUR_WORKSPACE_ID' \
  --data '{
    "status": "Cancelled"
}'
将 {export_id} 替换为您希望取消的导出的 ID。请注意，任务一旦取消就无法重新启动， 您需要创建一个新的导出任务。

​
故障模式和重试策略

LangSmith 批量导出会自动处理瞬时故障和基础设施问题，以确保弹性。 每个批量导出被划分为多个 运行，每个运行处理特定日期分区（通常按天组织）的数据。运行是独立处理的，这使得：
  • 可以并行处理不同的时间段。
  • 每个运行都有独立的重试逻辑。
  • 如果中断，可以从特定检查点恢复。
导出中的每个运行（日期范围）都有自己的故障处理和重试预算。如果一个运行在耗尽所有重试后失败，整个导出将被标记为 FAILED。

​
自动重试行为

导出任务会自动重试瞬时故障，行为如下：
  • 最大重试次数：每个运行最多重试 20 次（可能会更改）。
  • 重试延迟：每次尝试间隔 30 秒（固定，无指数退避）。
  • 运行超时：每个运行最长 4 小时。
  • 整个工作流超时：整个导出最长 72 小时。

​
故障场景

故障类型原因自动重试？所需操作
基础设施中断部署、服务器重启、工作进程崩溃是，自动重新排队并保留剩余重试次数。无需操作，任务自动恢复。
运行超时单个运行超过 4 小时限制是，最多重试 20 次（可能会更改）。如果持续发生，请缩小日期范围、添加过滤器或限制导出字段。
工作流超时整个导出超过 72 小时否减少导出范围（日期范围、过滤器）或拆分为更小的导出。
存储/目标错误无效凭据、存储桶缺失、权限问题否修复目标配置并创建新的导出。
目标已删除导出期间存储桶被移除否重新创建目标并重新启动导出。
终端处理错误数据序列化问题、资源耗尽是，最多重试 20 次（可能会更改）。检查运行错误详情；可能需要调查。
任何单个运行失败（在所有重试耗尽后）都会导致整个导出失败。

​
导出状态生命周期

导出可以具有以下状态：
状态描述
CREATED导出已创建但尚未开始处理。
RUNNING导出正在积极处理运行。
COMPLETED所有运行成功导出。
FAILED一个或多个运行在重试耗尽后失败。
CANCELLED导出被用户手动取消。
TIMEDOUT导出超过 48 小时的工作流超时。
单个运行也可以具有相同的状态：CREATED、RUNNING、COMPLETED、FAILED、CANCELLED 或 TIMEDOUT。

​
并发和速率限制

为确保系统稳定性，导出受以下限制：
  • 每个导出的最大并发运行数：45
  • 每个工作区的最大并发导出数：15
如果您有多个导出正在运行，新的运行任务将排队等待，直到有可用容量。

​
进度跟踪和可恢复性

导出系统为每个运行维护详细的进度元数据：
  • 数据流中的最新游标位置。
  • 已导出的行数。
  • 已写入的 Parquet 文件列表。
此进度跟踪支持：
  • 优雅恢复：如果运行中断（例如，由于部署），它将从最后一个检查点恢复，而不是重新开始。
  • 进度监控：通过 API 跟踪已导出的数据量。
  • 高效重试：失败的运行不会重新导出已成功写入的数据。

​
故障排除失败的导出

如果您的导出失败，请按照以下步骤操作：
  1. 检查导出状态：使用 GET /api/v1/bulk-exports/{export_id} 端点 检索导出详情和状态。
  2. 查看运行错误：您可以使用列出运行 API 监控您的运行。每个运行包含一个 errors 字段，其中包含按重试尝试（例如 retry_0、retry_1）键控的详细错误消息。
  3. 验证目标访问权限：确保您的目标存储桶仍然存在且凭据有效。
  4. 检查运行大小：如果您看到超时错误，您的日期分区可能包含太多数据。限制导出字段可能会有所帮助。
  5. 查看系统限制：确保您没有达到并发限制（每个导出 5 个运行，每个工作区 3 个导出）。
对于存储相关错误，您可以在重试导出之前使用 AWS CLI 或 gsutil 测试您的目标配置。
将这些文档连接到 Claude、VSCode 等，通过 MCP 获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。