集成 You.com 搜索与深度研究 API

[tra371]

问题描述

CookHero 目前使用 Tavily 作为唯一的联网搜索提供商。考虑到 You.com 提供了更强大的 Search API 和 Research API（深度研究），建议将 You.com 作为主要搜索提供商，并新增深度研究功能。

提案内容

1. 替换 Tavily 为 You.com Search API

You.com Search API (POST https://ydc-index.io/v1/search) 提供与 Tavily 类似的功能，包括：

• 标题、URL、摘要（snippet）返回
• 更高的结果质量和相关性
• 与现有架构兼容

2. 新增 Deep Research 工具

You.com Research API (POST https://ydc-index.io/v1/research) 提供深度研究能力：

• 支持 lite/standard/deep/exhaustive 四种研究深度
• 返回 Markdown 格式的研究报告
• 包含引用来源列表
• 可作为 Agent 的独立工具调用

技术方案

1. 新增 You.com API 模块 (app/integrations/youcom/)

   • client.py — 封装 You.com Search + Research API 调用
   • 读取配置中的 YOUCOM_API_KEY

2. 更新 Web Search 工具

   • 修改 app/agent/tools/common/websearch.py，将 Tavily 替换为 You.com Search
   • 修改 app/tools/web_search.py 中的 execute_search() 方法

3. 新增 Deep Research 工具

   • 在 app/agent/tools/common/ 下新增 deep_research.py
   • 实现 DeepResearchTool (BaseTool 子类)
   • 注册到 AgentHub

4. 配置更新

   • .env.example 新增 YOUCOM_API_KEY
   • config.yml 新增 youcom 配置节
   • app/config/web_search_config.py 扩展支持 You.com 配置

预期效果

• 搜索结果质量提升
• Agent 支持深度研究场景（需要深入分析的问题）
• 保持与现有 Tavily 配置的后向兼容（可选择性切换）

参考资料

• You.com Search API: https://ydc-index.io/docs
• You.com Research API: https://ydc-index.io/docs