SuperAPI AI 工具集

agentweb

通用与其它

查看项目

更新于 11-15 03:39

技能介绍

AgentWeb 是一个面向网站操作的技能工具,主要通过 scripts/agentweb.sh 脚本(Bash,配合 Python 3.9+ 标准库)调用后端三类接口:POST /service/agentweb/discover(发现站点映射)、POST /service/agentweb/execute(执行操作)、GET /service/agentweb/requests/:request_id(查询请求结果)。

用途与流程 整体使用方式是“先发现、再执行”。先用 discover 按域名获取映射文件,其中可能包含学习到的上下文,以及一个经过验证的可执行操作区段;存在后者时应优先采用其中的精确域名、操作名与参数名。随后用 execute 指定域名、操作名和扁平参数执行。文档强调示例中的操作与参数仅为示意,不能替代发现步骤;区域映射键和 productId 等动态参数名需原样保留,不得编造 ID、操作或参数,缺失的业务输入应主动向用户询问。发现操作本身不授权其他无关操作,也不会自动执行任何操作。

主要能力 当前服务端只支持明确公开的读取类操作,验证要求为 requires_login=false、connect_providers 为空、且单一所选操作 kind=read 并无 auth_provider 字段。涉及账号连接、私有操作、写入操作和无法验证权限的映射均被拒绝。脚本支持 --json 传入完整 API 请求体,params 为扁平结构,只能是字符串、有限数字或布尔值,禁止 null、数组或嵌套对象;未知顶层字段会在本地被拒绝。

鉴权与配置 运行时需要环境变量 FREVANA_TOKEN,仅以 Authorization: Bearer 形式发送,不得打印或保存。非交互场景缺失时应停止并请用户设置。默认服务地址为 https://ai-factory.frevana.com,可通过 FREVANA_API_BASE_URL 或 --api-base-url 覆盖;拒绝重定向;无需 CLI、守护进程或 Chrome 配置。工具不会请求或发送目标网站的 Cookie 或提供商 API 密钥。

站点授权提示 当发现结果声明需要登录或存在连接提供商时,应告知用户需先完成该网站账号授权,不提交已知被阻止的操作。执行或已保存请求返回 403 与 AUTH_REQUIRED、TARGET_AUTH_UNSUPPORTED 时,应解释为授权需求而非 Frevana 令牌错误;通用的 ACTION_NOT_PUBLIC 也可能表示禁止的写入操作。若返回 auth.connect_url,应将其作为可点击链接展示并请用户在浏览器完成授权后确认。当前后端存在限制:会在提供商执行前拒绝需登录映射,并将上游 AUTH_REQUIRED 转为 TARGET_AUTH_UNSUPPORTED 且不保留授权链接,因此本版本能识别并解释授权需求,但无法完成连接后继续的流程。

结果恢复 execute 必须配合 --state-file。提交前会原子保存规范化请求体、来源与幂等键;若可用会保存 request_id 与错误响应。状态文件包含业务参数与结果,应保持私密,且不存储 Frevana 凭证。可使用 status 与 wait 查询已保存记录(已知 ID 时仅用 GET),wait 仅在 STARTED/READY/DEBITING 状态下重复 GET,不触发执行或结算。若提交在获得 ID 前失败,应停止自动重试;需要恢复时使用 recover 显式重放一次保存的请求体与幂等键,同一用户、操作、键与请求体重用服务端记录,请求体变化会返回 409。遇到 REVIEW/REJECTED 应停止并保留请求、追踪与支持 ID。

结果与费用 发现操作无入口费用;执行按服务器实际计费回执,失败(包括 HTTP 422)仍可能产生参数解析费用。不应估算固定价格,也不能从失败推断免费或从 billing.status=BILLED 推断成功;业务成功还需 execution_http_status 成功、无错误且数据可用。输出默认保留服务端 JSON 原样,可选 --output 原子保存相同响应字节;状态与输出路径必须不同。默认不设 HTTP 超时,可用 --http-timeout 限制单次本地等待,wait 默认本地截止时间为 180 秒。退出码:0 表示有效发现或已结算的业务成功;2 表示输入/状态/协议/HTTP/传输/持久化错误;3 表示返回或截止时仍待处理;4 表示 REVIEW、REJECTED 或已结算业务失败。

适用场景与限制 适合在自动化流程中对公开网站执行受支持的读取操作并保留可恢复的请求状态。限制包括:仅支持公开读取、不支持写入与账号私有操作、不能完成需登录站点的授权继续流程、不提供独立的结果查询、取消、列表或账户余额接口,且必须依赖 FREVANA_TOKEN 与可访问的后端服务。资料未提供具体收费标准、支持站点清单和完整参数规模上限,这些内容暂未提供。