图纸检索输入与模式¶
字段 |
JSON类型/表单值 |
必填 |
说明 |
|---|---|---|---|
knowledge_base_id |
integer / 十进制文本 |
是 |
正整数知识库ID。 |
drawing_number |
string |
条件 |
业务图号;非空时优先精确查询,不再做query或图片相似召回。 |
query |
string |
条件 |
文字查询;与file可组合。仅在没有drawing_number时走语义多通道。 |
file |
multipart文件 |
条件 |
图片二进制,JSON不支持此字段;不是已上传file_id或query_image_file_id。 |
top_k |
integer / 十进制文本 |
否 |
省略/0默认8,语义最多50,负数拒绝。精确版本查询不按top_k截断。 |
drawing_number、query、file至少有一种。JSON仅接受knowledge_base_id/query/drawing_number/top_k,未知字段拒绝;multipart使用file字段。首尾空白会修剪,图号还按共享业务图号规则规范化。图号无法规范化/没有精确匹配时返回空exact,不自动回退相似结果;图号和图片同时给时,请求边界仍可能校验图片/限额,不能据精确优先绕过上传检查。
请求体上限33MiB,图片文件不超过32MiB且必须非空、内容识别为image/*。单文件过大与整体请求过大可能映射不同错误;32MiB不是保证可执行嵌入的大小。图片转换为data URI,超预算时可能压缩,仍受4MiB嵌入请求预算和实际模型/绑定预处理约束,失败返回ErrPayloadTooLarge;不会改为公网URL绕过限制。
语义分支在知识库授权来源范围内融合文件名/编号提示、文本和图片召回,按source_file_id聚合,一个best_hit和最多三个supporting_hits。overwrite_current知识库限定当前指针来源,keep_versions则允许所有仍发布的有效版本;历史缺drawing_current schema的库可回退索引检索,但图号精确查询缺当前索引会失败关闭。keep_versions图号查询可返回全部有效版本并用default_version标记当前指针,不把所有命中都当当前版本。
top_k不是分页大小,没有offset/cursor;count不是可继续翻页的总数。编号提示的identifier_route_used也不等于match_mode=exact。来源未解析、索引尚未可用与有效空库是不同结果,不把503当零命中。
JSON可选query/drawing_number为null时按空字符串处理,top_k=null也用默认值,仍须满足至少一种查询条件。表单文本null不是JSON空值。