# WebAgent

> WebAgent 让 LLM agent 像人类开发者一样在网页上完成任务。DoAnything API 与 BrowserAgent 引擎组成。本目录帮你定位；如需一次性吃完，请抓取 llms-full.txt。

## 入门

- [什么是 WebAgent](https://docs.qoni.ai/webagent/getting-started/what-is-webagent): WebAgent 是浏览器环境下的通用 Agent 平台，对外是 4 个并列的 API：DoAnything / DeepResearch / WebSearch / Track。
- [5 分钟上手](https://docs.qoni.ai/webagent/getting-started/quickstart): 注册→拿 wa_ key→装 SDK→起 run→看 SSE 事件。Python / TypeScript / cURL 三条路径任选。
- [鉴权与 API key](https://docs.qoni.ai/webagent/getting-started/authentication): WebAgent 用 wa_ 前缀的 bearer token，单 project 隔离，撤销后保留 1 小时 grace 防止断连。
- [计费与额度](https://docs.qoni.ai/webagent/getting-started/pricing): WebAgent 按 credits（预付 USD 余额）计费。两个桶 + 四桶 cost 拆账，无隐性收费。

## 概念

- [DoAnything](https://docs.qoni.ai/webagent/features/do-anything): DoAnything 是 WebAgent 的开放型 API——给一句 instruction，agent 自己定路径。session/run 资源模型 + 7 态生命周期 + 可断点续传的 SSE 流。
- [DeepResearch](https://docs.qoni.ai/webagent/features/deep-research): DeepResearch 把一个 topic 跑成带引用和置信度的研究报告。定型 API——产物形态固定，给质量契约。
- [WebSearch](https://docs.qoni.ai/webagent/features/web-search): WebSearch 批量跑查询，跨引擎去重重排，可选摘要。定型 API——查询进，结构化结果出。
- [Track](https://docs.qoni.ai/webagent/features/track): Track 监控一个意图，按 schedule 反复取数，变化命中时通知你。资源是长期存在的 monitor。
- [Profiles](https://docs.qoni.ai/webagent/features/profiles): Profile 是一份整体的、可复用的浏览器身份——一个用户一份，累积他在所有站点的登录态。session 和 monitor 用 profile_id 引用。
- [错误码与重试](https://docs.qoni.ai/webagent/reference/errors-and-retries): WebAgent 的每个错误都有稳定的 `code` 字段。本页说明哪些错误可以重试、哪些要直接抛给用户、哪些需要修改代码。

## SDK

- [Python SDK](https://docs.qoni.ai/webagent/sdk/python): 安装、配置、使用官方 web-agent-sdk Python 包。
- [TypeScript SDK](https://docs.qoni.ai/webagent/sdk/typescript): 安装、配置、使用官方 @web-agent/sdk Node / 浏览器包。
- [cURL 与原生 HTTP](https://docs.qoni.ai/webagent/sdk/curl): 任意语言都行。API 是 HTTPS 上的 JSON——下面是模式。

## API 参考

- [API 概览](https://docs.qoni.ai/webagent/reference/): 每个端点共享的约定——base URL、鉴权、错误、限流、分页。

## 指南

- [WebAgent Vibecoding](https://docs.qoni.ai/webagent/guides/vibecoding): 把 WebAgent 文档提供给 IDE 里的 LLM（Cursor / Claude Code / Aider），让它替你写集成。