核心用法
Vincent 是一个专为 AI 代理设计的搜索技能，通过 Brave Search API 提供网页和新闻搜索能力。代理无需直接管理 Brave API 密钥，而是通过 Vincent 的代理优先认证模型：代理在运行时创建 DATA_SOURCES 类型的密钥，由 Vincent 服务端代为处理上游 Brave Search 的认证、计费与限流。
工作流程：
1. 代理调用 secret create 创建密钥，获得 keyId 和 claimUrl
2. 用户通过 claimUrl 认领密钥并充值
3. 代理使用 keyId 执行搜索命令，每次调用自动扣费
4. 响应包含 creditRemainingUsd 供代理监控余额
主要命令：
brave web：网页搜索，支持数量、时间过滤、地区等参数brave news：新闻搜索，支持时间过滤secret list/ relink：密钥管理与恢复
---
显著优点
1. 零密钥管理负担 — 代理不接触 Brave API 密钥，Vincent 服务端集中处理上游认证，降低密钥泄露风险。
2. 细粒度成本控制 — 按次计费（$0.005/次），实时返回余额，支持用户通过前端控制台管理预算。
3. 代理原生设计 — 支持完全自主运行，模型调用被显式启用，无需人工介入每次搜索。
4. 统一密钥体系 — 单个 DATA_SOURCES 密钥可访问多个数据源（Twitter、Brave 等），减少密钥蔓延。
5. 完善的故障恢复 — 支持通过一次性 re-link token 恢复密钥，避免单点故障导致代理瘫痪。
---
潜在缺点与局限性
1. 供应商锁定 — 完全依赖 Vincent 代理服务，无法直接调用 Brave Search API，若 Vincent 服务中断则搜索能力丧失。
2. 网络依赖单一端点 — 所有流量必须经过 heyvincent.ai，无离线或直连备用方案。
3. 费率溢价 — $0.005/次的定价显著高于直接使用 Brave Search API（Brave 官方 $3/1000次，约 $0.003/次）。
4. 限速较严格 — 60次/分钟的综合限速可能影响高并发场景。
5. 密钥存储位置透明度不足 — 虽然声明了存储路径，但代理对密钥持久化机制的控制有限。
---
适合人群
- 需要快速集成搜索能力且不愿处理 API 密钥管理的 AI 代理开发者
- 预算可控、调用量适中（月调用量 < 1万次）的自动化工作流
- 重视代理自主性、希望减少人工运维介入的场景
- 已使用 Vincent 生态（如 Twitter 数据源）的用户，可获得密钥复用收益
---
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 服务连续性 | Vincent 代理单点故障导致搜索中断 | 监控 `heyvincent.ai` 可用性，准备备选搜索方案 |
| 成本失控 | 代理自主调用可能导致意外高额消费 | 设置预算提醒，定期检查 `creditRemainingUsd` |
| 密钥泄露 | 虽然代理不持有 Brave 密钥，但 Vincent 代理密钥仍可能泄露 | 遵循最小权限原则，及时撤销不再使用的密钥 |
| 数据隐私 | 搜索查询经过第三方服务器 | 避免搜索敏感信息，评估 Vincent 数据处理条款 |
| 速率限制 | 突发流量触发 429 限流 | 实现指数退避重试逻辑 |