链式调用
有些动作需要两次调用:先准备草稿,再提交。链式调用让第一个操作指明第二个操作,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
Section titled “arguments 与 argumentsFrom”arguments 逐个字段构造输入。只要有一个映射路径在结果中不存在,链条就终止。
argumentsFrom 把一份准备好的配置整体拿来用。宿主返回下一次调用的确切输入,aidy 原样传递:
"next": { "op": "create_vm", "argumentsFrom": "config", "arguments": { "project_id": "project_id" }}使用 argumentsFrom 时,arguments 可以补充对象中没有的值(比如路径参数),但不会覆盖对象已有的字段。如果该路径上不是对象,链条终止。
when 把结果中的每个路径与一个 JSON 值比较,所有条目都必须相等。如果草稿返回 "status": "needs_quota",链条终止,由模型读取结果并向用户解释。
审批依然有效
Section titled “审批依然有效”下一个操作保留自己的审批策略。需要审批时,运行会立即以针对它的 aidy:approval 中断结束,模型还没来得及写任何内容。卡片上的参数是链条构造出的参数,与其他审批一样被冻结并计算哈希。见审批。
链条可以继续:下一个操作也可以有自己的 next。同一条链中每个操作最多执行一次,因此环路会自然结束。
next.op 引用的操作不存在或是角色操作时,目录校验失败。见目录。