动作类型详解
分支动作（Branching action types）
想试跑一个动作又怕改坏生产数据？分支（branching）让动作在隔离环境里运行与验证，合入 main 前绝不污染生产。这一篇讲清怎么用。
本文来源 · Source
内容整理自 Palantir Foundry 官方文档：
https://www.palantir.com/docs/foundry/action-types/branching-action-types/
原始标题：Branching action types
https://www.palantir.com/docs/foundry/action-types/branching-action-types/
原始标题：Branching action types
1
什么是分支动作（branching action）
本体动作与 Global Branching 集成，让你在分支上"安全地试"。
本体（Ontology）动作与全局分支（Global Branching）集成，让你能在分支（branch）上测试动作类型，而不影响生产环境。你可以在合入 main 之前，先在隔离的分支上下文里运行动作、校验配置、观察编辑结果。
"Ontology actions integrate with Global Branching, enabling you to test action types on a branch without affecting your production environment."本体动作与全局分支集成，使你能够在分支上测试动作类型，而不影响生产环境。
铁律：分支上的动作编辑仅供测试，不会被合并回
main。分支上产生的编辑不会随合并进入生产。2
在分支上运行动作
要跑得起来，有一个前置条件：相关对象类型必须先"建索引"。
前置相关对象类型必须已建索引
动作修改的所有对象类型，都要在该分支上完成索引（index）。
可以在单个对象类型页面，或在 Ontology Manager 的动作类型页面为相关对象类型建立索引。若动作修改了尚未建索引的对象类型，编辑动作类型时会出现警告。
未就绪索引未完成就运行 → 编辑不被应用
动作有效，但写不进去，只弹提示。
如果对象类型尚未建索引就运行动作，动作不会应用其编辑。提示（toast）会说明：动作有效，但它编辑的某些对象类型在分支上是只读的，并链接到 Ontology Manager 让你先建索引再重跑。
提示：在分支的 Workshop 模块里试跑动作，是验证配置是否正确的最常用方式。但请始终记住：分支上的编辑不会合并回
main。3
函数后端动作与"分支感知"
函数后端（function-backed）动作在分支上的行为，取决于它是否"分支感知"。
BRANCH-AWARE · 分支感知
分支感知函数
可在分支上被修改。
从分支读取 schema。
仍在分支上执行，不写回 main。
vs
NON-BRANCH-AWARE
非分支感知函数
不能在分支上被修改。
只从 main 读取 schema。
同样只在分支执行，不写回 main。
提示：无论是否分支感知，所有函数后端动作都只在分支上执行，不会把改动写回
main。支持的函数类型见 Global Branching 文档。4
管理分支上的副作用（side effects）
默认情况下，分支上"什么外部动作都不发生"——这是安全设计。来亲手感受一下。
互动实验：分支上跑动作，外部系统会被碰到吗？
你在分支上执行一个带 webhook 的动作。默认分支上 webhook 不执行。
三类副作用在分支上的默认行为（点击每行右侧匹配）：
注意：一旦在分支上"开启"这些副作用，它们会完全像在
main 上一样执行——如果 webhook 配置打向生产外部环境，即使在分支运行也会打到生产。开启前务必想清楚。5
要点小结
确认你真正理解了分支动作的边界。
点击揭晓：在分支上开启 webhook 后，如果它本就指向生产外部系统，会发生什么？
点击这里揭晓 →
一页带走
① 分支 = 安全沙盒
在分支测试动作，不影响生产，编辑不合并回 main。
② 前置：建索引
动作修改的对象类型都需在分支上建索引，否则编辑不应用。
③ 函数分支感知
分支感知函数可在分支改、读分支 schema；都只在分支执行。
④ 副作用默认关闭
webhook / 外部调用 / 通知默认不执行；开启则照打生产。
延伸阅读 · 相关页面
按主题横向跳转，不必顺着目录一篇篇读。