用途:该技能是 Bankr Agent API 异步作业模式的完整参考,适用于构建异步作业工作流、实现轮询循环、处理作业状态转换、加工富数据以及管理会话线程。
核心模式为提交-轮询-完成:先 POST /agent/prompt 获取 jobId 与 threadId,再 GET /agent/job/{id} 每 2 秒检查状态,进入终态后处理 response 与 richData。
主要能力与用法:
- POST /agent/prompt:请求体含 prompt(必填,最长 10000 字符)与可选 threadId(续接已有会话)。
- GET /agent/job/{jobId}:查询状态。
- POST /agent/job/{jobId}/cancel:取消作业。
- 状态:pending、processing、completed、failed、cancelled。
- 返回字段:completed 含 response、richData、transactions、completedAt、processingTime;processing 含 statusUpdates、startedAt、cancellable;failed 含 error;cancelled 含 cancelledAt。
轮询最佳实践:间隔 2 秒,超时 5 分钟,仅展示新增的 statusUpdates,网络失败时按退避重试。
会话线程:提交后获得 threadId,后续请求带上它以延续上下文。
错误处理:400 输入无效或提示过长,401 鉴权失败,403 Agent API 未启用(需在 bankr.bot/api 启用),404 作业不存在,429 超出速率限制(按 resetAt 等待)。
限制:资料未提供官方文档之外的额外能力、收费或平台信息。