函数里改数据

函数怎样改数据

函数不直接写库。它返回一份「改动清单」：新建、修改、删除哪些对象，建立或解除哪些关系。这份清单只有被一个 Action 采用，才会真正生效。在开发环境里试跑一个改数据的函数，得到的只是清单，对象一点没变。

什么时候规则写不下？三种情形最常见：

• 要改的对象靠关系连着，个数运行时才知道，例如关掉一张订单下的全部工单；
• 要写的值得读好几个对象才算得出来，例如按各条产线的余量挑一条；
• 要一次新建几种对象，再把它们连起来。

这样的 Action 叫函数驱动的 Action。它依然受 Action 的上限约束（一次最多改 10,000 个对象、涉及 50 个对象类型），也受函数运行上限的约束。被批量触发时，函数默认按请求逐个调用；也可以让函数一次收到整批（入参是一个结构列表），更快，也少一些冲突。

Action 的 webhook 输入可引用参数、对象参数属性或字面量。规则和 side effect 还可用 $writeback.<输出名>。用函数计算 webhook 输入、用函数渲染通知正文仍待补，不能当成现有能力。

一个坑，和它的补救

坑：函数里改了对象，紧接着在同一个函数里搜索，搜到的还是旧数据。改动要等函数执行完才传到对象集接口；只有按主键取回你刚改的那个对象，才会看到新值。

补救：标准模型又提供了暂存写入（Beta）：改动先暂存，函数里之后的读取都看得到，也就是先写后读；函数成功结束、Action 完成时才一起提交；中途出错，暂存的全部丢弃。

在 AIDC 里：规则、对象集参数、先预演

AIDC 已支持编辑函数。用 aidc semantic functions publish edits.js --api-name holdWorkOrders --version 1.0.0 --output '{"type":"integer"}' --edit-function 发布。函数用 ctx.edits 收集改动，由调用它的 Action 统一提交。简单的批量修改仍可用规则：一个 Action 的多条规则在同一事务提交。参数可以是对象集，一条 modifyObject 规则就修改命中的对象。下面的 eachIs 要求每张工单都满足提交条件：

{
  "kind": "actionType",
  "apiName": "hold-work-order",
  "title": "Hold work orders",
  "schema": {
    "parameters": [
      { "name": "workOrders", "type": "objectSet", "objectType": "workOrder", "title": "Work orders", "required": true },
      { "name": "reason", "type": "string", "title": "Reason", "required": true, "maxLength": 200 }
    ],
    "rules": [
      { "type": "modifyObject", "objectType": "workOrder", "object": "$workOrders", "values": { "status": "paused" } }
    ],
    "submissionCriteria": [{
      "condition": { "type": "comparison", "left": { "param": "workOrders", "property": "status" }, "operator": "eachIs", "right": { "literal": "running" } },
      "failureMessage": "Only running work orders can be paused"
    }],
    "actionLog": true
  }
}

「个数运行时才知道」这个问题，在 AIDC 里这样解决：调用方把「这条产线上运行中的工单」这个对象集本身交给 Action，Action 在执行的那一刻才把它展开成具体的对象。提交条件也按展开时对象的当前值判断：上面的 eachIs 会确认每一张都还在运行中，只要有一张不是，整批被拒绝，什么都不改。一次最多改 10,000 个对象；applyBatch 一次最多 20 个请求，同在一个事务里。

没有暂存写入，就用三样东西拿到相近的保护：

• 只校验（$validateOnly）：逐项看参数和提交条件的结果，什么都不写；
• 工作流预演：读、算照跑，Action 只返回将要写入的计划；
• 草稿加批准：例如智能体起草一张采购订单，采购员用 approve-purchase-order 批准。