零点未来 · 技术科普

Palantir AIP Agent 与 Ontology
的交互机制

Agent 不直接访问底层数据库,也不自由扫描完整 Ontology schema。
它在一个被配置和授权的边界内,通过 Ontology 暴露的对象、关系、上下文、函数和动作完成业务交互。

LLM + Retrieval Context + Tools + Ontology + Governance

0. 核心结论

在 Palantir 体系里,Agent 不直接访问底层数据库表,也不自由扫描完整 Ontology schema。它是在被配置和授权的边界内,通过 Ontology 暴露的对象、关系、上下文、函数和动作完成业务交互。

Ontology 是企业业务世界的受治理语义接口;Agent 是通过自然语言使用这些接口的操作员。

你可以把 Ontology 理解为 Agent 的"操作系统"(AgentOS)——Agent 的一切能力都在 Ontology 这个受控边界内运行。

交互公式 · 数据流转
👤 用户消息 Context 注入 Tools 调用 LLM Ontology 查询/计算 Governance 约束 ✅ 审计与结果

各部分的分工:

1. Ontology 在 Agent 眼里是什么?

Ontology 语义层结构
Datasets · Virtual Tables · Models · Pipelines(底层数据资产) ONTOLOGY — 受治理的语义层 Semantic(描述世界) Object Types · Properties · Links · Interfaces Kinetic(改变世界) Actions · Functions · Automate · AIP Logic 🤖 AIP Agent / Chatbot

Palantir Ontology 是企业的 operational layer,坐在 datasets、virtual tables、models 之上,把底层数字资产映射成现实世界对象。它不是传统数据目录,也不只是知识图谱。

📋

Semantic Elements 描述业务世界

Object Types — Shipment, Order, Warehouse, Customer
Properties — status, ETA, priority, performanceScore
Links — Shipment → Order → Customer

解决:Agent 如何理解"企业里有什么,它们之间是什么关系"

⚡

Kinetic Elements 改变业务世界

Actions — updateShipmentETA, assignCarrier
Functions — calculateDelayRisk, optimizeSchedule

解决:Agent 如何从"回答问题"走向"执行业务"

关键理解:Palantir Ontology 的核心不是"把表换个名字",而是把企业的名词、关系、规则、动作和权限放到同一个受治理的语义层里。

2. Agent 与 Ontology 的交互分层

建议把交互分成五层来看:

1 Context Layer — 让 Agent 先看见相关上下文(系统确定性触发)
2 Query Layer — 让 Agent 主动查询对象和关系(LLM 自主决策)
3 Logic Layer — 让 Agent 调用函数、模型和业务逻辑(LLM 自主决策)
4 Action Layer — 让 Agent 执行受控业务动作(LLM 决策 + 可选用户确认)
5 Governance Layer — 约束 Agent 的权限、审计和安全边界(全链路贯穿)

3. Layer 1 · Context Layer(Retrieval Context)

Context Layer 的作用是:在用户每次提问时,系统自动给 Agent 提供相关背景。关键特征:确定性触发 — 每条用户消息到达时自动执行,不依赖 LLM 自己判断要不要检索。

Retrieval Context 的三种类型
👤 用户消息到达 系统自动触发(不经过 LLM) 📋 Ontology Context 固定对象 / 语义搜索 从 Object Type 检索 📄 Document Context 全文 / 语义 Chunk 从文档检索相关内容 ⚙️ Function-backed Context 自定义 TypeScript 检索 多数据源拼装 注入 LLM Context

3.1 Ontology Context

从 Object Type 检索对象,支持固定对象集(Variable Input)和语义搜索(Vector Embedding)两种方式。

📌 固定对象集 — 仓库调度助手

配置:Object Type = Warehouse,绑定 Workshop 页面当前选中 Warehouse
效果:用户在 Workshop 选中"华南仓"后打开 Agent → Agent 自动拿到容量、积压量、负责人等信息 → 用户直接问"现在积压情况怎么样?"

