SuperAPI AI 工具集

ontology

智能体与模型

查看项目

更新于 10-16 09:59

技能介绍

用途:Ontology 提供一套类型化词汇与约束系统,把知识表示为可验证的图谱。所有内容都是带类型、属性和关系的实体,每次变更在提交前都要通过类型约束校验。

主要能力:支持实体(id、type、properties、relations、created、updated)与关系(from_id、relation_type、to_id、properties);内置 Person、Organization、Project、Task、Goal、Event、Location、Document、Message、Thread、Note、Account、Device、Credential、Action、Policy 等类型。可用于“记住某事”、查询实体、建立关系、按项目遍历任务、查询依赖、把多步计划建模为图变换,以及让多个技能读写共享状态。

使用方式:默认存储于 memory/ontology/graph.jsonl,以 JSONL 记录 create、relate 等操作;查询可通过脚本或直接操作文件,复杂图谱可迁移到 SQLite。常用命令示例:python3 scripts/ontology.py create --type Person --props '{"name":"Alice"}';python3 scripts/ontology.py query --type Task --where '{"status":"open"}';python3 scripts/ontology.py related --id proj_001 --rel has_task;python3 scripts/ontology.py relate --from proj_001 --rel has_task --to task_001;python3 scripts/ontology.py validate。约束定义在 memory/ontology/schema.yaml,可声明必填字段、枚举、校验表达式、禁止属性,以及关系的 from_types、to_types、cardinality、acyclic。使用 ontology 的技能可在 SKILL.md 中声明 reads、writes、preconditions、postconditions。

适用场景:智能体结构化长期记忆、跨技能对象传递、把计划建模为图操作并按约束校验与回滚、记录因果操作日志等。

限制:凭据仅存 secret_ref,不应直接存密钥;约束或校验规则以 schema 为准。官方文本未提供更多安装或收费信息,暂未提供。