语义层作为工具接口

定义

语义层作为工具接口是一种 Agent 架构设计范式：在 Agent 和底层系统之间插入一个语义中间层，Agent 通过这个语义层（而非直接 API 调用）来发现工具、获取上下文和执行操作。语义层将技术细节（数据库表、API endpoint）翻译为业务概念（订单、客户、审批），同时附带权限、验证和审计能力。

要点

• 核心主张：Agent 不应直接面对裸 API，而应面对一个"翻译层"，这个翻译层把"rows and columns"变成"nouns and verbs"
• 三重收益：工具发现（Agent 在统一命名空间中搜索可用操作）、权限内置（语义层强制执行访问控制）、幻觉抑制（结构化对象替代非结构化文本块）
• 与 接口厚度 的关系：语义层是一种"中等偏厚"的接口选择——牺牲部分可移植性，换取 Agent 推理时更丰富的上下文
• 不限于企业场景：个人 Agent 平台的 index.md（概念注册表）、schema.md（结构约束）、Skill 描述文件，本质上都是轻量级语义层
• 与 RAG 的对比：RAG 给 LLM 文本块让它"阅读"；语义层给 LLM 结构化对象让它"操作"——从"信息检索"进化为"语义操作"

示例

Palantir Ontology 是这一范式的重度实现：Agent 面对的不是 SQL 查询或 REST API，而是 Object Types（名词）和 Action Types（动词），由 OSDK 自动生成类型安全的操作接口。轻量实现的例子：OrbitOS 的 40_知识库/index.md 作为 Agent 查询知识库前的"语义索引"，让 Agent 不用遍历文件系统就能定位相关概念。

相关概念

• Palantir Ontology - 这一范式的企业级重度实现
• Ontology-backed Agent - 基于语义层驱动的 Agent 模式
• 接口厚度 - 语义层在接口厚度谱系上的定位
• 知识编译〔待补〕 - 语义层是知识编译的架构表达
• 渐进式披露 - Agent 通过语义层逐步发现上下文
• 协议层〔待补〕 - 语义层与协议层的互补关系
• Skills系统 - Skill 描述文件作为轻量语义层的组成部分

参考资料

• Ontology-Oriented Software Development - Palantir Blog
• Building with Palantir AIP: Logic Tools for RAG/OAG
• Palantir Ontology与Agent架构〔待补〕 - 完整研究笔记