Skip to main content
一旦您创建了导出任务，就可以使用本页介绍的 API 来跟踪其进度、检查单个运行，并在需要时停止它。本页还介绍了 LangSmith 如何自动处理故障，以及当导出任务在重试耗尽后失败时该如何处理。 本页内容涵盖：
针对自托管和欧盟区域部署对于自托管安装或位于欧盟区域的组织，请在以下请求中相应地更新 LangSmith URL。 对于欧盟区域，请使用 eu.api.smith.langchain.com。

​
监控导出状态

要监控导出任务的状态，请使用以下 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 测试您的目标配置。
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.