常见问题
| 类别 | 问题 | 要点 |
|---|---|---|
| 架构 | SDK 和 LangChain? | 独立协议;可在 Executor 内调用任意框架 |
| 客户端 | Card 拉不到 | HTTPS、well-known 路径、CORS |
| 客户端 | 流式无事件 | 是否走 SSE;传输是否 supportsStreaming |
| 服务端 | Task 一直 working | Executor 是否发 terminal 事件 |
| 传输 | REST 与 RPC 混用 | 以 Card 声明为准,勿硬编码 |
| 任务 | 续聊失败 | contextId 是否一致 |
| 性能 | 连接多 | 复用 Client;缓存 Card |
| 安全 | 密钥泄露 | 仅 Header 传 token,勿写入 Message |
| 扩展 | 自定义存储 | 实现 TaskStore 接口 |
总结
排错链:Card → Transport → Task 状态事件 → Store。