# 塔维利网络技能 ## 触发条件和端点选择根据用户意图选择 Tavily 端点： * **搜索** ：需要“搜索网页/最新信息/查找来源/查找链接” * **提取** ：给定 URL，需要提取/总结内容 * **爬行** ：需要按照说明遍历站点并抓取页面内容 * **地图** ：需要发现网站页面列表/结构（仅没有完整内容或元数据） * **研究** ：需要按照给定的“output_schema”进行结构化研究输出 ## 推荐架构（主技能+副技能）该技能使用两阶段架构： 1. **主要技能（当前上下文）**：理解用户问题→选择端点→组装JSON负载 2. **子技能（fork context）** ：只负责HTTP调用执行，避免会话历史token浪费 ## 技能路径解析在运行命令之前解析 `TAVILY_WEB_SKILL_DIR`：如果 [ -z "${TAVILY_WEB_SKILL_DIR:-}" ];那么 if [ -f "$HOME/.agent/skills/tavily-web/tavily-api.cjs" ];那么导出 TAVILY_WEB_SKILL_DIR="$HOME/.agent/skills/tavily-web" elif [ -f "$HOME/.claude/skills/tavily-web/tavily-api.cjs" ];那么导出 TAVILY_WEB_SKILL_DIR="$HOME/.claude/skills/tavily-web" elif [ -f "$HOME/.codex/skills/tavily-web/tavily-api.cjs" ];那么导出 TAVILY_WEB_SKILL_DIR="$HOME/.codex/skills/tavily-web" 否则 echo "将 TAVILY_WEB_SKILL_DIR 设置为您安装的技能路径。" >&2 1号出口菲菲 ## 执行方法使用任务工具调用 `tavily-fetcher` 子技能，传递命令和 JSON (stdin)：任务参数： - 子代理类型：Bash - 描述：“调用Tavilly API” - 提示：cat <<'JSON' |节点“$TAVILY_WEB_SKILL_DIR/tavily-api.cjs”<搜索|提取|爬行|地图|研究> { ...有效负载... } JSON ## 负载示例（基于提供的curl） ### 1) 搜索网络猫 <<'JSON' |节点“$TAVILY_WEB_SKILL_DIR/tavily-api.cjs”搜索 { "query": "谁是里奥·梅西？", “自动参数”：假， “主题”：“一般”， "search_depth": "基本", “chunks_per_source”：3， “最大结果”：1， “时间范围”：空， “开始日期”：“2025-02-09”， “结束日期”：“2025-12-29”， “include_answer”：错误， “include_raw_content”：假， “include_images”：假， “include_image_descriptions”：假， “include_favicon”：假， “include_domains”：[]， “排除域”：[]， “国家”：空， “include_usage”：假 } JSON ### 2) 提取网页猫 <<'JSON' |节点“$TAVILY_WEB_SKILL_DIR/tavily-api.cjs”提取 { "urls": "https://en.wikipedia.org/wiki/Artificial_intelligence", “查询”：“<字符串>”， “chunks_per_source”：3， "extract_depth": "基本", “include_images”：假， “include_favicon”：假， “格式”：“降价”， “超时”：“无”， “include_usage”：假 } JSON ### 3) 抓取网页猫 <<'JSON' |节点“$TAVILY_WEB_SKILL_DIR/tavily-api.cjs”爬网 { "url": "docs.tavily.com", "instructions": "查找有关 Python SDK 的所有页面", “chunks_per_source”：3， “最大深度”：1， “最大宽度”：20， “限制”：50， “选择路径”：空， “选择域”：空， “排除路径”：空， “排除域”：空， “allow_external”：真， “include_images”：假， "extract_depth": "基本", “格式”：“降价”， “include_favicon”：假， “超时”：150， “include_usage”：假 } JSON ### 4) 地图网页猫 <<'JSON' |节点“$TAVILY_WEB_SKILL_DIR/tavily-api.cjs”地图 { "url": "docs.tavily.com", "instructions": "查找有关 Python SDK 的所有页面", “最大深度”：1， “最大宽度”：20， “限制”：50， “选择路径”：空， “选择域”：空， “排除路径”：空， “排除域”：空， “allow_external”：真， “超时”：150， “include_usage”：假 } JSON ### 5) 创建研究任务猫 <<'JSON' |节点“$TAVILY_WEB_SKILL_DIR/tavily-api.cjs”研究 { "input": "人工智能的最新进展是什么？", “型号”：“汽车”， “流”：假， “输出模式”：{ “属性”：{ “公司”：{ “类型”：“字符串”， "description": "公司名称" }, “关键指标”：{ “类型”：“数组”， "description": "关键绩效指标列表", “项目”：{ “类型”：“字符串” } }, “财务详细信息”：{ “类型”：“对象”， "description": "详细的财务明细", “属性”：{ “营业收入”：{ “类型”：“数字”， "description": "当期营业收入" } } } }, “必需”：[ “公司” ] }, “引用格式”：“编号” } JSON ## 环境变量和 API 密钥配置优先级：进程环境 > `.env`。 1. 多密钥（推荐）：`TAVILY_API_KEYS=key1,key2,key3` 2. 单键回退：`TAVILY_API_KEY=key1` 3.`.env`文件路径：`$TAVILY_WEB_SKILL_DIR/.env`（可以从`.env.example`复制）可选： * `TAVILY_MAX_RETRIES` 用于网络/服务器重试 * `TAVILY_KEY_STATE_PATH` 覆盖键状态文件路径

塔维利网

包含技能