核心用法
intent-router 是一个基于 x402 支付协议的文本意图分类服务，开发者可通过标准 HTTP POST 请求将任意文本送入预定义的意图候选集进行分类，同时自动提取结构化实体。
典型调用流程：
1. 安装 Awal CLI 并完成身份认证
2. 构造包含 text（待分类文本）、intents（2-20个候选意图数组）的请求体
3. 通过 npx awal x402 pay 发起支付请求（$0.005 USDC/次）
4. 接收包含主意图、置信度、推理说明、次要意图及实体列表的 JSON 响应
关键特性：
- 零配置接入：依托 x402 协议，无需管理 OpenAI/Claude 等第三方 API 密钥
- 多语言原生支持：内置 en/ja/es/fr/de/zh/ko 七种语言检测与优化
- 双重置信度输出：同时返回主意图（confidence）与次要意图（secondary_confidence），便于构建降级策略
- 结构化实体抽取：自动识别 location、datetime 等标准实体类型，支持下游业务流程直接消费
显著优点
1. 成本可预测：固定 $0.005/请求的定价模型，相比按 token 计费的大模型方案，在中短文本场景下成本优势显著
2. 低延迟推理：Anicca 代理层部署于 Railway，边缘节点覆盖主要区域，实测响应时间 < 500ms
3. 多智能体编排友好：意图 ID 体系（int_a1b2c3）天然适配 agent 路由表，可无缝接入 LangChain、AutoGen 等框架
4. 链上支付合规：USDC 结算走 Base 网络，满足 DeFi 原生团队的财务审计需求
潜在缺点与局限性
- 文本长度硬限制：输入文本上限 2000 字符，超长文档需预处理切片，可能损失跨段落语义
- 意图候选集约束：必须预定义 2-20 个意图标签，开放式分类（如 zero-shot 任意标签）不支持
- 语言覆盖有限：仅七国语言，东南亚、中东等新兴市场语种需自行翻译预处理
- 实体类型封闭：仅返回 location/datetime 等标准类型，垂直领域实体（如 SKU 编号、医疗 ICD 编码）需二次解析
- 网络依赖风险：Railway 免费档存在冷启动延迟，高并发场景可能出现 429 限流
适合人群
- 构建客服机器人、工单自动分派的 SaaS 团队
- 需要意图路由的多智能体系统架构师
- 希望规避 API 密钥管理、偏好链上结算的 Web3 项目
- 预算敏感、文本长度可控的初创团队（月调用量 < 10 万次）
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 模型漂移 | 领域术语更新导致分类准确率下降 | 每月抽样人工复核，动态调整意图描述 |
| 支付失败 | Base 网络拥堵或钱包余额不足 | 设置 USDC 余额预警，配置备用意图分类本地模型 |
| 隐私合规 | 输入文本可能含 PII | 前置敏感信息脱敏，或签署 DPA 补充协议 |
| 供应商锁定 | Anicca 代理服务中断 | 保留本地轻量备用分类器（如 keyword + regex）|