Agently 文档

中文

EN

中文

EN

Appearance

Search 搜索工具 ​

适用版本：v4.0.8.2

Search 基于 ddgs，并在源码中要求 ddgs>=9.10.0。

1. Search + Browse 的推荐协作链 ​

如何阅读这张图 ​

  • Search 负责找候选，不负责保证正文质量。
  • Browse 负责把候选页变成可消费的正文证据，所以 v4.0.8.2 的推荐心智模型已经从“Search + Playwright”收敛为“Search + Browse”。

2. 可用方法 ​

  • search(query, timelimit=None, max_results=10)
  • search_news(query, timelimit=None, max_results=10)
  • search_wikipedia(query, timelimit=None, max_results=10)
  • search_arxiv(query, max_results=10)

3. 初始化参数 ​

python
from agently.builtins.tools import Search

search = Search(
    proxy=None,
    timeout=20,
    backend="auto",
    search_backend=None,
    news_backend=None,
    region="us-en",
    options=None,
)

说明：

  • backend 是总默认值
  • search_backend / news_backend 可以分别覆盖
  • options 会透传给底层 ddgs

4. 作为 Agent 工具使用 ​

python
from agently import Agently
from agently.builtins.tools import Search

agent = Agently.create_agent()
search = Search(region="us-en", backend="google")

agent.use_tools([
    search.search,
    search.search_news,
    search.search_wikipedia,
    search.search_arxiv,
])

5. 返回结构 ​

search / search_news / search_wikipedia 常见返回字段：

  • title
  • href 或 url
  • body / snippet
  • source
  • date

search_arxiv 返回：

  • feed_title
  • updated
  • entries[]

6. 当前推荐组合 ​

推荐链路已经从“Search + Playwright”统一收敛为：

  • Search + Browse

原因：

  • Browse 已经内部集成 Playwright / PyAutoGUI / bs4 fallback
  • 业务流程层不再需要自行判断该调用哪个浏览 backend

7. Daily News Collector 中的用法 ​

Agently-Daily-News-Collector 主要使用：

  • search_news(...)

并把搜索结果再交给 Browse 读取正文。这是 v4.0.8.2 下最推荐的“先搜再读”模式。