GetLumaDocument - 查询 Luma 绑定的文档详情 - 事件总线EventBridge

接口说明

获取 Luma Agent 绑定的知识库中指定文档的详细信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
AgentName	string	是	Agent 名称	my_agent
Catalog	string	是	Agent 已绑定的数据目录名称。可通过 ListLumaCatalogs 获取	my_catalog
Namespace	string	是	Agent 已绑定的命名空间名称。可通过 ListLumaNamespaces 获取	my_namespace
KnowledgeBaseName	string	是	Agent 已绑定的知识库名称。可通过 ListLumaKnowledgeBases 获取	my-knowledge-base
DocumentId	string	是	文档的唯一标识。可通过 ListLumaDocuments 获取	doc-a1b2c3d4

返回参数

名称	类型	描述	示例值
	object
Message	string	接口返回的提示信息，成功时为 Operation success，失败时为具体错误描述	Operation success
RequestId	string	本次请求的唯一标识，用于问题排查与工单反馈	34AD682D-5B91-5773-8132-AA38C130****
Data	KnowledgeBaseDocument	文档详情，包含处理状态与元数据
Code	string	接口返回码，Success 表示成功，失败时为具体错误码	Success
Success	boolean	本次调用是否成功，true 表示成功	true

示例

正常返回示例

JSON格式

{
  "Message": "Operation success",
  "RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
  "Data": {
    "ChunkConfiguration": {
      "HeadingLevel": 2,
      "MaxChunkSize": 600,
      "OverlapSize": 40,
      "PreprocessRules": {
        "RemoveUrlsAndEmails": false,
        "ReplaceConsecutiveWhitespace": true
      },
      "Separator": "\\\\n\\\\n",
      "Strategy": "BY_SEPARATOR"
    },
    "ChunkCount": 120,
    "CreatedAt": "2026-08-24T10:00:00Z",
    "DocumentId": "doc-bp1xxxxxxxxxxxx",
    "ErrorCode": "FILE_CORRUPTED",
    "ErrorMessage": "parse pdf failed",
    "FileName": "manual.pdf",
    "FileSize": 1048576,
    "Metadata": [
      {
        "Key": "department",
        "Value": "研发"
      }
    ],
    "SourceModifiedTime": 1788000000000,
    "SourceType": "UPLOAD",
    "SourceUri": "oss://my-bucket/docs/handbook.pdf",
    "Status": "COMPLETED",
    "UpdatedAt": "2026-08-24T10:00:00Z"
  },
  "Code": "Success",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息
400	InvalidParameter	The specified parameter is invalid
403	ServiceNotEnable	Service not enable
404	AgentNotFound	Agent not found
404	ResourceNotFound	The specified resource is not bound to the agent

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。