Palantir Foundry 深度研究(四):Action Types 与 Functions,让本体「能动手」

本体会说话还不够,得能动手。Foundry 把「动手」做成了两类一等公民:动作类型(Action Types)定义「世界允许怎么被改变」,函数(Functions)定义「世界怎么被计算」。本篇拆解它们的机制细节与写回链路——这是 Foundry 本体与「又一个语义层」拉开差距的地方,也是 Agent 时代最值得自建平台抄走的部分。

flowchart LR
  Caller[人 / 系统 / Agent] --> Params[Action 参数]
  Params --> Criteria[提交条件与权限]
  Criteria -->|通过| Edits[Create / Edit / Delete / Link]
  Criteria -->|拒绝| Deny[返回原因]
  Edits --> Funnel[Ontology 写入与索引]
  Edits --> SideEffect[Webhook / 通知]
  Query[Query Function 只读] --> Objects[Object Set 查询]
  Objects --> Caller
  OSDK[OSDK 类型安全客户端] --> Caller

Action Type 的四件套解剖

官方定义:动作类型是「一组用户可以一次性完成的对象、属性值与链接变更的 schema 定义」;一次动作(action)是「基于用户自定义逻辑、改变一个或多个对象属性的单个事务」。一次动作的执行由四个部件构成,缺一不可。

参数(Parameters)是动作的输入 schema:默认值、下拉选项、对象选择器,约束「调用者必须提供什么」。参数 schema 一旦定下,人、集成系统、Agent 三个调用方提交的是同一种结构化输入——不存在「Agent 专用旁路」。

编辑规则(Edits)是动作的语义本体:create、edit、delete、link 四类对象变更。规则可以直接写死(改某属性为参数值),也可以交给函数计算(function-backed action,支持批量执行)。官方示例动作 Assign Employee 很能说明「一个动作=一组编排好的世界变更」:改员工的 role 属性、自动建经理链接、通知新旧经理——一个动作类型声明了一个完整业务事实。

提交条件(Submission criteria,原名 validations)是闸门:决定动作能否提交的条件,把业务逻辑编入「数据编辑权限」。三类条件模板:Current user(用户 ID、群组、Multipass 属性)、Parameter(业务校验,如「库存调整量不超过当前库存」)、Execution context(是否在 Ontology Scenario 中评估——场景模拟里放行、生产环境拦截)。条件可用 all/any/none 算子组合,每个根级条件带失败提示文案。官方还留了一个安全警告值得抄进检查清单:避免对群组、标记、组织成员身份用 NOT 条件——当作用域 token 缺少这些属性时,NOT 判断可能意外放行。

副作用(Side effects)是动作的对外延伸:发通知、触发定时构建、调用 webhook。其中 webhook 的失败语义尤其要读准确:官方文档说明,Action 对 Ontology 的变更先发生,随后才执行副作用;webhook 是 best-effort,若外部请求失败,本体变更不会因此回滚,失败也不会显示给最终用户。因此它不是跨系统事务机制。若业务要求外部系统与本体严格一致,需要额外设计重试、幂等键、失败队列与人工补偿,而不能把 webhook 当作原子提交。

小结:动作类型把「一段业务操作」完整地声明成了类型——输入、变更、闸门、延伸,四个部件全部可校验、可审计、可复用。

写回:编辑数据的全部合法路径

动作提交之后,变更怎么落盘?这里有一条容易被误解的链路,值得完整捋一遍。

平台内路径:用户在 Workshop 或对象视图提交动作 → 编辑提交进 Ontology → OSv2 里由 Funnel 增量索引进对象数据库,可选地落到 materialization(物化)——这是 OSv1「writeback dataset」的继任者,且改为可选组件。物化的用途是给外部消费者一个「带编辑的最新对象数据」的导出通道;权威状态始终在对象数据库本身。

权限上有个精妙分离:看见对象走支撑数据源的权限,看见编辑记录走物化数据集的权限——「能看数据」与「能看谁改了数据」是两种独立授权,审计场景常常需要后者。

对外路径:本体 → 外部系统可由动作触发 webhook 副作用,但失败不回滚已提交的 Ontology 编辑;外部应用 → 本体则可走 OSDK 或 Ontology MCP 的受控动作调用。OSv2 对本体对象的用户编辑划出一条边界:「user edits via Actions」——旧版绕过 Action 的直接用户编辑方式不再支持。这里说的是本体编辑通道,不代表源系统、数据管道或管理员维护的其他数据变更也必须走 Action。对人和 Agent 而言,改变本体对象要先定义动作类型;底层数据接入与管道仍各有权威写入路径。

小结:写回链路的设计原则是「一个口子进(Actions),一个通道出(webhook/物化),权限双轨分离」——所有路径都可在审计日志里还原。

Functions:本体上的可执行逻辑

如果说动作类型是「动词的 schema」,函数就是「计算逻辑的运行时容器」。官方定义:函数让代码作者编写「可在运营场景中快速执行」的逻辑,在服务端隔离环境运行,并且对基于本体的逻辑提供一等支持——读属性、遍历链接、执行本体编辑。

