SuperAPI AI 工具集

autorag-query

智能体与模型

查看项目

更新于 10-16 07:23

技能介绍

用途:AutoRAG-Query 是 AutoRAG-Research 的智能体技能,用于用自然语言查询 AutoRAG 流水线的评测结果,将问题转换为 SQL 并安全执行,返回表格、JSON 或 CSV。

主要能力:解析意图(查询指标、流水线或查询数据,执行排名、聚合或过滤);读取 references/schema.sql 了解表结构;生成 SQL;通过脚本执行并展示结果。关键表包括 pipeline、metric、query、executor_result、evaluation_result、summary、chunk_retrieved_result,通过 query_id、pipeline_id、metric_id、chunk_id 外键关联。

使用方式:执行 uv run python .agents/skills/autorag-query/scripts/query_executor.py --query "...",可选 --format json|csv|table、--timeout 10、--limit 10000、--database autorag_research。连接信息自动从 configs/db.yaml 或 POSTGRES_* 环境变量加载。

限制:仅允许 SELECT,脚本会拒绝 DDL/DML;必须排除 embedding、embeddings、bm25_tokens 等向量列,否则报类型错误;未指定时建议加 LIMIT 100;默认超时 10 秒,慢查询需加 WHERE 过滤。JSONB 字段用 token_usage->>'field' 取文本,或 (token_usage->>'field')::int 转整数。

适用场景:对流水线指标排名、统计 token 用量、查看检索结果等分析任务。安装后从 .agents/skills/autorag-query/ 自动被智能体识别。