查询
创建查询令牌
POST
/
knowledge-fs
/
spaces
/
{knowledge_base_id}
/
queries
/
admission
curl --request POST \
--url https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/queries/admission \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
}
'{
"expires_at": "2026-09-06T08:31:07Z",
"operation_id": "createQuery",
"request": {
"activeDocumentIds": [],
"activeEntityIds": [],
"knowledgeSpaceId": "8d2c6a1e-5b3f-4c7d-9e01-2a3b4c5d6e7f",
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
},
"token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Imtmcy0yMDI2LTA5In0.eyJpc3MiOiJkaWZ5LWNvbnRyb2wtcGxhbmUiLCJhdWQiOiJrbm93bGVkZ2UtZnMiLCJzdWIiOiJkaWZ5LWRhdGFzZXQtYXBpLWtleTo3YjRjOWUyMS0zZDVmLTRhNmItOGM3ZC05ZTBmMWEyYjNjNGQiLCJhY3Rpb24iOiJxdWVyaWVzLmNyZWF0ZSIsInRyYWNlX2lkIjoiM2YxZTlhN2MtMmI0ZC00ZTZmLThhOTAtMWIyYzNkNGU1ZjYwIiwiZXhwIjoxNzg4NjgzNDY3fQ.V2s9Rm5xR2ZUZ0J2M2Q5aW1KU3hqUXJsV1pKcGtnQUFCZUtGMQ",
"trace_id": "3f1e9a7c-2b4d-4e6f-8a90-1b2c3d4e5f60",
"url": "https://api.example.com/v1/knowledge-fs/query-stream"
}Authorizations
Path Parameters
知识库 ID：即知识库 API 访问 对话框中所示服务 API 端点的最后一段（…/knowledge-fs/spaces/<knowledge base ID>），也是地址栏中 /datasets/new/ 之后的那一段。
Body
application/json
包含未知字段时返回 400。
标记为 nullable 的可选字段，传 null 等同于省略。
需提供非空白的 query。
要查询的问题。不能为空白，且不超过 16,384 个 UTF-8 字节。
Maximum string length:
16000Pattern:
\S这些 ID 不会对检索到的内容进行筛选或排序。留空即可。
Maximum array length:
100这些 ID 不会对检索到的内容进行筛选或排序。留空即可。
Maximum array length:
100Response
查询令牌已签发。
令牌的过期时间，为 UTC 时区的 ISO 8601 时间戳。最晚为签发后 60 秒，部署方可缩短这一有效期。
始终为 createQuery，即该令牌适用的操作。调用方可忽略此字段。
Was this page helpful?
⌘I
curl --request POST \
--url https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/queries/admission \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
}
'{
"expires_at": "2026-09-06T08:31:07Z",
"operation_id": "createQuery",
"request": {
"activeDocumentIds": [],
"activeEntityIds": [],
"knowledgeSpaceId": "8d2c6a1e-5b3f-4c7d-9e01-2a3b4c5d6e7f",
"mode": "fast",
"query": "What changed in the refund policy this quarter?"
},
"token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Imtmcy0yMDI2LTA5In0.eyJpc3MiOiJkaWZ5LWNvbnRyb2wtcGxhbmUiLCJhdWQiOiJrbm93bGVkZ2UtZnMiLCJzdWIiOiJkaWZ5LWRhdGFzZXQtYXBpLWtleTo3YjRjOWUyMS0zZDVmLTRhNmItOGM3ZC05ZTBmMWEyYjNjNGQiLCJhY3Rpb24iOiJxdWVyaWVzLmNyZWF0ZSIsInRyYWNlX2lkIjoiM2YxZTlhN2MtMmI0ZC00ZTZmLThhOTAtMWIyYzNkNGU1ZjYwIiwiZXhwIjoxNzg4NjgzNDY3fQ.V2s9Rm5xR2ZUZ0J2M2Q5aW1KU3hqUXJsV1pKcGtnQUFCZUtGMQ",
"trace_id": "3f1e9a7c-2b4d-4e6f-8a90-1b2c3d4e5f60",
"url": "https://api.example.com/v1/knowledge-fs/query-stream"
}