Введение
Что такое Temporality, зачем он нужен и из чего состоит — десятитысячный обзор системы.

Temporality — открытая среда исполнения и контур управления для агентских систем: она выполняет долгие задачи, ведёт доказательную историю действий, держит под контролем права и надзор — и превращает проверенный опыт в знания и навыки, которые работают на следующих задачах.
Обычный чат-бот забывает всё между сессиями, а его «память» — свалка вставленных в контекст заметок. Автономному агенту в команде нужны и исполнение, и контроль, и обучение: задача должна переживать перезапуски, действия — оставлять доказательства, права — совпадать с оргструктурой, а ошибки — становиться опытом, а не повторяться. Temporality закрывает все четыре слоя одним self-hosted-стеком:
- Исполнение — долговременные задачи, делегирование подагентам, планы-графы, фоновые команды, подтверждения человеком.
- Наблюдение — событийный журнал, трассы, живая консоль команд, реконструкция причин.
- Контроль — возможности и политики, секреты, сетевые ограничения, сигналы поведения.
- Обучение — опыт → знания со статусом и происхождением → навыки → повторное использование.
Agent Kernel ──events──▶ Journal ──projection──▶ Knowledge / Hints
▲ │ │
└──────── hints ◀──────┴──── Experience Timeline ┘
#Ключевые идеи
- Запуск (run) — единица работы агента: durable workflow на Temporal, который переживает перезапуски, деплои и сон ноутбука. Каждый шаг журналируется.
- Знания с происхождением. Утверждения, извлечённые из траекторий, имеют автора, источник, статус жизненного цикла (предложено → подтверждено → оспорено…) и битемпоральную историю. Знание можно оспорить, исправить, инвалидировать — и увидеть, кем и когда.
- Подсказки (hints) — компактные выдержки релевантного опыта, которые система подставляет агенту перед задачей. Агент может раскопать полные первоисточники через инструменты исследования.
- Саги — явно отслеживаемая длительная работа, которая живёт дольше одного рана: продолжения чата, делегированные агенты и поправки присоединяются к саге автоматически.
- Артефакты — реестр документов (регламенты, требования, инструкции) с согласованием людьми и версиями: агенты подгружают их по требованию, и «смотри документ X» означает утверждённую людьми версию.
- Навыки (living skills) — переиспользуемые процедуры с контрактом (что умеет, когда применимо, что проверять), версиями, оценками качества и управляемой человеком эволюцией; навык ссылается на утверждённые артефакты как на справочные материалы.
- Контур качества — изменения агента применяются только поверх свежего зелёного оценочного прогона: эталонные кейсы, подтверждения человеком, судья-модель с калибровкой.
- Безопасность по умолчанию — песочница команд в Docker без сети и прав, подтверждения значимых действий человеком, секреты, которые агент не видит, RBAC и оргструктура.
#Из чего состоит система
| Компонент | Что делает |
|---|---|
| Agent Kernel | Среда исполнения агента: модельный шлюз, инструменты, песочница, делегирование, подтверждения, планирование |
| Journal | Append-only журнал событий; проекция знаний, подбор подсказок, битемпоральные запросы |
| Workspace (чат) | Диалог с агентом: стриминг, вложения, подтверждения, поправки к выполняющимся задачам |
| Debugger UI | Дашборд, трассы запусков, карта знаний, таймлайн опыта, навыки, артефакты, триггеры, администрирование |
| Control Plane | Пользователи, RBAC, оргструктура, токены |
Всё это поднимается одной командой docker compose up — PostgreSQL, Temporal, Journal, Kernel, UI и опциональные SearXNG + headless-браузер для веб-исследований.
#Для кого это
- Команды, эксплуатирующие агентов — видеть, что агент делал и почему, отвечать на вопросы «кто и что изменил», находить и чинить повторяющиеся ошибки.
- Команды, развивающие агентов — превращать опыт в проверенные знания и навыки, менять определения агентов безопасно, через контур качества.
- Организации — ограничивать агентов политиками, держать данные у себя, разделять доступы через оргструктуру.
#Где что смотреть
- Быстрый старт — поднять систему и запустить первую задачу.
- Работа с агентом — чат, подтверждения, поправки.
- Знания — как агент накапливает и теряет опыт.
- Раздел «Подробнее» в каждом материале ссылается на соответствующий инженерный документ в
docs/репозитория.