核心用法
Noya Agent 是一个专为加密货币交易场景设计的多智能体 AI 系统，通过 REST API 提供以下核心能力：
1. 流式对话交互：通过 /api/messages/stream 端点发送消息，接收 chunked text stream 响应，支持实时工具调用、进度更新、执行步骤说明等丰富的交互类型
2. 对话线程管理：支持创建、列出、获取和删除对话线程，便于长期策略跟踪
3. OpenAI 兼容接口：提供 /api/chat/completions 端点，可与现有 AI 应用生态集成
4. 代理能力查询：通过 /api/agents/summarize 获取可用代理类型及其专业领域
显著优点
- 实时流式响应：采用 chunked streaming 技术，用户可实时看到 AI 思考过程、工具调用进度和执行步骤
- 多智能体架构：系统内置多个专业代理，分别处理交易、预测市场（Polymarket、Rain）、代币分析和 DCA 策略
- 丰富的交互类型：支持消息片段、工具结果、进度更新、用户确认中断、执行理由说明等多种 chunk 类型
- 线程持久化：对话历史存储在 Redis 中，支持跨会话状态保持
- 生态兼容：OpenAI 格式的聊天补全端点降低集成门槛
潜在局限
- 第三方 API 依赖：所有功能依赖 safenet.one 服务端可用性，存在单点故障风险
- API 密钥安全：密钥仅在创建时显示一次，丢失需重新生成；泄露可能导致未授权交易操作
- 时区配置敏感：流式端点要求提供 IANA 时区名称，配置错误可能影响时间敏感型策略
- 流式解析复杂度：响应格式为自定义分隔符（
--breakpoint--）的 JSON chunks，需额外解析逻辑，非标准 SSE 或 WebSocket - 预测市场风险：涉及 Polymarket 等预测市场，受监管政策变化影响较大
适合人群
- 量化交易者和算法交易策略开发者
- DeFi 活跃用户，需要自动化 DCA 或代币分析
- 预测市场参与者（Polymarket、Rain 用户）
- 希望将 AI 交易能力集成到自有系统的开发者
常规风险
| 风险类别 | 描述 | 缓解建议 |
|---------|------|---------|
| API 密钥泄露 | 密钥 `noya_` 前缀标识性强，一旦泄露可能被针对性利用 | 使用环境变量存储，避免硬编码，定期轮换 |
| 服务端钓鱼 | safenet.one 域名非 noya.ai 官方域名，存在仿冒风险 | 核实 TLS 证书，从官方文档获取端点信息 |
| 交易执行风险 | AI 代理可能自主发起需确认的链上操作 | 生产环境务必处理 `interrupt` chunk 类型，实施人工确认机制 |
| 流式解析错误 | 自定义分隔符格式可能导致解析异常 | 严格遵循文档中的 JavaScript 示例实现，做好异常降级 |
| 时区相关 Bug | 时区配置错误可能导致 DCA 策略执行时间偏差 | 使用标准 IANA 时区库校验输入 |