秘书在老板走进会议室前,已经把这个客户的档案放到桌上了。老板不需要说"帮我找一下档案",坐下就能直接谈事。
🔍 语义搜索 — 客户投诉处理助手

配置:Object Type = CustomerComplaint,语义搜索 K=5
用户问"有没有客户反映过冷链断链导致货损的情况?"→ 系统自动向量化问题 → 搜索 embedding → 返回 5 条最相关历史投诉 → LLM 直接总结

图书管理员听到你的问题后,自动从书架上抽出最相关的 5 本书放到你面前。你不需要自己去找书,直接翻阅就行。

3.2 Document Context

从文档中检索相关内容,支持全文模式和语义 Chunk 模式两种方式。

📄 全文模式 — 合同条款审查

配置:关联 Foundry 文档集,全文检索
效果:用户问"这份承运合同中关于延误赔偿的条款是什么?"→ Agent 直接拿到完整合同文本 → LLM 定位并解释相关条款

🔍 语义 Chunk 模式 — 多文档精准定位

配置:关联多个合同/文档,语义搜索 K=3
用户问"承运商 A 的延误赔偿条款和免责条件"→ 系统自动从三份合同中搜出最相关的 chunk → LLM 直接对比分析

图书管理员听到你的问题后,自动从书架上抽出最相关的 5 本书放到你面前。你不需要自己去找书,直接翻阅就行。

3.3 Function-backed Context

当内置检索不够用时,用 TypeScript 写自定义检索函数。函数输出 retrievedPrompt 字符串注入 LLM context。适合多数据源、多检索策略、多业务规则组合的复杂企业场景。

🎯 客户 360° 视图助手

场景:用户问"这个客户最近情况怎么样?"
自定义函数同时拉取:CRM 沟通记录 + Ontology 活跃订单 + 语义搜索投诉工单 → 拼装成综合情报注入 LLM

秘书在老板开会前,同时打电话给销售部、客服部和法务部,把各方信息汇总成一页纸摆到桌上。

4. Layer 2 · Query Layer(Object Query Tool)

Context Layer 是系统自动注入;Query Layer 是Agent 主动查询。Object Query Tool 允许 LLM 在配置边界内访问指定 Object Types 和 Properties,支持 filtering、aggregation、inspection、traversal of links。

Object Query 工作流程
LLM 决策查询 "我需要查..." Object Query Tool • Filter: status="delayed" • Aggregation: COUNT, GROUP BY • Link Traversal: Ship→Order→Cust Ontology • Object Types & Links • Properties & Values • 基于语义对象,非 SQL 📊 结构化查询结果 + Citations 点击可跳转到具体 Ontology Object 来源

三种典型查询模式

🔢 多条件过滤 + 聚合

"今天华南仓有多少个延误的高优先级订单?" → Filter: region="华南" + delayed + high priority → COUNT → 7
追问"哪几个是 VIP 客户?" → 沿 link Shipment→Order→Customer → Filter: serviceLevel="VIP" → 3 个

老板在开会时自己翻资料,先按地区筛订单,再追问"哪些是大客户"。资料一直在桌上,但翻哪页、怎么筛,是老板自己决定的。
🔗 Link 遍历 — 追溯问题根因

"订单 ORD-8832 的延误是哪个环节出的问题?" → 沿 link 逐层:Shipment → Carrier(履约率 72%)→ TransitHub(拥堵等级 high)→ 综合判断:车辆故障 + 中转枢纽拥堵

侦探沿线索链逐步追查 — 从案件到嫌疑人,从嫌疑人到同伙,从同伙到据点。每一步都是"顺着关系往下查"。
📊 聚合 — 运营概览

"各区域仓库积压情况对比?" → Group By: warehouse.region, Aggregation: COUNT(status="pending_dispatch") → 华南 42 / 华东 28 / 华北 15 / 西南 8

管理层要一张各区域的"红绿灯"看板 — 不看具体每一单,只看汇总数字,一眼判断哪里需要关注。

