> Перевод даётся для удобства чтения. Нормативным является английский оригинал. # Паттерны интеграции ИИ **Спецификация Мета-Вселенной** **Идентификатор документа:** MU-V2-GUIDE-009 **Название:** Паттерны интеграции ИИ **Класс документа:** информативный **Версия:** 2.0 (черновик) **Статус:** рабочий черновик **Нормативные ссылки:** нет **Информативные ссылки:** [AI-Agent-Guide](../07-guides/AI-Agent-Guide.md), [Contract](../04-core-concepts/Contract.md), [Projection](../04-core-concepts/Projection.md), [Event](../04-core-concepts/Event.md), [Provenance-Graph](../02-architecture/Provenance-Graph.md), [MMAS-Interchange](../02-architecture/MMAS-Interchange.md) **Копирайт:** © Orkestron.AI **Лицензия:** Apache-2.0 --- # 1. Назначение Это руководство даёт **конкретные паттерны** построения ИИ-агентов на Мета-Вселенной. Оно есть реализационный спутник [руководства по ИИ-агентам](../07-guides/AI-Agent-Guide.md): там объясняются цикл рассуждения и принципы, здесь же показано, как подключить настоящего агента на языковой модели - схемы вызова инструментов, RAG, принудительный Контракт внутри цикла агента, векторные и графовые хранилища - к этим принципам. Паттерны исходят из того, что агент использует языковую модель как *машину рассуждения*, а не как хранилище знания: знание, правила и история живут в управляемых семантических моделях за пределами весов модели. --- # 2. Цикл рассуждения в реализации Каждый паттерн здесь служит одному циклу, взятому из [руководства по ИИ-агентам](../07-guides/AI-Agent-Guide.md): ```text Task → Context → Meta-Models → Contracts → Projections → Reasoning → Events → Traceable Result ``` Разделы ниже сопоставляют каждой стадии конкретную технику: - **Мета-модели** → загружаются в языковую модель как схемы вызова инструментов и ограничения структурированного вывода (раздел 3); - **Проекции + События** → извлекаются через RAG по смыслу, а не по сырым строкам (раздел 4); - **Контракты** → приводятся в исполнение как Исполнимый семантический контракт внутри цикла (раздел 5); - **Рассуждение + Прослеживаемый результат** → заземляются в векторных и графовых хранилищах (раздел 6). --- # 3. Паттерн: загрузка мета-модели в языковую модель Мета-модель загружается в языковую модель двумя взаимодополняющими способами: - **Как схемы вызова инструментов.** Каждый Объект, каждый запрос Проекции и каждое действие записи События, которое агенту дозволено выполнить, выставляется инструментом, схема параметров которого выведена из определений [MUIF](../02-architecture/MMAS-Interchange.md) мета-модели. CSN понятия становится каноническим именем инструмента или поля, так что модель вызывает инструменты *на словаре предметной области*, а не выдумывает свой. - **Как ограничения структурированного вывода.** Когда агент должен выдать Проекцию или утверждение, ожидаемый вывод ограничивается схемой соответствующего примитива. Модель заполняет известную форму; она не выдаёт вольного комка JSON, о котором вызывающей стороне пришлось бы гадать. Поскольку имена инструментов и полей суть CSN, тот же самый агент перенацеливается на новую предметную область загрузкой другой мета-модели - цикл не меняется, различаются лишь схемы. --- # 4. Паттерн: RAG по проекциям и событиям Обычный RAG извлекает сырые строки или куски документов. Агент Мета-Вселенной извлекает **смысл**: - Индексируйте и извлекайте по [Проекциям](../04-core-concepts/Projection.md) - минимальным, уместным для контекста видам - а не по сырым внутренним записям. Агент получает лишь то, что нужно задаче, уже оформленное под его Контекст. - Индексируйте и извлекайте по [Событиям](../04-core-concepts/Event.md) и [семантической ленте времени](../04-core-concepts/Event.md), чтобы агент мог извлечь *что произошло и почему* и восстановить историческое состояние, а не только текущий снимок. - Переносите в промпт ребро происхождения каждого извлечённого элемента, чтобы извлечённый контекст был уже прослеживаем через [граф происхождения](../02-architecture/Provenance-Graph.md). Следствие: извлечение возвращает истолковываемое, оформленное контрактом знание с прикреплённой родословной - а не безымянный текст, который модели пришлось бы перетолковывать. --- # 5. Паттерн: исполнимый семантический контракт в цикле агента [Контракт](../04-core-concepts/Contract.md) приводится в исполнение как **Исполнимый семантический контракт** *внутри* цикла агента, а не просто описывается вокруг него. К Контракту обращаются на каждом шаге: - **Дозволенные проекции** - цикл запрашивает лишь те Проекции, которые Контракт разрешает для Назначения Задачи; запрос вне этого набора отклоняется прежде, чем прочитаны какие-либо данные. - **Скрытые поля** - поля, помеченные Контрактом как не подлежащие раскрытию, отфильтровываются из извлечённых Проекций до того, как те попадут в контекстное окно модели, так что языковая модель никогда не видит того, чем ей пользоваться нельзя. - **События с уведомлением владельца** - действия, названные Контрактом значимыми, порождают неизменяемые [События](../04-core-concepts/Event.md), которые уведомляют владеющую Вселенную, так что раскрытия и решения с последствиями оставляют проверяемый след. Конкретно контракт оборачивает каждый вызов инструмента: ```text for each step in the agent loop: proposed_action ← LLM(context) contract.check(proposed_action.purpose, proposed_action.projection) → allow | deny | redact if allow/redact: result ← execute(proposed_action) # redact hidden fields if action is significant: emit Event → notify owner else: return refusal to the model with the reason ``` Тем самым Контракт есть ограждение времени исполнения: агент *не может* выйти за свои разрешения на раскрытие, даже если рассуждение модели к тому клонит. --- # 6. Паттерн: векторные хранилища и графовые базы данных Два хранилища играют в цикле взаимодополняющие роли: - **Векторное хранилище** - питает извлечение RAG из раздела 4: эмбеддинги Проекций и сводок Событий дают семантический поиск *того смысла, который нужен задаче*. Оно отвечает на вопрос «что уместно?». - **Графовая база данных** - держит [граф происхождения](../02-architecture/Provenance-Graph.md) и структуру Связей мета-модели. Она отвечает на структурные вопросы из [Provenance-Graph §7](../02-architecture/Provenance-Graph.md) - обоснование («почему это истинно?»), влияние («что сломается, если X изменится?») и зависимость - на которые поиск по сходству ответить не может. Умелый агент пользуется обоими: векторным хранилищем, чтобы *найти* кандидатов в контекст, графом - чтобы его *обосновать и ограничить*. Извлекайте по сходству; проверяйте и прослеживайте обходом. --- # 7. Разбор задачи агента по шагам **Задача:** «Составь черновик представления к повышению для сотрудника E». ```text Task : draft a promotion recommendation for employee E Context : purpose = HR review; audience = E's manager; constraint = internal only Meta-Models : Employee + Organization Meta-Models loaded as tool schemas (CSNs) Contracts : HR Disclosure Contract bound to the loop (Purpose = HR review) Projections : vector store retrieves E's Competency Projection and the Promotion-Policy Projection — already filtered of salary fields the contract hides Reasoning : the LLM applies the policy to the competency evidence; the graph store supplies the justification chain (Competency ← Reviews ← Feedback) Events : agent emits a Disclosure Event (recommendation drafted under HR Contract); owner is notified Result : a recommendation, explainable back through Context, Contract, Projections and the Provenance Graph to its source observations ``` Достойным доверия результат делает не проза: дело в том, что всякое утверждение прослеживается через [граф происхождения](../02-architecture/Provenance-Graph.md) до заземляющего свидетельства, что зарплата, которой модель не видела, была исключена Контрактом, и что сам черновик записан [Событием](../04-core-concepts/Event.md). Тот же самый агент, получив другую мета-модель и другой Контракт, выполняет совершенно другую задачу с теми же гарантиями. --- # 8. Чеклист интеграции Строя агента на этих паттернах, убедитесь, что: - мета-модели выставлены схемами вызова инструментов с именами по CSN; - выводы ограничены схемами примитивов; - RAG извлекает Проекции и События, а не сырые строки; - Контракт приводится в исполнение внутри цикла (дозволенные Проекции, скрытые поля, События с уведомлением владельца); - векторное хранилище ведает уместностью, графовое - происхождением и влиянием; - всякое значимое действие порождает неизменяемое Событие; - всякий результат прослеживается через граф происхождения. --- # 9. Направления развития Эти паттерны могли бы сойтись в переиспользуемый **профиль рантайма агента**: стандартный генератор схем инструментов из [MUIF](../02-architecture/MMAS-Interchange.md), эталонная библиотека исполнения Исполнимого семантического контракта и контракт извлечения, привязывающий векторные и графовые хранилища к Проекциям и графу происхождения. Вместе с автономным согласованием федерации из [руководства по ИИ-агентам](../07-guides/AI-Agent-Guide.md) такой профиль позволил бы любому соответствующему агенту подключаться к любой Вселенной, где происхождение, пределы раскрытия и объяснимость гарантированы по построению. --- # Заключение Построение ИИ-агента на Мета-Вселенной - не про промпт похитрее. Оно про то, чтобы вписать языковую модель в цикл, где предметная область, правила, виды и история живут в управляемых семантических моделях вокруг неё - так что извлекаемое агентом есть смысл, дозволенное к раскрытию принудительно ограничено, а выводимое им всегда можно проследить обратно до свидетельства, которое сделало это истинным.