用途:这是一个通过 Supabase 边缘函数 sci_search 对科学期刊分块执行混合检索的技能,适合需要按主题检索期刊内容、并按期刊或日期范围筛选取回结果的场景。
主要能力:请求体为 JSON,包含 query(必填),以及可选的 topK、extK、filter、datefilter、getMeta。topK 控制返回条数;extK 会为每个命中分块向前后扩展相邻分块并合并上下文;filter 用于限定期刊范围;datefilter 使用 UNIX 秒级时间边界限定日期;getMeta 用于返回元数据。返回 200 时数据结构为 { "data": [...] },可能为空数组;缺少 query 返回 400;后端错误返回 500。
使用方式:先准备 JSON 输入,可参考 assets/example-request.json 作为基础载荷。设置环境变量 TIANGONG_AI_APIKEY,请求头需包含 Content-Type: application/json、x-region: us-east-1 与 x-api-key: <TIANGONG_AI_APIKEY>。端点:https://qyyqlnwqwgvzxnccnbgm.supabase.co/functions/v1/sci_search。示例命令:curl -sS --location --request POST "https://qyyqlnwqwgvzxnccnbgm.supabase.co/functions/v1/sci_search" --header 'Content-Type: application/json' --header 'x-region: us-east-1' --header "x-api-key: $TIANGONG_AI_APIKEY" --data @assets/example-request.json
限制与排查:资料未说明检索算法细节、配额、计费与速率限制。若返回未授权,检查 TIANGONG_AI_APIKEY 与 x-api-key;若过滤结果异常,确认期刊名称与 UNIX 秒边界是否正确;若出现 500,应按后端故障处理并查看 Supabase 函数日志。参考文档包括 references/env.md、references/request-response.md、references/testing.md。