函数与动作的分工有一条硬边界:查询函数(Query functions)是函数的只读子集,经 API 网关暴露,不能有任何副作用——要写库就必须走动作。装饰器风格一行看清:@Query({ apiName: "getCriticalAircraft" })。apiName 用 lowerCamelCase、小于 100 字符、全局唯一。

两个工程细节值得注意。一是版本语义偏弱:调用查询函数「永远使用最新打标的版本」——改了函数语义就相当于改了线上 API,官方的建议朴素到可爱:要改语义就复制成 ...V2。这与本体系列谈过的「本体版本演化」同款取舍:语义资产的重命名与重构都要额外小心,因为消费方是「最新版跟随」模式。二是消费面极宽:Workshop 的变量与图表聚合、function-backed 动作、Pipeline Builder 的 Python sidecar、流式函数(LLM 增量处理)、OSDK 场景模拟,以及 AIP Logic 与 Chatbot 的工具调用——函数是本体上「确定性计算」的统一出口,LLM 的非确定性推理与它互补(这个互补关系官方博客有专门论述,第八篇展开)。

小结:函数把「业务计算」从应用代码里抽出来挂在本体上;「查询无副作用、写经动作」这条分工是运营语义层的宪法条款。

OSDK:把本体变成类型安全的后端

Ontology SDK(OSDK)是本体的代码出口。官方定位一句话:把 Foundry 当后端,获得「大规模查询、写回与细粒度治理」。机制上,开发者在 Developer Console 创建应用,类型与函数直接从本体生成——对象类型、链接、动作、查询函数生成为目标语言的强类型代码,SDK 支持加 React 绑定。

语言矩阵:TypeScript(npm,TS OSDK 2.0 于 2024-10 GA)、Python(pip/Conda,2.x 于 2025-07 GA)、Java(Maven,2024-07 Beta),其他语言走 OpenAPI spec 生成。时间线从 2023-06 引入至今,两年多走完三语言 GA——本体作为 API 的成熟度曲线值得注意:它不是文档上的理想,而是被外部开发真实消费了两年的接口面。

鉴权模型是对「AI 时代权限」的一个直接回答:应用拿到的是双重作用域的 token——只限于应用申请的本体实体子集,再叠加使用者本人的权限。「应用能碰哪些类型」与「当前用户能看哪些对象」两层裁剪同时生效。但官方也诚实地标注了边界:这是读时强制(read-time enforcement only)——行/列级安全过滤的是读结果,「不延伸到 OSDK 响应载荷之外你的应用对数据做了什么」。也就是说,数据一旦离开平台,治理责任回到应用侧;这是所有「API 出口」的共同宿命,自建平台设计时要把它写进威胁模型。

配套的工程化玩法是 SuperRepo:本体即代码(ontology-as-code)模式——对象类型、链接、动作与函数声明在同一个代码仓库,本地生成 SDK、变更后自动再生成,免每次重新发布。本体的定义第一次有了与微服务代码同等的开发体验。

小结:OSDK 证明了本体可以像数据库一样被「客户端化」——类型生成、作用域 token、读写分离,熟悉的后端工程体验,陌生的语义层内核。

为什么「本体对象编辑走 Action」值得单独琢磨

把本篇的机制收拢回一个判断:OSv2 对本体对象的用户编辑要求通过 Actions,这是 Foundry 全部设计里最容易被误读的一条。它不等于「Foundry 的每一次数据写入都必须走 Action」——源系统、数据集构建与管理员维护仍各有写入入口;它强调的是人或 Agent 通过运营界面修改本体对象时,必须经过类型化的动作契约。

对于这一类用户编辑,动作类型把输入 schema、编辑规则、提交条件与权限裁决集中到一个可复用入口。应用不必各自实现一套「改对象」逻辑,Agent 也不需要一个绕过业务规则的特殊写 API。这样带来的收益是:校验更统一——提交条件作为动作闸门;审计更可追踪——Action Log 可记录成功提交的主体、对象与动作版本;调用方更一致——人、集成客户端和 Agent 可复用同一个动作契约。注意这不是自动保证所有调用都合规,配置者仍需正确设置对象权限、动作权限和数据授权。

前作《Agent 可靠执行》论证过「行动提议与权威执行分离」的闭环。Foundry 在本体用户编辑这一层展示了该闭环的产品形态:动作输入是结构化提议,提交条件负责校验,权限系统执行授权,Action Log 记录成功提交。自建平台不必照抄产品,但这四件套的职责分离值得原样进架构文档。

小结:对于用户或 Agent 对本体对象的运营编辑,动作类型回答了「谁能以什么条件改对象」;其他数据写入仍需按权威数据源与管道的治理规则设计。

参考资料

← 返回资讯列表

读者留言

COMMENTS 暂无
仅本站原创文章开放留言 · 请勿留下手机号、邮箱等个人信息

还没有留言,来说第一句?