基于 Palantir Foundry 官方设计指南与行业实践经验,构建"像真实世界一样直观"的企业知识图谱。
四项原则按优先级排序,七个典型反例正反对照呈现。
Domain-Driven Design — 本体论建模真实世界,而非源数据
本体论的对象应代表语义上有意义的真实世界概念(如"患者""工单""船舶"),而非数据库表、API 响应或电子表格标签页。 链接应代表真实关系(如"该患者到访了该设施"),而非外键或 JOIN 关系的产物。
拿到一个数据集或 CSV,不做任何领域分析,直接将每一列映射为一个属性,把技术元数据(_crm_extracted_at、_crm_sequence)混入业务模型。源数据长什么样,本体论就长什么样。
// 一个 CSV 行 → 一个对象类型,所有列直接映射
OrderData {
order_id, customer_name, customer_email,
product_sku, quantity,
_crm_extracted_at, _crm_sequence, // 技术列也混入
}
先理解领域,再设计模型,最后映射数据源。一条 CSV 可能隐藏了多个实体(订单、客户、产品),需要拆分为独立对象类型并用语义链接关联。技术元数据留在后台数据集,不进入本体论。
// 从同一个 CSV 中识别出三个实体
Order { order_id, quantity } → 链接到 Customer、Product
Customer { name, email }
Product { sku }
// 技术列只存在于后台管道中,不出现在本体论
| ❌ 典型反例:从数据出发 | ✅ 正确模式:从领域出发 |
|---|---|
| 看到数据集 → 直接建模 | 理解领域 → 设计模型 → 映射数据 |
| 属性从源字段 1:1 映射,无筛选 | 属性经过精心筛选,只保留有业务含义的字段 |
| 命名使用源系统缩写(dtLastInspMod) | 命名使用业务语言(lastInspectionDate) |
| 一个 CSV 行直接变成一个对象类型 | 一条数据可能拆分出多个实体(订单→客户+产品+订单) |
| 技术元数据(_crm_extracted_at)混入业务模型 | 技术元数据留在后台数据集,不出现在本体论中 |
🎯 判断标准:一个用户或 AI 代理应该能够无需查阅文档,仅凭直觉就能在本体论中导航——因为它的结构匹配他们对领域的认知方式。
Don't Repeat Yourself — 同一实体只建一次,三次出现则重构
重复的对象类型、冗余的属性和复制粘贴的工作流是维护噩梦和上下文管理问题——对人类和 AI 代理都是如此。 目标是每个概念有唯一的规范化表示,每个操作有唯一的规范化工作流。
三个部门各自独立创建客户对象类型:Sales Customer、Support Customer、Billing Customer——每个都有 name/email/phone,加上各自的特殊字段。三套 Action、三套维护负担,同一客户信息还不一致。
Sales_Customer { name, email, phone, dealSize }
Support_Customer { name, email, phone, ticketHistory }
Billing_Customer { name, email, phone, paymentMethod }
// 同一客户在三个类型中都有记录,信息不一致
创建单一规范化 Customer 类型(方案 A),或使用 Interface 定义共享形状(方案 B)。一次出现是巧合,两次形成模式,三次必须重构。
// 方案 A:单一规范类型(推荐大多数情况)
Customer { name, email, phone, lifecycleStage }
// 方案 B:接口共享(类型形状确有本质差异时)
interface CustomerBase { name, email, phone }
SalesLead implements CustomerBase { + dealSize }
SupportContact implements CustomerBase { + ticketHistory }
Open for Extension, Closed for Modification — 保护核心模型,让构建者扩展它们
一旦一个对象类型、接口或工作流经过验证并投入生产,其核心结构就应保持稳定。 其他团队应该能在不修改核心模型的前提下,通过扩展来添加新能力。
新需求来了就往核心类型上塞属性。Equipment 类型本来只有基本字段,后来加入了认证信息、维护记录、财务折旧……最终膨胀为 150+ 属性、大部分为 null 的"万能对象"。
Equipment {
serialNumber, model, location, // 核心
certificationAuthority, certExpiry, certStatus, // 认证团队加的
depreciationMethod, bookValue, fiscalYear, // 财务团队加的
lastMaintenanceDate, mtbf, sparePartsList, // 维护团队加的
// ... 150+ 属性,大多为 null
}
核心类型保持精简,通过链接扩展类型和接口实现来添加新能力。核心类型不受影响,新能力按需扩展。
// 核心类型保持稳定
Equipment { serialNumber, model, location }
// 认证能力:链接到扩展类型
Equipment → EquipmentCertification { authority, expiry, status }
// 可巡检能力:实现接口
Equipment implements Inspectable { lastInspectionDate, inspectionStatus }
Composition over Deep Hierarchies — 多接口实现,保持可插拔
Foundry 本体论支持通过接口实现多重继承——一个实体可以从多个聚焦的抽象中组合行为, 而不需要陷入单一继承链的泥潭。
💡 关键洞察:构建在 SchedulableResource 接口上的工作流,不做任何修改就能用于 Arena、会议室和车辆——深层继承链永远做不到这一点。
除了四项核心原则,Palantir 还提供了四个关键的结构设计模式,它们是本体论的"语法规则"。
"每个事实只存一次。用派生属性提供便利访问。"
| ❌ Manager.directReportCount = 5(手动维护整数) |
| ✅ Manager.directReportCount = 派生属性(自动计数) |
| ❌ Employee.managerName = "Alice"(复制值) |
| ✅ Employee → manager(链接,自动获取 name) |
⚠️ 超过 ~10k 对象/查询时,考虑有意识地反规范化。
"将语义相关的字段组合为
开通月度会员,继续阅读本篇剩余内容。