什么是 WebAgent

WebAgent 是 Qoni 的网页行动层：应用给出目标，它在真实浏览器里完成搜索、点击、填写、读取和跨页面操作，并把执行结果交回业务系统。

四个能力

• DoAnything：开放式浏览器任务，agent 自主决定执行路径。
• Track：定时执行网页检查，读取最近 50 次检查记录。
• DeepResearch：多轮检索和交叉核对，产出研究报告。
• WebSearch：批量搜索，返回去重后的结构化结果。

Profiles 用于 DoAnything 复用登录态；SSE 用于观察 run 产品的任务进度，当前 Track 不提供这两个入口。产品共享 project 隔离与鉴权，不共用同一组旧版 Client 方法。

调用入口

入口	适用场景
Node.js / TypeScript SDK	服务端使用 @qoniai/qoni，AK/SK + delegation token
REST / cURL	任意语言直接调用 /api/v1
Python / 原生 HTTP	Python 通过 HTTP 客户端调用，不安装不存在的 Python SDK

任务模型

DoAnything、DeepResearch、WebSearch 的创建接口返回异步 run。Track 返回定时任务资源，checks 只提供最近 50 次检查，不是全历史详情接口。Node SDK 用 RunHandle / MonitorHandle；正式 0.9.0 的旧 Track 路由与当前后端不兼容，未发布候选边界见 Track。