24 KiB
Пять демонстрационных сценариев
Сценарии адаптированы из предоставленной аналитической работы «Finance Harness», версия 1.0 от 11.11.2026, раздел 3 (страницы 4–5), с учётом технической модели на странице 11. Это требования к демонстрации Invest Harness, а не описание готовых интеграций или подтверждённых продуктовых эффектов
В исследовании профили называются harness. В терминах платформы START, GUARD, GOAL, PULSE и PRO — пять шаблонов агента на общей DSH-базе: каждый закрепляет harness, плагины, скиллы, правила ответа и JSON Schema настроек. Отдельный движок для каждого сценария не нужен. Пользователь создаёт из шаблона свой экземпляр агента
| Шаблон | Запрос пользователя | Результат | Демонстрируемая возможность |
|---|---|---|---|
| START — Мой первый портфель | «Объясни, чем отличаются эти инструменты» | Понятное сравнение и учебный пример | Настройка глубины ответа через форму |
| GUARD — Сохранить деньги | «Деньги нужны через девять месяцев: где риски?» | Аудит портфеля и ликвидности | Read-only данные и регулярный обзор |
| GOAL — Капитал под цель | «Как накопить 3 млн рублей за семь лет?» | Несколько расчётных планов | Калькулятор, параметры и график |
| PULSE — Эксперты с доказательствами | «Как менялась позиция выбранного автора?» | Хронология с подтверждающими источниками | Поиск по публикациям и цитирование |
| PRO — Исследовательская панель | «Сравни банки по отчётности» | Проверяемые расчёты и аналитический отчёт | Инструменты, документы и свой Runner |
Общие условия демонстрации
Пользователь выбирает шаблон в каталоге, настраивает форму, связывает разрешённые connections и выбирает локальное или удалённое исполнение. Провайдер модели выбирается независимо от сценария: API key либо доступный для этой среды account mode из матрицы плагинов. Наличие подписки не гарантирует доступность интеграции
В каждом сценарии ниже названия инструментов и финансовых плагинов — проектируемые возможности. Плагины объявляют доступы, а шаблоны закрепляют версии и скиллы. Минимальная демонстрация работает с подготовленными документами и снимками данных; доступ к брокерскому аккаунту, Пульсу и платным источникам не считается уже полученным
Для этих пяти демонстрационных шаблонов используются учебные либо read-only подключения без отправки торговых поручений. Это граница конкретных шаблонов; платформа по-прежнему рассматривает внутреннюю логику Runner как чёрный ящик. Скилл описывает метод работы, но ограничения доступа обеспечивает runtime и политика инструментов
Настройки ниже — содержимое config schema шаблона; вопрос, документ и снимок портфеля — вход конкретного Run. Секреты хранятся в connections, а не в форме. Смена профиля не переносит контекст автоматически: пользователь явно передаёт выбранный снимок или параметры цели новому агенту; права проверяются повторно. Общая неограниченная память между агентами не требуется
1. START — «Мой первый портфель»
Пользователь и цель. Начинающий инвестор хочет понять инструменты и смысл показателей до принятия собственного решения. Пример запроса: «Объясни разницу между вкладом и облигацией из этого примера простыми словами»
Состав. DSH harness; плагины словаря, рыночных справочников и симулятора портфеля (glossary, market_data, portfolio_simulator); скилл объяснения финансовых понятий. Брокерское подключение не требуется
Настройки формы. knowledgeLevel — начальный/базовый; explanationDepth — кратко/подробно; showGlossary и includeQuiz — переключатели; virtualCapital — положительная сумма с валютой. Это параметры объяснения и симуляции, а не присвоение пользователю инвестиционной стратегии
Ход сценария.
- Пользователь выбирает START, задаёт уровень объяснения и виртуальный капитал, сохраняет ревизию
- Передаёт вопрос и выбирает инструменты из демонстрационного набора
- Агент получает определения и характеристики из разрешённых источников, отделяет известные условия от допущений
- Симулятор строит учебный пример; агент объясняет результаты и при включённой настройке добавляет вопрос для самопроверки
- Пользователь меняет глубину объяснения через форму и запускает новый Run с теми же входными данными
Результат. Сравнение инструментов, расшифровка терминов, учебный пример и ссылки на использованные материалы. Краткий и подробный режимы сохраняют одни и те же исходные факты
Если данных не хватает. Агент обозначает отсутствующие характеристики и предлагает дополнить вход. Недоступность источника не заменяется выдуманным значением. Учебная цена или доходность явно помечается как условная
Критерий приёмки. Форма меняет стиль и детализацию ответа без редактирования prompt пользователем; расчёты симулятора воспроизводимы; отсутствуют инструменты размещения поручений. Минимальный запуск — локально с кешированным учебным набором; модель может требовать сеть
2. GUARD — «Сохранить деньги»
Пользователь и цель. Инвестору нужны деньги к определённой дате. Он хочет увидеть концентрацию, сроки и неопределённость ликвидности своего портфеля. Пример: «Мне нужны деньги через девять месяцев. Какие позиции требуют внимания?»
Состав. DSH harness; плагины чтения портфеля, метаданных облигаций и сценарного расчёта (portfolio_read, bond_metadata, rate_scenario, issuer_risk), при регулярном запуске — recurring-tasks; скилл аудита портфеля
Настройки формы. targetDate, requiredAmount, baseCurrency, maxDataAgeHours, включение сценариев изменения ставки. Параметры стресс-сценария задаются явно. Расписание настраивается отдельной формой платформы с timezone, preview, overlap и misfire policy
Ход сценария.
- Пользователь выбирает GUARD и загружает снимок портфеля либо подключает доступный read-only источник
- Задаёт дату потребности в деньгах и сумму; платформа фиксирует конфигурацию агента
- Плагин нормализует позиции, валюты и дату оценки, объединяет экспозиции одного эмитента
- Инструменты рассчитывают концентрацию и заданные сценарии; агент объясняет результаты с указанием недостающих данных
- Пользователь сохраняет отчёт. При необходимости включает еженедельный запуск и просматривает следующие срабатывания перед сохранением
Результат. Сводка портфеля, концентрация по эмитентам и классам, сведения о сроках и ликвидности, сценарии и перечень пробелов. Для повторного обзора можно явно передать предыдущий результат; вывод об изменениях содержит обе даты оценки
Если источник устарел или недоступен. Отчёт обозначает возраст снимка; при превышении установленного порога задача не выдаёт его за актуальный обзор. Отзыв connection останавливает расписание с причиной. Низкая ликвидность не определяется только сроком погашения
Критерий приёмки. Итоги на подготовленном портфеле совпадают с эталонными расчётами, отсутствующие сведения видимы. Повторная доставка одного occurrence не создаёт второй Run. Локальное расписание работает только при запущенном daemon; удалённое выполняется на выбранном Runner
3. GOAL — «Капитал под цель»
Пользователь и цель. Пользователь задаёт сумму и срок и хочет сравнить возможные планы накопления. Пример: «Какой ежемесячный взнос нужен для 3 млн рублей через семь лет?»
Состав. DSH harness; плагины goal_calculator, scenario_engine и графиков; скилл объяснения сценарных расчётов. Брокерское подключение необязательно; доходность и инфляция могут быть заданными пользователем допущениями
Настройки формы. targetAmount, targetDate, initialCapital, currency, contributionTiming, массив сценариев с доходностью и инфляцией. Форма явно различает будущую номинальную сумму и сумму в сегодняшних ценах; не предлагает скрытого значения «ожидаемой доходности»
Ход сценария.
- Пользователь создаёт GOAL, заполняет цель и исходные параметры
- Валидатор отклоняет прошедшую дату, несовместимые валюты и неполные сценарии
- Калькулятор определяет периодичность, преобразует ставки по зафиксированной методике и рассчитывает взносы для каждого сценария
- Агент объясняет различия; график строится из результата калькулятора, а не из чисел, придуманных моделью
- Пользователь меняет срок или взнос через форму и получает новый расчёт, сохраняя предыдущую ревизию для сравнения
Результат. Таблица сценариев, требуемый взнос, траектории накопления, исходные допущения и методика. До появления встроенного chart-компонента достаточно таблицы и файла с рядами данных; интерактивный график — отдельная возможность UI
Если цель недостижима при заданном взносе. Агент показывает расчётный разрыв и чувствительность к изменению параметров. Он не увеличивает допущение доходности молча и не представляет сценарии как прогноз рынка
Критерий приёмки. Калькулятор корректно обрабатывает нулевую ставку, уже достигнутую цель, момент внесения взноса и номинальные/реальные суммы. Ответ и график используют один набор данных. Сценарий доступен локально без подключения брокера
4. PULSE — «Эксперты с доказательствами»
Пользователь и цель. Читатель хочет найти и сопоставить опубликованные взгляды автора. Пример: «Что автор писал о банках до отчётности и после неё?»
Состав. DSH harness; плагины pulse_search, transcript_search, stance_timeline, conflict_checker; скилл анализа источников. Для первого демо используется разрешённый набор публикаций с метаданными либо явно синтетический корпус. Живая интеграция с Пульсом требует отдельной проверки доступа
Настройки формы. authorIds, временной интервал поиска, answerDepth, includeContradictions. Обязательность ссылок и запрет выдуманных цитат входят в политику шаблона и не выключаются пользовательской настройкой
Ход сценария.
- Пользователь выбирает автора и период, задаёт вопрос
- Поиск фильтрует разрешённый корпус по автору, датам и теме
- Инструменты возвращают фрагменты, идентификаторы публикаций, даты публикации/обновления и источник
- Агент разделяет факты и мнения, сопоставляет позиции во времени и показывает противоречия
- Пользователь открывает источник из ответа либо расширяет период и создаёт новый Run
Результат. Хронология тезисов с цитатами и источниками; отдельно — что найдено, что противоречит друг другу и чего подтвердить не удалось. Это поиск по высказываниям, а не выступление от имени живого автора
Если подтверждения нет. Агент сообщает, что позиция не найдена в выбранном корпусе и периоде. Старая публикация не превращается в утверждение о сегодняшней рекомендации. Команды внутри найденных текстов не получают полномочий управлять агентом
Критерий приёмки. Каждая цитата совпадает с фрагментом корпуса, автор и дата атрибутированы правильно. Тестовый конфликт показывает обе позиции; запрос без источника не порождает выдуманный ответ. Разрешения корпуса проверяются и в локальном, и в удалённом режиме
5. PRO — «Исследовательская панель»
Пользователь и цель. Аналитик хочет сократить сбор отчётности и расчёт сопоставимых показателей. Пример: «Сравни выбранные банки по ROE, капиталу и динамике маржи за один период»
Состав. DSH harness; плагины чтения документов, statements_RAG, calculate_metrics, графиков; опциональный read-only адаптер брокерских данных; скилл анализа отчётности. Идентификаторы инструментов — проектируемые контракты, а не утверждение о наличии готового MCP-сервера
Настройки формы. entityIds, отчётный период, стандарт отчётности, валюта представления, metricIds, checklistVersionId, sourcePolicy. В первой версии пользователь выбирает проверенные формулы и чек-листы. Загрузка произвольного исполняемого кода формулы требует отдельного пакета, проверки и разрешений
Ход сценария.
- Аналитик выбирает PRO, документы и набор показателей, сохраняет параметры через форму
- При конфиденциальных материалах выбирает локальный или on-prem Runner и модель, разрешённую политикой передачи данных
- Поиск находит строки документов с привязкой к страницам; нормализатор проверяет период, единицы, стандарт и периметр консолидации
- Калькулятор вычисляет показатели по выбранной версии методики. Агент формирует интерпретацию и перечисляет ограничения сравнения
- Результат сохраняется как отчёт, таблица расчётов и использованные ссылки. Повторное исследование закрепляет новый снимок входных данных
Результат. Сравнительная таблица, формулы и исходные числа со ссылками на страницы, графики при наличии UI capability, список несопоставимых или отсутствующих значений
Если документы несопоставимы. Показатель маркируется как несопоставимый или нерассчитанный; отсутствие данных не заменяется нулём. При недоступности своего Runner задача не переносится в облачный пул автоматически. Само размещение Runner on-prem не разрешает отправлять документы внешней модели
Критерий приёмки. На подготовленном наборе документов расчёты совпадают с эталоном в заранее заданной погрешности; каждое исходное число имеет источник. Переключение на совместимый свой Runner сохраняет контракт входа/выхода и не расширяет доступы
Связь с реализацией платформы
Финансовые инструменты перечисленных шаблонов расширяют линейку плагинов, но не становятся частью диспетчера. Сначала можно реализовать один ручной запуск с подготовленными данными; расписания, графики и удалённое исполнение подключаются по мере готовности соответствующих компонентов
| Возможность | Где определён контракт |
|---|---|
| Форма, defaults и ревизии | JSON Schema Driven UI, Agents API |
| Публикация пяти шаблонов и зависимостей | Каталог, Catalog API |
| Подключение моделей и данных | Provider API, безопасность |
| Ручной запуск и расписание | Runs API |
| Локальный и заменяемый Runner | Исполнение, Runner Protocol |
| Этапы платформы | Roadmap |
Успешный Run означает, что результат принят по техническому контракту. Финансовая корректность, точность цитат и понятность объяснений проверяются отдельными эталонными задачами каждого шаблона. Числа из примеров — входы демонстрации, а не обещания доходности или измеренные результаты продукта