---
title: "获取知识文档解析的 Span 树（含历史尝试）"
method: GET
path: "/api/v1/knowledge/{id}/spans"
tags: ["知识管理"]
---

# 获取知识文档解析的 Span 树（含历史尝试）

`GET /api/v1/knowledge/{id}/spans`

返回该知识在解析流水线的 trace tree（root → stage → subspan）：每段状态、耗时、input/output、错误码、langfuse_trace_id。支持 ?attempt=N 查看历史尝试；不传则返回最新尝试。前端用于渲染时间线 + 多模态/embedding 子节点 + 一键跳转 Langfuse。

## Path parameters

- `id` string, required

## Query parameters

- `attempt` integer

## Response `200`

OK

- object

## Changes

- **2026-06-05** `e7c0c953963b` — 1 info
  - endpoint added
- **2025-12-16** `edf61e68559d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/api/v1/knowledge/:id/spans/get.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/ef2e057b249e/schema)