网络代理商

一个公共工具, web_explore,这确实为Pi做了限定的网页研究:搜索,取回,定向浏览器渲染,排名,以及诚实的提醒,所有这一切都是在一个呼叫背后.

大多数代理网络工具模糊了搜索、取取、渲染和合成到一个模糊的东西. pi-web-agent 保持边界的简单, 并且更严格地说它实际上做了什么: bot检查页面, 狭义的源集, 无法读取的线程, 和相冲突的证据 显示作为警告而不是假信心.

你得到的东西

• 一个工具. web_explore 处理直接链接、发现、 HTTP 读取、 定向无头渲染、 源排名、 源质量检查和内部提醒.
• 阅读链接后的真实内容. 粘贴一个 GitHub, PDF, 或 YouTube URL 并拉出实际内容( GitHub 文件/ 问题/ PRs from the API, PDF text, YouTube driev). 公共 GitHub 内容为无密钥; 私人 GitHub 内容需要 GITHUB_TOKEN 或者说 gh auth login,因此"概括这个PDF"或"这个Repo做什么"在源头而不是页面外壳上有效.
• 解答关于 GitHub repo 代码的问题 . 粘贴一个 repo 或文件夹链接, 并复制精确执行( shallow, over HTTPS) , 搜索您提问的代码, 并引用附加执行的链接的节选 。 需求 git 2.32+. 公共寄存器可匿名读取;私人寄存器的使用 gh auth login 或者说 GITHUB_TOKEN。如果无法读取回放,它说明为什么,而不是从读取回放中猜测.
• 埃斯克,别这样. 取消运行中 web_explore 停止搜索、页面阅读和无头浏览器。 Page读取了15秒后放弃(PDFs 60,Firecrawl 45),一页没有加载不会使整个运行失败.
• 八寻后端. DuckDuckGo(无键默认),SearXNG,Brave,You.com,Exa,Tavily,并行(无键,选入),以及您指向的任何Google SERP端点.
• 可选搜索粉丝出道. 一次查询数个后端,去dupe,并排出一个以上提供者同意的页面. 默认关闭; 翻到 on 或者说 auto。 。 。 .
• 诚实的默认. 弱小、狭窄、被封锁或警告的证据被标出而不是装扮成自信.
• 不受信任的页面安全. 链接模型选择,或在其读取的页面上找到,无法到达本地主机,您的局域网,或云元数据端点. 包括重定向和一切无头页面负载. 您配置的地址不受影响, 允许列表覆盖您想要的私有区域 .
• 后退知道为什么. 限制速率或配置错误的后端被跳过一段时间,有片面的后端被重试一次,回答时会说一些搜索后端没有可用.
• 列报和结果长度是分开的. compact 编号 : preview 编号 : verbose 控制终端; 自动结果长度保留适合调用模型的工具结果.
• 零配置开始. 从框中运行无密钥(DuckDuckGo搜索,本地浏览器,内置阅读器). 当您想要更多控制时,通过配置选择主机后端,倒置,搜索扇出,以及每个工具输出模式.

为什么是网友

与其他代理工具相比:

• 手举起. 没有管理员,没有浏览器窗口可以批准,没有步骤让你退出会话. 询问 web_explore 一回而后答清净回向. 没什么好照顾的.
• 默认无键 . 搜索,页面读取,而GitHub/PDF/YouTube读取器都是在没有API密钥的情况下工作的. 仅在您需要时添加主机提供者 .
• 被束缚和诚实. 终端默认是紧凑的;工具结果使用他们自己的模型意识长度限制,并说当一个读数不够好而不是返回假信心时.

安装

pi-web-agent 需要 Pi 0.74+ 键 (Pi 软件包移至 @earendil-works/* 范围。 在更新此软件包之前更新 Pi 。 老皮,继续 @demigodmode/[email protected]扩展工程为Pi 0.99和1.0; typebox 是Pi已经提供的对等依赖.

CI运行在22号节点上. 锁定的运行时间依赖 [email protected] 宣布节点 >=22.19.0; 见 安装要求。 。 。 .

pi install npm:@demigodmode/pi-web-agent

安装后重新装入或重新启动 Pi, 然后 :

/web-agent doctor   # check it loaded and show configured backends
/web-agent          # action menu

稍后更新为 pi update --extensions。 。 。 .

浏览器渲染 : 无头先尝试被检测出Chrome-family浏览器(Chrome,Chrome,Chrome,Edge,Brave). 如果找不到, 它会尝试 Playwright 管理的 Chromium, 它必须已经安装 。 见 浏览器设置 用于匹配的安装命令。 Firefox/Safari-只读系统仍然得到搜索和普通HTTP读取.

使用量

询问 web_explore 网络问题:

查找当前关于 V8 提供者配置 Vitest 覆盖的文件和讨论 .

或者用链接来读取:

概括此 PDF : https://arxiv.org/pdf/1706.03762 (中文(简体) )

如果传球传回来,请打电话 web_explore 以一个更窄的查询.

简短、具体的询问最有效。 诸如 vs,一个版本编号或 user opinions 改变研究方式,所以值得保留 结果还列出了被搜索的内容,当一个人回来时,部分内容仍然开放,再加上几个后续搜索Pi可以尝试.

后端

默认为 DuckDuckGo 搜索, plain HTTP 获取,以及本地浏览器无头. 切换提供者从 /web-agent settings → Backends。UI不写入 API 密钥。 手动防火 apiKey 和代理服务器 password 配置值被支持,但后端保存从该范围的文件中删除它们. 环境变量能活过这些节省.

完整配置形状( 回落、 SearXNG / Firecrawl 选项、扇出):见 自备后端。 。 。 .

设置

/web-agent settings                    # main UI
/web-agent doctor                      # health check
/web-agent show                        # effective config
/web-agent changelog
/web-agent mode web_explore verbose    # per-tool presentation mode
/web-agent reset project | global

配置是 JSON, 而项目配置覆盖全局 :

Global:  ~/.pi/agent/extensions/pi-web-agent/config.json
Project: .pi/extensions/pi-web-agent/config.json

{
  "results": { "lengthLimit": "short" },
  "presentation": {
    "defaultMode": "compact",
    "tools": { "web_explore": { "mode": "verbose" } }
  }
}

演示文稿模式 :

• compact: 短摘要, 处处默认
• preview: 边框视图略为丰富
• verbose: 更充分的限定视图

模式只更改终端显示 。 它们不会缩短模型收到的工具结果。 结果长度控制,分别: 自动是默认的,或者选择Short(4,000个字符),Medium(8,000个字符),Standard,或者在JSON中精确的数字(数字低于1000变为1000个). 见 结果长度 用于计算和标定源顶.

在演示文稿或后端设置中, Ctrl+S 保存, Esc 丢弃编辑, Ctrl+R (按了两次) 重排选定范围的全部配置文件. 在“结果”中,Ctrl+R只重置该范围的成果长度设置。 明确重置菜单和 /web-agent reset project 或者说 /web-agent reset global 重置整个范围文件,包括结果长度设置.

文档

完整文档 : https://demigodmode.github.io/pi-web-agent/ 页面存档备份,存于互联网档案馆. 在当地与 npm run docs:dev。 。 。 .

发展

npm install
npm test
npm run lint
npm run build

本地 Pi 工作用途 .pi/extensions/pi-web-agent.ts; 运行 /reload 变化后.

特性和固定 PR 目标 develop· ; main 只有释放后移动。 见 释放。 。 。 .

许可证

AGPL-3.0 -仅限. 见 自由主义。 。 。 .