图纸检索输入与模式

字段

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空值。

最后更新于