Factorial Action 是一个可供安装了 App 的客户在 Factorial 内直接调用的进程,用户无需知道 Factorial Code 的存在。一个进程对应一个动作,同一动作可同时通过多个入口暴露:Factorial UI 按钮、表单、Factorial One 工具、后端任务。无论入口为何,Factorial 都会把参数发给进程,并按需等待结果;进程不知道由哪个入口启动,因此一套实现服务所有入口。
配置位于进程 metadata.json 的 factorial 键,可由 fcode pull / fcode push 往返同步。当前可用:factorial 块(控制台、metadata.json、API 的 settings.factorial)、Actions API(列出公司动作、读取表单 schema、调用、签发上传授权、列出已声明动作)、requiredPolicies 在每次调用前强制执行、uiTrigger 按钮、form 表单、文件参数、uiTrigger.label 的 fcode.i18n 本地化、由保留 slug 推导的 lifecycleRole。agentTool 与 backend 已可存储但暂无助手读取工具契约。
注意事项:enabled 为总开关,false 时全部入口不暴露;awaitResult 默认 true(同步),旧 uiTrigger 默认即发即忘,同步动作需控制在约 50 秒预算内;requiredPolicies 的键为自由文本,拼错只会关闭动作;无策略即开放;只有 uiTrigger.label 可翻译;effect 未设置按 DESTRUCTIVE 处理;install、settings、uninstall、sync 四个 slug 为保留生命周期角色;fcode pull 会省略默认值。
factorial 块字段包括 enabled、awaitResult、requiredPolicies、uiTrigger、form、agentTool、backend。agentTool 契约字段有 description、effect(READ/WRITE/DESTRUCTIVE)、whenToUse、whenNotToUse、preconditions、doesNotDo、degradation、simulatesFor。参数由 parametersSchema.json 描述。factorial 块取代旧的 form 与 uiTrigger,二者仍保持镜像同步,新进程建议直接写 factorial。