MINARA

触发 Team 例行任务

POST /v1/team/routine-hooks/:triggerId: 接收外部 JSON 事件,将指令加入 Team 队列。

POST /v1/team/routine-hooks/:triggerId

接收外部 JSON 事件,将配置的指令作为用户消息加入对应 Team 的队列。Team Coordinator 使用现有流程执行排队轮次。服务需要处于运行状态,并可通过本地网络访问;不提供云端中继。

方法POST
路径/v1/team/routine-hooks/:triggerId
认证不使用网关级认证
分类sessions

请求体

{ "event": "changed", "evidence": { "source": "https://example.com/item" } }

响应体

{ "automation_run_id": "run_123", "duplicate": false }

说明

此接口需要触发器专用密钥。JSON 对象不得超过 64 KiB。启用的例行任务最多接受 100 个排队轮次。

相同幂等键和等价 JSON 会返回原始运行 ID,duplicate=true,HTTP 状态码为 202。同一键对应的 JSON 发生变化时返回 409。未提供键时,每次调用独立处理。

HTTP 202 表示消息和轮次已持久化,Team 的工作可能尚未完成。原始 JSON 保留在服务端轮次上下文中,所有 Agent 均可访问;公开消息和历史响应不包含该数据。

暂停后拒绝新触发,已接受的轮次继续执行。轮换密钥后,旧密钥立即失效。

本页目录