SuperAPI AI 工具集

agora-reporting

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

用途:把人类与智能体的工作汇入 Agora 共享协调流,用于上报编码智能体进展、问题、决策、阻塞、测试、PR、人际回复、收件箱指令与交接。若 AGORA_URL 未设置,则跳过 Agora 上报且不阻塞任务;服务端命令 post、inbox、status 需要 AGORA_URL,session 不联系服务器也不需要该变量。

必要条件:agora CLI 须在 PATH 中,示例使用 AGORA_REPORT="agora"。可用环境变量包括 AGORA_URL(服务器地址,如 http://127.0.0.1:8080)、AGORA_AGENT(actor 句柄)、AGORA_THREAD(默认线索)、AGORA_TOKEN(可选 bearer token)。

主要能力与事件类型:post 发布事件,session 创建会话线索,inbox 轮询收件箱,status 标记事件状态。推荐事件类型包括 summary、question、instruction、comment、decision、blocked、code_changed、tests_passed、tests_failed、pr_opened、review_received、ci_failed、ci_passed、ci_completed、handoff。

用法流程:若未指定线索,用 eval "$($AGORA_REPORT session)" 创建并在进程生命周期内保留 AGORA_THREAD。设置 AGORA_URL 后,会话开始上报任务摘要;在主要工作前与自然断点轮询收件箱,把人类定向回复、评论、决策、问题与指令视为当前任务的用户输入,先确认再处理并标记 done、resolved 或 rejected;共享或高风险编辑前上报 code_changed 或 summary 说明范围;阻塞时上报 blocked 与具体阻塞点及所需输入;请求输入用带 --target 的 question;验证后上报 tests_passed 或 tests_failed 及命令与结果;最终回复前上报 handoff 或 summary,含结果、验证与残余风险。示例命令如 $AGORA_REPORT post --type summary --title "Started task" --body "...",$AGORA_REPORT inbox,$AGORA_REPORT status <event-id> acknowledged。inbox 仅在需要已处理或关闭项时加 --all。

限制:保持帖子简短且有决策价值,不要粘贴原始日志,应摘要并链接或命名产物。资料未提供 Agora 服务器部署方式、认证之外的权限模型、收费或价格信息。