---
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

---

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