核心用法
Teneo SDK（@teneo-protocol/sdk）是连接 Teneo Protocol 平台 AI 代理的 TypeScript SDK，核心功能包括：
1. 认证与连接
- 基于以太坊私钥的钱包签名认证
- WebSocket 实时通信，支持自动重连（默认 30 次）
- 连接后自动获取授权钱包地址
2. 房间管理
- 私有房间：认证后自动可用，无需订阅
- 公共房间：需显式调用
subscribeToRoom() - 房间所有者拥有邀请代理的权限
3. 代理发现与交互
listAgents()/searchAgents()发现可用代理addAgentToRoom()邀请代理（仅限房主）sendMessage()发送指令，支持等待响应与超时配置
4. x402 微支付协议
- 使用 USDC 支付代理调用费用（通常 $0.01-$0.10/次）
- 支持三条链：Base（推荐，低 Gas）、Peaq、Avalanche
- CAIP-2 格式配置网络（如
eip155:8453）
5. 事件系统
agent:response监听代理响应connection:open/disconnect/error连接状态管理- 内置速率限制检测与重试建议
显著优点
- 即时可用：WebSocket 实时双向通信，低延迟响应
- Web3 原生：钱包即身份，无需传统 API Key
- 灵活付费：x402 协议实现按调用付费，成本可控
- 多链支持：可切换 Base/Peaq/Avalanche 以优化费用
- TypeScript 完备：完整类型定义，开发体验良好
潜在缺点与局限性
- 私钥暴露风险：配置需传入以太坊私钥，存在泄露隐患
- USDC 前置要求：使用付费代理需预存 USDC，新用户门槛较高
- WebSocket 依赖：长连接对网络稳定性要求高，弱网环境易断开
- 代理生态限制：仅支持 Teneo Protocol 平台内的代理，生态封闭
- 响应延迟：AI 代理处理耗时 30-60 秒，需合理设置超时
- 速率限制：平台存在连接数限制，高并发场景需队列管理
适合人群
- 构建去中心化 AI 应用的 Web3 开发者
- 需要按量付费 AI 服务以控制成本的项目
- 探索 x402 支付协议与 AI 代理结合的创新实验者
- 熟悉 Ethereum 生态、具备钱包管理经验的团队
常规风险
- 私钥安全：私钥硬编码或泄露将导致资金损失，建议使用 KMS 或环境变量加密
- 合约风险：USDC 合约地址需官方验证，防止恶意合约骗取资金
- 网络切换误配：CAIP-2 格式错误或链 ID 不匹配会导致支付失败
- 余额不足：未监控 USDC 余额将触发交易失败，需前置检查
- 重连风暴：默认 30 次重连可能在高频错误场景下产生资源浪费，建议自定义退避策略