5. Retrieval Context 与 Object Query 的关键区别

这是设计 Agent 时最容易混淆的一点。

维度Retrieval ContextObject Query Tool
触发方式每条用户消息自动触发LLM 自己决定是否调用
可靠性确定性更强依赖 LLM 判断,存在漏查风险
适合内容当前业务对象、关键背景、必须看到的信息探索性分析、临时查询、多轮追问
风险配置不当带来 token 浪费或上下文噪声LLM 可能忘查、查错、查不全
设计原则:什么放哪里?
🔒 Retrieval Context 系统每轮自动注入 • 当前用户正在操作的 Warehouse • 今日 KPI 快照(出库量/积压/异常) • 用户角色和权限等级 → 确保 Agent 始终知道"在跟谁说话" 🔎 Object Query Tool LLM 按需调用 • "对比华南和华东仓的积压情况" • "这个承运商过去 30 天表现?" • "SH-0042 现在到哪了?" → 临时提出的、无法提前预测的探索性查询
Retrieval Context 是固定在工位上的监控大屏 — 永远开着,永远显示关键指标。Object Query 是你手里的对讲机 — 需要的时候才拿起来问一句"3 号仓现在什么情况"。

6. Layer 3 · Logic Layer(Function Tool + AIP Logic)

Agent 查询到对象后,需要调用封装好的业务逻辑,而不是让 LLM 自己"脑补规则"。分工原则:LLM 负责理解意图、选择函数、解释结果;Function 负责执行业务规则、调用模型、做优化计算。

Function Tool 调用流程
LLM 选择函数 "调用风险评分" AIP Logic Function 1. 查询历史延误数据(过去 90 天) 2. 读取承运商当前履约评分 3. 调用天气 API(目的地未来 24h) 4. 运行延误概率预测模型 5. 综合打分 → high / medium / low 结构化结果返回 LLM LLM 用自然语言解释

三个典型例子说明为什么不能让 LLM 自己算:

🎯 风险评分 — calculateDelayRisk

没有 Function:LLM 只能模糊判断"看起来有风险"。
有了 Function:函数内部整合历史数据 + 履约率 + 天气 + 预测模型 → 精确输出 high/medium/low + 原因

老板让专业分析师出一份风险报告,而不是自己拍脑袋猜"大概有风险吧"。分析师用数据、模型和历史经验算出来的结论,比直觉靠谱得多。
📧 跨对象业务逻辑 — recommendResolution

输入 Shipment object + 客户投诉邮件原文 → AIP Logic 提取情绪和诉求 → 查询历史处理方案 → 输出建议方案 + 历史成功率

📐 优化类计算 — optimizeCarrierAllocation

50 个订单 + 3 个承运商 + 成本/时效约束 → 线性规划模型 → 最优分配方案 + 预估成本 ¥84,200

调度经理把需求表交给运筹学专家,让专家跑优化模型。经理不需要自己会线性规划,只需要看懂结果、决定是否执行。

7. Layer 4 · Action Layer

Action Layer 是 Agent 从"问答助手"变成"业务操作员"的关键。Action Tool 让 Chatbot 执行 ontology edit,可配置为自动执行或用户确认后执行。

Action 执行流程 — 高风险需确认 vs 低风险自动执行
⚠️ 高风险操作 LLM 生成 Action 用户确认? ✓ 确认执行 Ontology 写入 + 审计 例:换承运商(涉及合同和成本) 🟢 低风险操作 系统/函数检测触发 自动执行 直接完成 例:天气延误 <4h 自动更新 ETA
自动驾驶在简单直道上自主调整车速,不需要驾驶员每次点确认。但遇到复杂路口(高风险操作),系统会把控制权交回给人。

辅助工具

护士在给药前再确认一遍:"您说的是左手还是右手?"宁可多问一句,也不在不可逆操作上犯错。

8. Layer 5 · Governance Layer

