agentic-search 是一个面向“有来源支撑”的网络深度研究技能,以 Grok 为主力,可按需补充 Tavily、Firecrawl 等来源。资料未提供开发者、版本、收费与平台信息。
用途:适合需要当前网络研究、带引用答案、补充抓取或站点枚举的任务。
主要能力(由六个脚本提供):agentic_search.py 研究主题并给出带引用的 AI 推理答案;agentic_fetch.py 把整页转为 Markdown,不做摘要;agentic_map.py 枚举站点下的 URL(仅用 Tavily);agentic_extract.py 从 URL 提取逐字标题与 2–4 条引语;agentic_rank.py 按细化查询对会话来源重排;agentic_get_sources.py 获取或列出缓存会话。
使用方式:脚本使用 PEP 723 内联依赖,需通过 uv run 调用,每次调用最多等待 3 分钟。示例:uv run scripts/agentic_search.py --query "..." [--extra-sources N] [--auto-fetch-top N] [--platform "..."];uv run scripts/agentic_fetch.py --url "..." [--engine auto|tavily|firecrawl|grok];uv run scripts/agentic_map.py --url "..." [--instructions "..."] [--limit N];uv run scripts/agentic_extract.py --url "..." [--session-id S];uv run scripts/agentic_rank.py --query "..." --session-id S;uv run scripts/agentic_get_sources.py --list | --session-id S。
会话工作流:agentic_search 生成并持久化 session_id,作为组合步骤的纽带,可用于重排(会原地修改会话)、追加逐字引语、查看完整会话。会话在多次调用间保留,但 OS 重启后可能被清除。
操作规范:组合非平凡查询前先加载对应参考文档,不要一次加载全部四份,包括 search-discipline.md(两遍方法论、引用契约、时间上下文启发式)、fetch-fidelity.md(引擎取舍、保真保证、何时不抓取)、extract-and-rank.md(extract 与 fetch 区别、何时重排、会话组合模式)、provider-quirks.md(环境变量、提供方 schema、重试策略、调试)。
限制与失败模式:缺少 GROK_API_KEY / GROK_API_URL 时所有用 Grok 的脚本报配置错误;agentic_fetch --engine auto 完全失败时改用 --engine grok 或退回内置 WebFetch;agentic_map 无 TAVILY_API_KEY 会直接退出;agentic_rank 会话过期需重跑 agentic_search;sources_count: 0 但内容非空说明 Grok 使用了训练数据,可查 providers_used(grok-web-search 为真实引用,grok 为启发式回退)。更多细节需参考对应文档。