# 塔维利人工智能搜索 ## 概述 Tavily 是一款专门针对大型语言模型和人工智能应用程序进行优化的搜索引擎。与传统的搜索 API 不同，Tavily 提供人工智能就绪的结果以及可选的答案生成、干净的内容提取和域过滤功能。 **关键能力：** * 人工智能根据搜索结果生成答案摘要 * 针对法学硕士处理优化的干净、结构化的结果 * 快速（‘基本’）和全面（‘高级’）搜索模式 * 域过滤（包括/排除特定来源） * 以新闻为中心的时事搜索 * 具有相关视觉内容的图像搜索 * 提取原始内容以进行更深入的分析 ## 架构图TB A[用户查询] --> B{搜索模式} B -->|基本| C【快速搜索
1-2秒响应】 B -->|高级| D【综合搜索
5-10秒响应】 C --> E[Tavilly API] D-->E E --> F{主题过滤器} F -->|一般| G[广泛的网络搜索] F -->|新闻| H[新闻来源
最近7天] G --> I[域过滤] H-->我 I --> J{包括域？} J -->|是| K[过滤到特定域] J -->|否| L{排除域？} K --> M[搜索结果] L -->|是| N[删除不需要的域] L -->|否|中号 N --> M M --> O{响应选项} O --> P[AI 答案
总结] O --> Q[结构化结果
标题、URL、内容、分数] O --> R[图片
如果需要] O --> S[原始 HTML 内容
如果需要] P --> T[返回代理] 问--> T 右 -> 右 S-->T E 型填充：#4A90E2 P 型填充：#7ED321 Q 风格填充：#7ED321 R风格填充：#F5A623 S 型填充：#F5A623 ## 快速入门 ### 基本搜索 # 简单查询+AI回答 script/tavilly_search.py “什么是量子计算？” # 多个结果 scripts/tavily_search.py “Python 最佳实践” --max-results 10 ### 高级搜索 #综合研究模式 scripts/tavilly_search.py “气候变化解决方案”--深度高级 # 以新闻为中心的搜索 scripts/tavilly_search.py “2026 年人工智能发展”--主题新闻 ### 域名过滤 # 仅搜索受信任的域 scripts/tavilly_search.py "Python 教程" \ --include-domains python.org docs.python.org realpython.com # 排除低质量来源 scripts/tavilly_search.py “如何编码” \ --排除域名 w3schools.com geeksforgeeks.org ### 带图像 # 包含相关图像 scripts/tavilly_search.py “埃菲尔铁塔建筑”--images ## 搜索模式 ### 基础与高级模式|速度|覆盖范围|使用案例 ---|---|---|--- **基本** | 1-2秒|好 |快速事实，简单查询 **高级** | 5-10 秒 |优秀|研究、复杂主题、综合分析 **决策树：** 1. 需要快速了解事实或定义？ → 使用“基本” 2. 研究一个复杂的课题？ → 使用“高级” 3. 需要多种视角？ → 使用“高级” 4. 时间敏感的查询？ → 使用“基本” ### 一般与新闻主题 |时间范围 |来源 |使用案例 ---|---|---|--- **一般** |所有时间 |广网|常青内容、教程、文档 **新闻** |过去 7 天 |新闻网站|时事、最新动态、突发新闻 **决策树：** 1.查询包含“最新”、“最近”、“当前”、“今天”？ → 使用“新闻” 2. 寻找历史或常青内容？ → 使用“一般” 3. 需要最新信息？ → 使用“新闻” ## API 密钥设置 ### 选项 1：Clawdbot 配置（推荐）添加到您的 Clawdbot 配置中： { “技能”：{ “条目”：{ “塔维利”：{ “启用”：正确， "apiKey": "tvly-YOUR_API_KEY_HERE" } } } } 通过 Clawdbot 的配置系统在脚本中访问。 ### 选项 2：环境变量导出 TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE" 添加到 `~/.clawdbot/.env` 或您的 shell 配置文件。 ### 获取 API 密钥 1.访问 2. 注册账户 3. 导航至您的仪表板 4. 生成 API 密钥（以 `tvly-` 开头） 5.注意您的计划的利率限制和信用分配 ## 常见用例 ### 1\.研究与事实调查 # 全面研究并给出答案 scripts/tavily_search.py “解释量子纠缠”--深度高级 # 多个权威来源 script/tavily_search.py “REST API 设计的最佳实践” \ --最大结果 10 \ --include-domains github.com microsoft.com google.com ### 2\.时事 #最新消息 scripts/tavilly_search.py “人工智能政策更新”--专题新闻 # 某个领域的最新进展 script/tavilly_search.py “量子计算突破” \ --专题新闻\ --深度进阶 ### 3\.特定领域的研究 # 仅学术来源 scripts/tavilly_search.py “机器学习算法” \ --include-domains arxiv.org seller.google.com ieee.org # 技术文档 scripts/tavily_search.py “React hooks 指南” \ --include-domainsreact.dev ### 4\.视觉研究 # 收集视觉参考 scripts/tavilly_search.py “现代网页设计趋势” \ --图像\ --最大结果 10 ### 5\.内容提取 # 获取原始 HTML 内容以进行更深入的分析 scripts/tavily_search.py "Python 异步/等待" \ --原始内容\ --最大结果 5 ## 响应处理 ###人工智能答案人工智能生成的答案提供了根据搜索结果综合而成的简明摘要： { “answer”：“量子计算是一种利用量子力学现象的计算……” } **使用时间：** * 需要快速总结 * 想要从多个来源综合信息 * 寻找问题的直接答案 **当**时跳过（`--no-answer`）： * 只需要源 URL * 想要形成自己的合成 * 节省 API 积分 ### 结构化结果每个结果包括： * `title`: 页面标题 * `url`: 源 URL * `content`：提取的文本片段 * `score`：相关性分数 (0-1) * `raw_content`：完整的 HTML（如果启用了 `--raw-content`） ### 图片当启用“--images”时，返回搜索期间找到的相关图像的 URL。 ## 最佳实践 ### 1\.选择正确的搜索深度 * 对于大多数查询，从“基本”开始（更快、更便宜） * 仅在以下情况下升级为“高级”： * 初步结果不充分 * 主题复杂或微妙 * 需要全面覆盖 ### 2\.有策略地使用域过滤 **包含以下域名：** * 学术研究（`.edu` 域名） * 官方文档（官方项目网站） * 值得信赖的新闻来源 * 已知的权威来源 **排除以下域名：** * 已知的低质量内容农场 * 不相关的内容类型（Pinterest 用于非视觉查询） * 具有付费专区或访问限制的网站 ### 3\.优化成本 * 使用“基本”深度作为默认值 * 将 `max_results` 限制为您实际使用的值 * 除非需要，否则禁用“include_raw_content” * 在本地缓存结果以供重复查询 ### 4\.优雅地处理错误该脚本提供了有用的错误消息： # 缺少 API 密钥错误：需要 Tavilly API 密钥设置：设置 TAVILY_API_KEY 环境变量或传递 --api-key # 软件包未安装错误：tavilly-python 软件包未安装安装： pip install tavilly-python ## 集成模式 ### 程序化使用从 tavilly_search 导入搜索结果=搜索（ query="什么是机器学习？", api_key="tvly-...", search_深度=“高级”，最大结果=10 ） if result.get("成功"): 打印（结果[“答案”]）对于结果[“结果”]中的项目： print(f"{item['title']}: {item['url']}") ### 用于解析的 JSON 输出 scripts/tavilly_search.py "Python 教程" --json > results.json ### 与其他工具链接 # 搜索并提取内容 scripts/tavily_search.py “React 文档”--json | \ jq -r '.results[].url' | jq -r '.results[].url' | \ xargs -I {} 卷曲 -s {} ## 与其他搜索 API 的比较 **与勇敢的搜索：** * ✅ AI 答案生成 * ✅ 原始内容提取 * ✅ 更好的域名过滤 * ❌ 比勇敢慢 * ❌ 成本积分 **与困惑：** * ✅ 对来源有更多的控制 * ✅ 提供原始内容 * ✅ 专用新闻模式 * ≈ 相似的答案质量 * ≈ 相似速度 **与 Google 自定义搜索相比：** * ✅ LLM 优化结果 * ✅ 答案生成 * ✅ 更简单的API * ❌ 较小的索引 * ≈ 相似的成本结构 ## 故障排除 ### 脚本无法运行 # 使可执行文件 chmod +x 脚本/tavily_search.py # 检查Python版本（需要3.6+） python3——版本 # 安装依赖项 pip 安装 tavilly-python ### API 密钥问题 # 验证 API 密钥格式（应以 tvly- 开头）回显 $TAVILY_API_KEY # 使用显式密钥进行测试脚本/tavily_search.py“测试”--api-key“tvly-...” ### 速率限制错误 * 在检查您的计划的信用分配 * 减少“max_results”以节省积分 * 使用“基本”深度而不是“高级” * 对重复查询实现本地缓存 ## 资源请参阅 [api-reference.md]()： * 完整的API参数文档 * 响应格式规范 * 错误处理细节 * 成本和费率限制信息 * 高级使用示例 ## 依赖关系 * Python 3.6+ * `tavily-python` 包（安装：`pip install tavily-python`） * 有效的 Tavilly API 密钥 ## 制作人员及归属 * 塔维利 API： * Python SDK： * 文档：

通量

包含技能