Governance 是 Palantir AIP 和普通 Agent 框架的核心差异之一。它不是单独的一步,而是贯穿全链路的约束机制。

Governance 全链路约束
Retrieval Context 配置 → 控制 Agent 每轮默认能看到什么 Object Query 配置 → 控制 Agent 可以主动查询哪些 object types 和 properties Function 配置 → 控制 Agent 可以调用哪些业务逻辑和模型 Action 配置 → 控制 Agent 可以执行哪些业务变更,是否需要人工确认 Security / Permission / Dynamic Security / Audit / Lineage 全链路 审计日志:谁 · 何时 · 哪个 Agent · 做了什么

同一 Agent,不同角色 — 权限分层示例

👷 一线调度员

L1: 只注入 3 条线路 Shipment
L2: 只能查这 3 条线路
L3: 可用 calculateDelayRisk,不能 viewProfitMargin
L4: updateETA 可自动,assignCarrier 需确认
L5: 所有操作记录到审计日志

👔 区域经理

L1: 注入整个华南区域 Shipment 概览
L2: 可查所有线路 + 承运商绩效
L3: 可用 viewProfitMargin + optimizeAllocation
L4: assignCarrier 无需确认,但 cancelOrder 仍需确认
L5: 同样审计,但权限范围更大

同一栋大楼,实习生只有自己楼层的门禁卡,总经理有全楼门禁卡。但地下金库两个人都需要双人认证才能进 — 权限分层,高风险区域额外保护。

防幻觉的 Governance 约束

用户问"公司今年总营收多少?" → 没有 Governance 的 Agent 可能"脑补"一个数字 → 幻觉。但有了 Governance:

L1 没配置财务 Context → L2 没 FinancialReport Object Type → L3 没授权财务 Function → Agent 只能诚实回答:"我没有权限访问公司财务数据"

不是在考场上贴"禁止作弊"的标语,而是直接不把答案带进考场。Agent 不是"被告知不能说",而是"根本接触不到那些信息"。

9. Tool Calling Mode:工具如何暴露给 LLM?

Prompted Tool CallingNative Tool Calling
适用范围所有模型 + 所有工具类型部分 Palantir 模型 + Action/Object Query/Function/Update App Var
调用方式一次一个 tool可并行调用多个 tool
适合场景模型兼容性优先性能优先、token 效率优先

关键澄清:Palantir 不是把整个 Ontology schema 全量塞进 system prompt。更准确的理解是 — 在具体 Chatbot / Application / Workflow 中,被配置、被授权、和当前任务相关的 Ontology 能力,以工具说明、上下文片段、函数签名、动作定义等形式暴露给 LLM。

10. 一次端到端交互链路

下面用一个物流延误风险场景串联全部五层。以下流程是基于官方文档所做的推演,数字均为业务示例值。

端到端交互流程 · 6 步串联
👤 "帮我看看今天华南仓哪些订单有延误风险?" → 用户消息到达 Step 1 · Context Layer [系统级 · 确定性触发] Ontology Context: 语义搜索 → Top-10 Shipment 注入 LLM → LLM 未参与决策 Step 2 · Query Layer [LLM 决策 · 可能多轮] Object Query 1: Filter warehouse="华南仓" + in_transit/delayed + ETA<today → 23 Shipment | Query 2: Link遍历 → Order → Customer Step 3 · Logic Layer [LLM 决策] calculateDelayRisk(23 shipments) → 5 high-risk | recommendResolution(5 high-risk) → 建议换承运商/拆单/通知客户 LLM 生成回答 [推理 + Citations] "23 个 Shipment,5 个高风险:SH-0042 建议转派… 是否执行?" Step 5+6 · Action + Governance [LLM 决策 + 用户确认 + 系统级] assignCarrier(SH-0042, CarrierB) ✓ | createExceptionCase(SH-0119) ✓ | Audit: jing.wang 14:32 CST → Ontology 更新
交互链路总结
👤 用户消息 Layer 1: Context [系统级 · 确定触发] Ontology / Document / Function Context → 注入 LLM Layer 2: Query [LLM 决策] Object Query → 过滤 / 聚合 / 遍历 Links Layer 3: Logic [LLM 决策] Function Tool → 业务逻辑 / 模型推理 / AIP Logic Layer 4: Action [LLM 决策 + 用户确认] Action / Command / Update App Var → Ontology Edit Layer 5: Governance [全链路贯穿] 权限校验 / 审计日志 / Lineage / 应用状态同步 ✅ 业务操作完成 + 审计记录

