跳转到内容

链式调用

有些动作需要两次调用:先准备草稿,再提交。链式调用让第一个操作指明第二个操作,aidy 在第一次调用成功后、模型开口之前直接执行它,参数取自第一次的结果。模型不需要在两次调用之间搬运 id,用户也能立即看到第二步的审批。

"/api/vm-drafts": {
"post": {
"x-aidy": {
"name": "prepare_vm_draft",
"description": "Prepare a new cloud server (VM) configuration.",
"effect": "create",
"approval": "never",
"next": {
"op": "commit_vm_draft",
"arguments": { "draft_id": "id", "revision": "revision" },
"when": { "status": "prepared" }
}
}
}
},
"/api/vm-drafts/{draft_id}/commit": {
"post": {
"x-aidy": {
"name": "commit_vm_draft",
"title": "Create server",
"confirmation": { "title": "Create server from draft {draft_id}?" }
}
}
}

当 prepare_vm_draft 返回:

{ "id": "d-7", "revision": 3, "status": "prepared", "name": "gpu-train-03" }

aidy 用 {"draft_id": "d-7", "revision": 3} 调用 commit_vm_draft。

键 含义
op 必填。下一步要执行的操作,必须在目录中存在且不是角色操作。
arguments 把下一次调用的每个参数映射到本次结果中的某个路径。
argumentsFrom 结果中的一个路径,该处的对象整体成为下一次调用的输入。
when 结果路径及其必须等于的值,否则链条终止。

路径用点分隔(draft.id、config.network.cidr)。

arguments 逐个字段构造输入。只要有一个映射路径在结果中不存在,链条就终止。

argumentsFrom 把一份准备好的配置整体拿来用。宿主返回下一次调用的确切输入,aidy 原样传递:

"next": {
"op": "create_vm",
"argumentsFrom": "config",
"arguments": { "project_id": "project_id" }
}

使用 argumentsFrom 时,arguments 可以补充对象中没有的值(比如路径参数),但不会覆盖对象已有的字段。如果该路径上不是对象,链条终止。

when 把结果中的每个路径与一个 JSON 值比较,所有条目都必须相等。如果草稿返回 "status": "needs_quota",链条终止,由模型读取结果并向用户解释。

下一个操作保留自己的审批策略。需要审批时,运行会立即以针对它的 aidy:approval 中断结束,模型还没来得及写任何内容。卡片上的参数是链条构造出的参数,与其他审批一样被冻结并计算哈希。见审批。

链条可以继续:下一个操作也可以有自己的 next。同一条链中每个操作最多执行一次,因此环路会自然结束。

next.op 引用的操作不存在或是角色操作时,目录校验失败。见目录。