获取 Luma Agent 绑定的指定知识库的详细信息,包含向量模型、切分配置与检索配置。
接口说明
获取 Luma Agent 绑定的指定知识库的详细信息,包含向量模型、切分配置与检索配置。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| AgentName |
string |
是 |
Agent 名称 |
my_agent |
| Catalog |
string |
是 |
Agent 已绑定的数据目录名称。可通过 ListLumaCatalogs 获取 |
my_catalog |
| Namespace |
string |
是 |
Agent 已绑定的命名空间名称。可通过 ListLumaNamespaces 获取 |
my_namespace |
| KnowledgeBaseName |
string |
是 |
Agent 已绑定的知识库名称。可通过 ListLumaKnowledgeBases 获取 |
my-knowledge-base |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Message |
string |
接口返回的提示信息,成功时为 Operation success,失败时为具体错误描述 |
Operation success |
| RequestId |
string |
本次请求的唯一标识,用于问题排查与工单反馈 |
34AD682D-5B91-5773-8132-AA38C130**** |
| Data | KnowledgeBase |
Agent 绑定的知识库详情 |
|
| Code |
string |
接口返回码,Success 表示成功,失败时为具体错误码 |
Success |
| Success |
boolean |
本次调用是否成功,true 表示成功 |
true |
示例
正常返回示例
JSON格式
{
"Message": "Operation success",
"RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
"Data": {
"Catalog": "my_catalog",
"ChunkConfiguration": {
"HeadingLevel": 2,
"MaxChunkSize": 600,
"OverlapSize": 40,
"PreprocessRules": {
"RemoveUrlsAndEmails": false,
"ReplaceConsecutiveWhitespace": true
},
"Separator": "\\\\n\\\\n",
"Strategy": "BY_SEPARATOR"
},
"CreatedAt": "2026-08-24T10:00:00Z",
"Description": "产品文档知识库",
"EmbeddingDimension": 1024,
"EmbeddingModel": "text-embedding-v4",
"FailureReason": "OssException: BucketAlreadyExists ...",
"KnowledgeBaseName": "product-docs",
"MetadataSchema": [
{
"Name": "department",
"Type": "STRING",
"Value": "EventHouse",
"ValueMode": "CONSTANT"
}
],
"Namespace": "my_namespace",
"SearchConfiguration": {
"Mode": "HYBRID",
"RankAlgorithm": "RRF",
"RerankEnabled": false,
"RerankModel": "qwen3-rerank",
"RrfK": 60,
"TopK": 20,
"VectorWeight": 0.7
},
"Status": "ACTIVE",
"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 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。