SuperAPI AI 工具集

tiangong-kb-sci-search

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:该技能只做单一来源的 SCI 检索,不扩展到 all、report 或 patent。访问需要部署方正常密钥与授权;遇到认证、授权、订阅、VPN 或服务失败即停止,不尝试绕过。

执行模式:在受管工作区之外做独立检索时,使用 scripts/sci_search.sh。在受管工作区内,只有用户明确请求的隔离查询才可设 execution_mode 为 standalone,包装脚本会记录非机密模式事件。在天工自动研究发现包内,不要执行该脚本或其 CLI/curl 示例,应通过 fetch_candidate_source 使用锁定能力 ID database.tiangong.sci-search,由 broker 负责 POST 方法、端点、区域头、凭据注入、响应边界、清洗与永久证据回执。

前置条件:独立包装脚本默认使用单独测试的 CLI 0.0.30,这不是自动研究工作区运行时;受管研究从不可变 setup plan 或 runtime-lock.json 解析确切版本并使用 broker。仅在有意覆盖独立入口时,将 TIANGONG_AI_CLI_BIN 设为一个确切可执行路径,或将 TIANGONG_AI_CLI 设为经明确审查的命令。来源专用密钥放入 TIANGONG_SCI_APIKEY,或用 TIANGONG_AI_APIKEY 作为通用回退。凭据不得出现在包装 JSON、请求文件或 CLI 参数中。需要 jq。可选端点变量包括 TIANGONG_SCI_SEARCH_URL、TIANGONG_RESEARCH_API_BASE_URL、TIANGONG_AI_SEARCH_API_BASE_URL、TIANGONG_AI_API_BASE_URL,另支持 TIANGONG_REGION 与 TIANGONG_RESEARCH_TIMEOUT。

直接查询:设置密钥后运行 ./scripts/sci_search.sh '{"query":"...","top_k":5,"get_meta":true}'。包装脚本调用固定 CLI 等价命令 npx --yes @tiangong-ai/cli@0.0.30 research search --query <query> --sources sci --json。写入结果时把显式输出路径作为第二个参数;包装脚本先写唯一临时文件,仅在 CLI 成功退出后重命名,不凭文件存在判定成功。

请求载荷:内联支持的边缘函数字段会转为临时请求文件,如 query、filter(元数据词数组)、datefilter(数值 gte/lte)、topK、extK、getMeta;也可用 request_file 引用已存在的常规非符号链接 JSON 文件。top_k、ext_k、get_meta 是查询模式便捷名。

可选 dotenv:显式 env_file 必须存在、为常规非符号链接文件且仅属主可读(chmod 600)。若提供 request_file 而未显式指定 env 文件,仅当同目录 .env 存在且通过同样检查时才加载;已有进程变量优先。解析器不执行 shell 语法,只加载文档化的天工密钥、端点、区域与超时名称,其他键忽略。切勿在此文件放入代理密钥、浏览器 cookie、Authorization 头、会话令牌、代理密码或无关机密。

接受的包装字段:query/input/claim;request_file/input_file;env_file;execution_mode(仅 standalone,且受管工作区检测到后需明确隔离查询请求);filter、datefilter、topK、extK、getMeta;查询模式下的 top_k、ext_k、get_meta;sources(仅 sci 或默认);api_base_url、sci_url、region、timeout 作为非机密路由值;dry_run。任何看似 API 密钥、令牌、Authorization、Cookie、密码、凭据、secret 或 session 的键会在 CLI 启动前被递归拒绝,包装脚本不回显被拒值或失败命令的 stdout。

自动研究 broker 调用:研究设置选定并配置该技能后,发现阶段使用 capability_id database.tiangong.sci-search、确切 manifest 端点与 request_body(如 query、topK、getMeta)。只使用文档化的非机密请求字段,切勿把 API 密钥、头、cookie、端点覆盖或令牌加入 request_body。broker 将逻辑 tiangong.sci.api-key 注入为 x-api-key,发送锁定 x-region,拒绝 POST 重定向,并只在永久原始响应对象之外记录请求体 SHA-256。该数据库补充但不替代自动研究独立的公共互联网证据要求。

限制:仅 SCI 来源;需授权与密钥;受管工作区与自动研究发现包内不得直接执行脚本;凭据处理有严格限制;其他功能与收费信息暂未提供。