11. 内部 Agent 与外部 Agent

上述五层架构主要描述内部 Agent(AIP Chatbot Studio / Workshop / AIP Logic)。外部 Agent 接入时需区分两个机制:

🔧 Palantir MCP

面向:开发者 / Ontology Builder
能做:修改 Ontology 类型定义(结构)
不能做:写入 ontology 数据(硬约束)
约束:所有修改需 proposal review + 人工审批

🌐 Ontology MCP (OMCP)

面向:外部业务 Agent / Headless Agent
能做:读取对象、执行 action、写入数据
不能做:修改 Ontology 类型定义
约束:application restrictions + OAuth 2.0

核心原则不变:Agent 通过受治理的 Ontology 接口访问对象、关系、函数和动作,而非绕过 Ontology 直接访问底层数据。

12. 最小可工作版本设计

如果要设计一个类似 Palantir Ontology-aware Agent 的最小版本:

最小架构 · 9 个核心组件
1. Ontology Schema Registry 2. Tool Registry 3. Context Builder 4. Object Query Tool 5. Function Tool 6. Action Tool 7. Permission Evaluator 8. Audit Logger / Lineage Tracker 9. Application State 最小链路:User Message → Context Builder → LLM → Object Query → Function → Response → Confirmation → Action → Edit → Audit

13. 总结

Palantir AIP Agent 与 Ontology 的交互,不是简单的 RAG 架构,也不是 LLM 直接查数据库。它是一个五层协同的 enterprise agent runtime:

🔍
Context Layer — 系统确定性提供上下文,确保 Agent 不会"两眼一黑"
🔎
Query Layer — Agent 主动查询对象和关系,支持探索式分析
⚙️
Logic Layer — Agent 调用封装好的业务逻辑和模型,避免 LLM 脑补规则
⚡
Action Layer — Agent 执行受控业务变更,从问答走向执行
🛡️
Governance Layer — 全链路权限、审计和安全约束,确保企业级可控

真正值得借鉴的不是某一个 tool,而是这套设计思想:

把企业业务世界先建模成可查询、可计算、可执行、可治理的 Ontology,再让 Agent 在这个受控语义层上工作。

参考文档

页面URL
AIP Overviewpalantir.com/docs/foundry/aip/overview
AIP Architecturepalantir.com/docs/foundry/architecture-center/aip-architecture
AIP Featurespalantir.com/docs/foundry/aip/aip-features
Chatbot Studio Toolspalantir.com/docs/foundry/chatbot-studio/tools
Chatbot Studio Core Conceptspalantir.com/docs/foundry/chatbot-studio/core-concepts
Retrieval Contextpalantir.com/docs/foundry/chatbot-studio/retrieval-context
AIP Logic Overviewpalantir.com/docs/foundry/logic/overview
Ontology Systempalantir.com/docs/foundry/architecture-center/ontology-system
Ontology Overviewpalantir.com/docs/foundry/ontology/overview
Palantir MCPpalantir.com/docs/foundry/palantir-mcp/overview
Ontology MCP (OMCP)palantir.com/docs/foundry/ontology-mcp/overview
Model Integrationpalantir.com/docs/foundry/model-integration/overview

数据来源:Palantir 官方文档(截至 2026 年 6 月)。推断性内容已在文中标注,数字均为业务场景示例值。

← AI 战略认知 · 全部文章