技能介绍

为什么需要这三个端点

当 Agent 需要处理外部文档或实时网页信息时，自建爬虫栈意味着要维护 JS 渲染、代理轮换和文档解析器，成本不低。Venice Augment 把文档解析、网页抓取和搜索封装成三个轻量 HTTP 接口，让 Agent 直接拿到干净的 text 或 markdown，把精力花在下游推理而非数据清洗上。

核心接口与工作流

/augment/text-parser：通过 multipart/form-data 上传 PDF、DOCX、XLSX 或纯文本（≤25MB），返回提取后的文本及 tokens 计数，可用于下游 chat 请求的预算控制。
/augment/scrape：传入 url，直接获取 markdown 格式的正文，适合与 /chat/completions 串联做摘要或问答。
/augment/search：传入 query（1–400 字符），可选 brave（ZDR）或 google（匿名代理）作为 provider，返回带 title、url、content 的结果列表。

三个端点均支持 Bearer API key 或 SIWE 钱包鉴权，采用动态计费模式。

适用边界与避坑

不做 OCR：扫描版图片 PDF 无法提取文字，这类输入需改用视觉模型处理。
反爬限制：X/Twitter 和 Reddit 会直接返回 400，这类站点的内容应切换到 /chat/completions 的内置搜索参数。
输入校验严格：query 超过 400 字符会被直接拒绝（400 INVALID_REQUEST）而非截断。
错误处理：余额不足返回 402，限流返回 429（建议带抖动退避），上游失败返回 500（可安全重试）。