搜索工具

搜索工具组提供多源信息检索，覆盖互联网搜索、本地知识库、DataMate 知识库以及 Dify 知识库。适合实时信息查询、行业资料检索、私有文档查找等场景。

🧭 工具清单

本地/私有知识库：
- knowledge_base_search：本地知识库检索，支持多知识库与多种检索模式
- datamate_search：对接 DataMate 知识库的检索
- dify_search：对接 Dify 知识库的检索
公网搜索：
- exa_search：基于 EXA 的实时网页与图片搜索
- tavily_search：基于 Tavily 的网页与图片搜索
- linkup_search：基于 Linkup 的图文混合搜索

配置参数：top_k（返回结果数量，默认 3）
检索参数：
- query：检索问题，必填。
- search_mode：hybrid（默认，混合召回）、accurate（文本模糊匹配）、semantic（向量语义）。
- index_names：指定要搜索的知识库名称列表（可用用户侧名称或内部索引名），可选。
返回匹配片段的标题、路径/URL、来源类型、得分等。
若未选择知识库，会提示"无可用知识库"。

配置参数：
- server_url：DataMate 服务地址（如 http://192.168.1.100:8080 或 https://datamate.example.com:8443）
- verify_ssl：是否验证 SSL 证书（HTTPS 默认 False，HTTP 默认 True）
检索参数：
- query：检索问题，必填。
- top_k：返回数量，默认 3。
- threshold：相似度阈值，默认 0.2。
- index_names：指定要搜索的知识库名称列表，可选。
- kb_page / kb_page_size：分页获取 DataMate 知识库列表。
返回包含文件名、下载链接、得分等结构化结果。

配置参数：
- dify_api_base：Dify API 基础地址
  - 若您本地部署了Dify，则直接使用http://host.docker.internal/v1
  - 若您在服务器部署了Dify，则使用http://x.x.x.x:x/v1并替换上合适的IP及端口
  - 若您使用Dify官网云服务，则直接使用https://api.dify.ai/v1
- api_key：Dify 知识库 API 密钥，以dataset-开头（在 Dify 中查看知识库页面，点击左上角"API"页签，再点击右上角"API 密钥"按钮创建）
- dataset_ids：知识库 ID 列表（如 ["e912e1f5-29c0-40da-8baf-d35da77c60df"]，可在 Dify 知识库页面 URL 中查看知识库ID）
- top_k：返回结果数量，默认 3
检索参数：
- query：检索问题，必填。
- search_method：搜索方法，选项：keyword_search、semantic_search、full_text_search、hybrid_search，默认 semantic_search。
返回匹配片段的标题、内容、得分等。

配置参数：
- exa/tavily/linkup_api_key：对应服务的 API 密钥
- max_results：返回结果数量，默认 3
- image_filter：是否启用图片过滤，默认 True
检索参数：
- query：检索问题，必填。
图片过滤：默认开启，按查询语义过滤常见无关图片；可关闭以获取全部图片 URL。
API Key 获取：
- Exa：前往 exa.ai 注册并在控制台申请 EXA API Key
- Tavily：访问 tavily.com 创建账户，在 Dashboard 获取 Tavily API Key
- Linkup：在 linkup.so 注册并于个人中心创建 Linkup API Key
返回标题、URL、摘要，可能附带图片 URL 列表（去重处理）。

选择数据源：私有资料用 knowledge_base_search、datamate_search 或 dify_search；实时公开信息用 Exa/Tavily/Linkup。
设置检索模式/数量：知识库可在 search_mode 之间切换；公网搜索可调整 max_results 与是否启用图片过滤。
限定范围：需要特定知识库时填写 index_names，避免无关结果；DataMate 可通过阈值与 top_k 控制结果精度与数量。
结果利用：返回为 JSON，可直接用于回答、摘要或后续引用；包含 cite 索引便于引用管理。