WebAgent Vibecoding

把完整文档和 OpenAPI schema 提供给 IDE 里的 LLM，并明确要求：缺少接口或字段时先说缺口，不要猜。

机器可读上下文

• /webagent/llms.txt：页面索引
• /webagent/llms-full.txt：完整 Markdown
• /openapi/v1.json：当前后端导出的 OpenAPI 3.1

推荐规则

你正在集成 Qoni WebAgent。只以附加的完整文档和 OpenAPI 3.1 为准；如果缺少路径、字段或 SDK 方法，先说明，不要猜测。

原生 HTTP：
- Base URL：https://webagent.qoni.ai
- 路径前缀：/api/v1/projects/{pid}/...
- 鉴权：Authorization: Bearer wa_...
- wire 字段使用 snake_case

Node.js / TypeScript：
- 安装 @qoniai/qoni
- 服务端用 Qoni({ accessKey, secretKey }) 初始化
- 先 delegateToken({ user: { id }, products: [...] })，再把 token 传给 qoni.doAnything / deepResearch / webSearch / track
- qoni 的 run() 返回 RunHandle；使用 run.id、run.events()、run.wait()、run.cancel()

不要使用已删除的 web-agent-sdk、@web-agent/sdk、new Client、client.sessions、runAsync、webSearch.refine 或 track.listSnapshots。

注意

OpenAPI 的路径带 /api/v1；文档中的旧 /v1 片段是历史设计文字，不应复制到请求 URL。Node SDK 会自动注入 project 路径，业务代码不需要手写 projectId。