treg 异步任务 asynctasks 完整指南异步 API 如何自动结算与轮询【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg**treg 异步任务asynctasks**是 treg 平台里的结算 轮询引擎当第三方工具返回一个只有任务号、没有结果的异步 API 时treg 会先挂起预估金额再代你轮询直到按终态自动结算、退款或超时处理。本文用通俗的语言讲清楚异步 API 的归属与轮询逻辑。treg 是一个面向 Agent 的 API 网关OpenRouter for agent tools用一个 API Key 即可调用上百个 SaaS 数据工具的端点。其中不少端点是异步的——提交请求只拿到一个 task_id真正的结果要几分钟甚至更久之后才能取到。这笔钱怎么算谁来轮询产生的资源归谁asynctasks 模块回答的正是这三个问题。为什么异步 API 需要一本挂账同步调用中请求返回结果的那一刻就能完成计费。而异步调用里提交返回时还无法知道任务最终成功还是失败决定计费还是退款结果是否属于该团队决定资源归属结果地址还能活多久很多结果 URL 有时效。因此 treg 在接受提交请求后的第一步不是计费而是挂账从团队余额中扣下一笔预估金额存入 Hold 挂账表同时写入一条 AsyncTaskRecord 记录冻结下冻结字段作用task_id/poll_url任务号与轮询地址settlement_basis请求当时的完整定价规则保证结算与后续目录变更无关next_check_at创建 60 秒后首次检查tags归属快照避免日后靠成员关系反推归属 核心原则任务没结束钱就挂着——既不扣费也不退还。异步任务生命周期的四个状态状态机非常简单定义在 domain/asynctasks状态含义触发条件pending进行中持续轮询提交成功后的默认态settled已结算计费终态为成功或计费型失败released已释放退款终态为失败或挂账已被提前关闭timed_out已超时24 小时内观察不到任何终态pending是唯一的非终态。无论用户自己轮询还是后台 worker 轮询一旦确认终态该行就会在同一事务里关闭挂账不会二次结算。轮询 worker 怎么跑退避与并发控制 轮询由定时任务驱动treg-worker asynctasks settle入口在 worker.py。每轮 tick 的工作流程是挑到期任务选出next_check_at已到的pending行默认每轮最多 50 条并发控制全局最多 8 个并发轮询、单个 provider 最多 2 个防止某家供应商故障拖垮整平台乐观锁认领用attempts计数做栅栏令牌重复调度抢到的任务不会重复处理只认 2xx 为证据轮询返回 404/401 时哪怕响应体里写着 succeeded 也视为错误页——计费绝不能依赖错误页面的字段。轮询节奏随时间递增退避算法见 next_check首次重试30 秒后之后每轮 10 秒封顶 60 秒连续轮询出错时2 分钟、4 分钟、8 分钟封顶 15 分钟。自己轮询 vs 平台轮询归属怎么算 ⚖️不少用户提交后自己轮询比如用 CLI 直接调 poll 端点。treg 不禁止而是做归属对账资源归属在 treg 共享供应商账号上产生的任务号、文件 ID会写入 AsyncResourceRecord 表 并绑定提交团队——其他团队无法认领或消耗这些不透明 ID终态观察用户自己的轮询请求走正常调用路径时observe_owned_poll 会把它直接应用到原任务并完成结算而轮询请求本身永远不计费赢家记录证据只有第一个确认终态的一方用户或 worker归档终态响应晚到的重复轮询无法替换已被计费的结果。钱怎么结挂账、结算、退款 结算时按任务行上冻结的定价规则而非当时的目录价处理三种终局终态资金处理成功 / 计费型失败按实际用量结算若用量字段缺失按挂账额结算并打标记转人工复核失败全额退款给团队24 小时超时全额退款上游可能已发生的费用由平台吸收并标记人工排查24 小时规则MAX_AGE)体现不为未知结果收费若始终无法确认终态说明没人观察到用户是否拿到结果——此时全额退款、平台自己承担损失。挂账与结算的完整账本机制见 docs/context/architecture/money.md。在 CLI 与 Dashboard 里怎么用 ️CLI 前台阻塞等待执行treg call 异步端点时CLI 不会立刻退出而是按目录描述里的间隔在前景轮询实现见 async_bridge.py。等待预算耗尽时返回pending并附上任务号与一条可随时续查的恢复命令treg call 轮询端点 -p task_id你的任务号Dashboard活动页通过 views_for 展示每个异步调用的真实状态——挂账额、结算额、终态、结果地址以及文件类结果的取回命令和时效提示ttl_note。注意CLI 等待超时不等于任务失败。后台 worker 仍持有挂账会继续轮询直到终态结算结果会在活动页如实呈现。关键文件速查模块职责src/treg/application/asynctasks.py应用编排提交挂账、终态观察、worker 轮询、展示视图src/treg/domain/asynctasks/init.py纯语义状态机、退避算法、任务号提取与终态分类src/treg/application/call/async_bridge.pyCLI 前台阻塞等待超时可恢复src/treg/models.pyHold / AsyncTaskRecord / AsyncResourceRecord 三张核心表src/treg/worker.pyasynctasks settle定时入口总结treg 的异步任务机制可以浓缩为三句话请求路径只挂账、worker 负责轮询、结算只按终态证据发生一次。先挂账、后轮询、不确定就退款让没有 SLA 的异步 API 也变得可计费、可归属、可审计。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考