SuperAPI AI 工具集

ontology

智能体与模型

查看项目

更新于 10-15 18:31

技能介绍

Ontology 是一个类型化词汇表与约束系统,用于把知识表示为可验证的图,适合作为智能体记忆与技能间共享状态的存储。核心概念是:一切皆实体,实体包含类型、属性与关系,每次变更在提交前都要通过类型约束校验。实体结构为 id、type、properties、relations、created、updated;关系结构为 from_id、relation_type、to_id、properties。

主要用途与触发场景:记录信息时创建或更新实体;询问某个对象已知信息时查询图;连接两个实体时创建关系;按项目列出任务或做依赖查询时进行图遍历;规划多步骤工作时把计划建模为图变换;技能需要共享状态时读写本体对象。内置类型涵盖人员与组织、项目/任务/目标、事件与地点、文档/消息/线程/笔记、账号/设备/凭据、动作与策略等。凭据类型只保存 secret_ref,不直接存密钥。

使用方式:默认存储为 memory/ontology/graph.jsonl,采用仅追加的方式记录操作(create、relate 等)。可用脚本或直接文件操作查询;复杂图可迁移到 SQLite。常用命令包括 create --type --props、query --type --where、get --id、related --id --rel、relate --from --rel --to、validate。约束定义在 memory/ontology/schema.yaml,支持必填、枚举、禁用属性、关系类型与基数、无环检查等。

限制:工作时对已有数据或模式应追加/合并不覆盖,以保留历史。校验覆盖属性、枚举、禁用项、关系类型与基数、标记为 acyclic 的无环性以及 Event 的 end >= start,更高层约束可能仅在文档中说明。快速开始需先建目录并创建 graph.jsonl;其他高级能力暂未提供。