diff --git a/README.md b/README.md index f8ea004..21f24dd 100644 --- a/README.md +++ b/README.md @@ -13,11 +13,11 @@ Пять шаблонов агента на общей базе DSH: -1. **START — Мой первый портфель:** объяснение инструментов и учебный портфель -2. **GUARD — Сохранить деньги:** аудит портфеля, ликвидности и рисков к заданной дате -3. **GOAL — Капитал под цель:** расчёт взносов и сравнение сценариев накопления -4. **PULSE — Эксперты с доказательствами:** поиск мнений авторов с датами и источниками -5. **PRO — Исследовательская панель:** анализ отчётности и проверяемые расчёты +1. **Мой первый портфель:** объяснение инструментов и учебный портфель +2. **Сохранить деньги:** аудит портфеля, ликвидности и рисков к заданной дате +3. **Капитал под цель:** расчёт взносов и сравнение сценариев накопления +4. **Эксперты с доказательствами:** поиск мнений авторов с датами и источниками +5. **Исследовательская панель:** анализ отчётности и проверяемые расчёты [Подробные сценарии: настройки, шаги, результаты и критерии приёмки](designDocument/scenarios.md) diff --git a/designDocument/design.md b/designDocument/design.md index 7a7848a..0c6f06e 100644 --- a/designDocument/design.md +++ b/designDocument/design.md @@ -44,7 +44,7 @@ Invest Harness — платформа агентов для инвестиций ### Пять инвестиционных сценариев -На общем DSH harness создаются пять шаблонов: **START** объясняет инструменты начинающему, **GUARD** проверяет портфель к заданной дате, **GOAL** рассчитывает план накопления, **PULSE** сопоставляет подтверждённые мнения авторов, **PRO** анализирует отчётность. Пользователь настраивает шаблон через JSON Schema Driven UI и выбирает локальный либо удалённый Runner. Финансовые инструменты реализуются плагинами; методика задаётся скиллами +На общем DSH harness создаются пять шаблонов: **«Мой первый портфель»** объясняет инструменты начинающему, **«Сохранить деньги»** проверяет портфель к заданной дате, **«Капитал под цель»** рассчитывает план накопления, **«Эксперты с доказательствами»** сопоставляет подтверждённые мнения авторов, **«Исследовательская панель»** анализирует отчётность. Пользователь настраивает шаблон через JSON Schema Driven UI и выбирает локальный либо удалённый Runner. Финансовые инструменты реализуются плагинами; методика задаётся скиллами [Сценарии с настройками, шагами, обработкой ошибок и критериями приёмки](scenarios.md). Они описывают демонстрационные шаблоны с учебным или read-only доступом; конкретные внешние интеграции требуют проверки. Внутренняя логика агента остаётся за границей ответственности платформы diff --git a/designDocument/scenarios.md b/designDocument/scenarios.md index 8d9affd..4e3ab03 100644 --- a/designDocument/scenarios.md +++ b/designDocument/scenarios.md @@ -2,15 +2,15 @@ Сценарии адаптированы из предоставленной аналитической работы «Finance Harness», версия 1.0 от 11.11.2026, раздел 3 (страницы 4–5), с учётом технической модели на странице 11. Это требования к демонстрации Invest Harness, а не описание готовых интеграций или подтверждённых продуктовых эффектов -В исследовании профили называются harness. В [терминах платформы](design.md) START, GUARD, GOAL, PULSE и PRO — пять **шаблонов агента** на общей DSH-базе: каждый закрепляет harness, плагины, скиллы, правила ответа и JSON Schema настроек. Отдельный движок для каждого сценария не нужен. Пользователь создаёт из шаблона свой экземпляр агента +В исследовании профили называются harness. В [терминах платформы](design.md) «Мой первый портфель», «Сохранить деньги», «Капитал под цель», «Эксперты с доказательствами» и «Исследовательская панель» — пять **шаблонов агента** на общей DSH-базе: каждый закрепляет harness, плагины, скиллы, правила ответа и JSON Schema настроек. Отдельный движок для каждого сценария не нужен. Пользователь создаёт из шаблона свой экземпляр агента | Шаблон | Запрос пользователя | Результат | Демонстрируемая возможность | |---|---|---|---| -| START — Мой первый портфель | «Объясни, чем отличаются эти инструменты» | Понятное сравнение и учебный пример | Настройка глубины ответа через форму | -| GUARD — Сохранить деньги | «Деньги нужны через девять месяцев: где риски?» | Аудит портфеля и ликвидности | Read-only данные и регулярный обзор | -| GOAL — Капитал под цель | «Как накопить 3 млн рублей за семь лет?» | Несколько расчётных планов | Калькулятор, параметры и график | -| PULSE — Эксперты с доказательствами | «Как менялась позиция выбранного автора?» | Хронология с подтверждающими источниками | Поиск по публикациям и цитирование | -| PRO — Исследовательская панель | «Сравни банки по отчётности» | Проверяемые расчёты и аналитический отчёт | Инструменты, документы и свой Runner | +| Мой первый портфель | «Объясни, чем отличаются эти инструменты» | Понятное сравнение и учебный пример | Настройка глубины ответа через форму | +| Сохранить деньги | «Деньги нужны через девять месяцев: где риски?» | Аудит портфеля и ликвидности | Read-only данные и регулярный обзор | +| Капитал под цель | «Как накопить 3 млн рублей за семь лет?» | Несколько расчётных планов | Калькулятор, параметры и график | +| Эксперты с доказательствами | «Как менялась позиция выбранного автора?» | Хронология с подтверждающими источниками | Поиск по публикациям и цитирование | +| Исследовательская панель | «Сравни банки по отчётности» | Проверяемые расчёты и аналитический отчёт | Инструменты, документы и свой Runner | ## Общие условия демонстрации @@ -22,7 +22,7 @@ Настройки ниже — содержимое config schema шаблона; вопрос, документ и снимок портфеля — вход конкретного Run. Секреты хранятся в connections, а не в форме. Смена профиля не переносит контекст автоматически: пользователь явно передаёт выбранный снимок или параметры цели новому агенту; права проверяются повторно. Общая неограниченная память между агентами не требуется -## 1. START — «Мой первый портфель» +## 1. «Мой первый портфель» **Пользователь и цель.** Начинающий инвестор хочет понять инструменты и смысл показателей до принятия собственного решения. Пример запроса: «Объясни разницу между вкладом и облигацией из этого примера простыми словами» @@ -32,7 +32,7 @@ **Ход сценария.** -1. Пользователь выбирает START, задаёт уровень объяснения и виртуальный капитал, сохраняет ревизию +1. Пользователь выбирает «Мой первый портфель», задаёт уровень объяснения и виртуальный капитал, сохраняет ревизию 2. Передаёт вопрос и выбирает инструменты из демонстрационного набора 3. Агент получает определения и характеристики из разрешённых источников, отделяет известные условия от допущений 4. Симулятор строит учебный пример; агент объясняет результаты и при включённой настройке добавляет вопрос для самопроверки @@ -44,7 +44,7 @@ **Критерий приёмки.** Форма меняет стиль и детализацию ответа без редактирования prompt пользователем; расчёты симулятора воспроизводимы; отсутствуют инструменты размещения поручений. Минимальный запуск — локально с кешированным учебным набором; модель может требовать сеть -## 2. GUARD — «Сохранить деньги» +## 2. «Сохранить деньги» **Пользователь и цель.** Инвестору нужны деньги к определённой дате. Он хочет увидеть концентрацию, сроки и неопределённость ликвидности своего портфеля. Пример: «Мне нужны деньги через девять месяцев. Какие позиции требуют внимания?» @@ -54,7 +54,7 @@ **Ход сценария.** -1. Пользователь выбирает GUARD и загружает снимок портфеля либо подключает доступный read-only источник +1. Пользователь выбирает «Сохранить деньги» и загружает снимок портфеля либо подключает доступный read-only источник 2. Задаёт дату потребности в деньгах и сумму; платформа фиксирует конфигурацию агента 3. Плагин нормализует позиции, валюты и дату оценки, объединяет экспозиции одного эмитента 4. Инструменты рассчитывают концентрацию и заданные сценарии; агент объясняет результаты с указанием недостающих данных @@ -66,7 +66,7 @@ **Критерий приёмки.** Итоги на подготовленном портфеле совпадают с эталонными расчётами, отсутствующие сведения видимы. Повторная доставка одного occurrence не создаёт второй Run. Локальное расписание работает только при запущенном daemon; удалённое выполняется на выбранном Runner -## 3. GOAL — «Капитал под цель» +## 3. «Капитал под цель» **Пользователь и цель.** Пользователь задаёт сумму и срок и хочет сравнить возможные планы накопления. Пример: «Какой ежемесячный взнос нужен для 3 млн рублей через семь лет?» @@ -76,7 +76,7 @@ **Ход сценария.** -1. Пользователь создаёт GOAL, заполняет цель и исходные параметры +1. Пользователь создаёт «Капитал под цель», заполняет цель и исходные параметры 2. Валидатор отклоняет прошедшую дату, несовместимые валюты и неполные сценарии 3. Калькулятор определяет периодичность, преобразует ставки по зафиксированной методике и рассчитывает взносы для каждого сценария 4. Агент объясняет различия; график строится из результата калькулятора, а не из чисел, придуманных моделью @@ -88,7 +88,7 @@ **Критерий приёмки.** Калькулятор корректно обрабатывает нулевую ставку, уже достигнутую цель, момент внесения взноса и номинальные/реальные суммы. Ответ и график используют один набор данных. Сценарий доступен локально без подключения брокера -## 4. PULSE — «Эксперты с доказательствами» +## 4. «Эксперты с доказательствами» **Пользователь и цель.** Читатель хочет найти и сопоставить опубликованные взгляды автора. Пример: «Что автор писал о банках до отчётности и после неё?» @@ -110,7 +110,7 @@ **Критерий приёмки.** Каждая цитата совпадает с фрагментом корпуса, автор и дата атрибутированы правильно. Тестовый конфликт показывает обе позиции; запрос без источника не порождает выдуманный ответ. Разрешения корпуса проверяются и в локальном, и в удалённом режиме -## 5. PRO — «Исследовательская панель» +## 5. «Исследовательская панель» **Пользователь и цель.** Аналитик хочет сократить сбор отчётности и расчёт сопоставимых показателей. Пример: «Сравни выбранные банки по ROE, капиталу и динамике маржи за один период» @@ -120,7 +120,7 @@ **Ход сценария.** -1. Аналитик выбирает PRO, документы и набор показателей, сохраняет параметры через форму +1. Аналитик выбирает «Исследовательская панель», документы и набор показателей, сохраняет параметры через форму 2. При конфиденциальных материалах выбирает локальный или on-prem Runner и модель, разрешённую политикой передачи данных 3. Поиск находит строки документов с привязкой к страницам; нормализатор проверяет период, единицы, стандарт и периметр консолидации 4. Калькулятор вычисляет показатели по выбранной версии методики. Агент формирует интерпретацию и перечисляет ограничения сравнения