ontology

• Вы хотите, чтобы агент запоминал структурированную информацию между сессиями (например, «Запомни, что Алиса владеет Проектом X»).
• Вам нужно связывать связанные объекты и обходить эти связи позже (например, «Покажи все задачи для проекта Z», «Что зависит от X?»).
• Нескольким навыкам нужно совместно использовать состояние без передачи сырого текста — один навык записывает Commitment, другой читает его как Task.
• Вы планируете многошаговую работу и хотите, чтобы каждый шаг был смоделирован как валидированное преобразование графа с откатом при нарушении ограничений.

• Вам нужен только эфемерный контекст на один запрос, и нет необходимости в сохранении данных между запусками агента.
• Ваши данные являются полностью неструктурированными (произвольный текст) без каких-либо значимых связей между сущностями, которые нужно моделировать.
• Вам нужна производительная графовая база данных с высокой степенью параллелизма — для больших или сложных графов сам файл SKILL.md рекомендует перейти на SQLite.

Поставляется с исчерпывающим набором предопределённых типов, охватывающих агентов (Person, Organization), работу (Project, Task, Goal), время и место (Event, Location), информацию (Document, Message, Note), а также ресурсы (Account, Device, Credential). Каждый тип содержит типизированные свойства и необязательные поля, что позволяет моделировать реальный мир без необходимости создавать схемы с нуля.

Каждая мутация проверяется на соответствие правилам, определённым в memory/ontology/schema.yaml, перед фиксацией. Ограничения включают обязательные поля, перечисляемые значения (enum), запрещённые свойства (например, блокировку необработанных секретов в Credential), правила типов и кардинальности отношений, проверки ацикличности, а также проверки временно́й корректности, такие как end >= start для Event.

Граф хранится в виде файла memory/ontology/graph.jsonl с режимом дозаписи — каждая операция создания, обновления и связывания добавляется как новая строка, сохраняя полную историю изменений. Для сложных графов SKILL.md рекомендует выполнить миграцию на SQLite, сохранив при этом тот же интерфейс.

CLI-инструмент scripts/ontology.py предоставляет команды для всех основных операций: create, query, get, related, relate, validate и schema-append. Это позволяет использовать его в скриптах из любого шага оболочки или действия агента без написания собственного кода для работы с графом.

Навыки могут объявлять контракт ontology в собственном файле SKILL.md, указывая, какие типы они reads (читают) и writes (записывают), а также предусловия и постусловия. Это делает межнавыковые зависимости данных явными и поддающимися аудиту, превращая ontology в типизированную шину сообщений между возможностями системы.

Многошаговые планы можно моделировать как упорядоченные последовательности операций над графом (CREATE → RELATE → CREATE …). Каждый шаг проверяется перед выполнением, а весь план может быть откатён при нарушении ограничений — это даёт агентам структурированный и прозрачный слой планирования.

Агент создаёт сущности Person и Project при первом их упоминании, а затем связывает их отношениями has_owner или has_member. В последующих диалогах запрос «Что я знаю об Алисе?» обходит граф и извлекает все связанные проекты, задачи и события — без обращения к истории переписки.

Навык чтения электронной почты извлекает обязательство из сообщения и записывает сущность Commitment в ontology. Отдельный навык управления задачами периодически запрашивает ожидающие объекты Commitment и автоматически создаёт связанные сущности Task — прямая связь между двумя навыками при этом не требуется.

Агент планирования моделирует проект как набор сущностей Task со связями blocks. Ограничение ацикличности предотвращает фиксацию циклических зависимостей, а запрос related мгновенно показывает, что должно быть выполнено до начала конкретной задачи.

Перед выполнением сложного рабочего процесса (например, «Запланировать командное совещание и назначить задачи по итогам») агент преобразует каждый шаг в валидированную операцию с графом. Если какой-либо шаг нарушает ограничение, вся последовательность откатывается, обеспечивая безопасный и проверяемый журнал выполнения через лог типа Action.