> For the complete documentation index, see [llms.txt](https://kotovich.gitbook.io/ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kotovich.gitbook.io/ua/3.-robota-multiagentnoyi-sistemi.md).

# 3. Робота мультиагентної системи

## Робота мультиагентної системи за кроками: як 16 агентів готують КП по лізингу за 10 хвилин

У попередніх статтях я розповідав, як влаштована мультиагентна система (MAS) загалом — оркестратор, агенти-фахівці, контрольний шар і база знань. Цього разу — детальний розбір одного реального ланцюжка: усі 16 кроків, які проходить система лізингового брокера від заявки клієнта до готової комерційної пропозиції.

Зверніть увагу: оркестратор вмикається в процес не один раз, а тричі — на старті, посередині та в самому фіналі. Це не помилка архітектури, а свідоме рішення: координатор має контролювати процес на межах між фазами, а не тільки запускати його.

### Що на вході

Система отримує:

* заявку клієнта;
* кілька пропозицій від лізингових компаній із графіками платежів;
* параметри предмета лізингу;
* обмеження клієнта за авансом, щомісячним платежем і терміном.

Далі це проходить через п'ять фаз обробки.

### Фаза 1. Що взагалі потрібно клієнту

Перш ніж порівнювати пропозиції, система з'ясовує справжню мету клієнта: зберегти оборотні кошти, зменшити загальну переплату, отримати невеликий щомісячний платіж чи підвищити ймовірність схвалення заявки. Без цього кроку неможливо коректно вибрати найкращий варіант — найдешевша пропозиція підходить далеко не завжди, якщо для клієнта критичний, наприклад, розмір авансу, а не загальна переплата.

| Крок | Агент                           | Що робить                                                                                                  |
| ---- | ------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| 1    | **LIZ-ORC-00** Оркестратор      | Приймає завдання, визначає формат КП, збирає ланцюжок агентів                                              |
| 2    | **LIZ-MET-01** Бізнес-аналітик  | Розуміє завдання клієнта: навіщо актив, хто ЛПР, що критично — аванс, платіж, швидкість, податковий ефект  |
| 3    | **LIZ-MET-04** RAG-навігатор    | Підтягує потрібний контекст: структуру КП, профіль ЛПР, процес угоди, бренд/комплаєнс                      |
| 4    | **LIZ-MET-07** Web Intelligence | За потреби перевіряє актуальні зовнішні дані: умови лізингових компаній, нормативні акти, ставки, програми |

### Фаза 2. Графіки платежів до єдиного вигляду

Кожна лізингова компанія оформлює графік платежів по-своєму — з різною структурою авансу, комісій, страхування і викупної вартості. Порівнювати такі документи "на око" ризиковано: легко пропустити приховану комісію чи іншу базу розрахунку переплати. Фінансовий аналітик наводить усі пропозиції до єдиного вигляду й рахує показники, за якими їх можна коректно зіставити напряму.

| Крок | Агент                              | Що робить                                                                                                             |
| ---- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| 5    | **LIZ-ROL-01** Фінансовий аналітик | Нормалізує графіки лізингових компаній, рахує XIRR, подорожчання, переплату, cash flow, податковий ефект через Python |

### Фаза 3. Умови та ризики

Цифри — лише половина рішення. Друга половина — умови договору, які часто ховаються в дрібному шрифті: штрафи за дострокове погашення, обмеження на викуп, спірні формулювання щодо зміни умов у процесі дії договору. Ця фаза розподілена між двома спеціалізованими агентами, які працюють паралельно з різних кутів — юридичного і ризик-менеджменту.

| Крок | Агент                           | Що робить                                                                                             |
| ---- | ------------------------------- | ----------------------------------------------------------------------------------------------------- |
| 6    | **LIZ-ROL-02** Юрист            | За наявності умов чи договору шукає red flags: штрафи, викуп, розірвання, страхування, зміна умов     |
| 7    | **LIZ-ROL-03** Ризик-менеджер   | Збирає фінансові, юридичні та операційні ризики, пропонує мітигації                                   |
| 8    | **LIZ-ROL-04** Pre-Underwriting | Формує список необхідних документів, стоп-фактори, кроки подачі заявки, основний і резервний сценарії |

### Фаза 4. Рекомендація та пакет документів

Тут оркестратор включається вдруге — щоб зібрати результати роботи попередніх агентів в один логічний документ, а не просто скласти їх один за одним. Далі текст адаптується під конкретного отримувача: власнику, фіндиректору чи головному бухгалтеру потрібні різні акценти в поясненні того самого рішення.

| Крок | Агент                      | Що робить                                                                                    |
| ---- | -------------------------- | -------------------------------------------------------------------------------------------- |
| 9    | **LIZ-ORC-00** Оркестратор | Склеює експертні блоки в логіку КП: завдання → варіанти → розрахунки → ризики → рекомендація |
| 10   | **LIZ-ROL-05** Копірайтер  | Адаптує пояснення під власника або CEO, готує email- та Telegram-повідомлення                |
| 11   | **LIZ-ROL-06** Дизайнер    | Робить інфографіку Next Steps і візуальні блоки для КП                                       |

### Фаза 5. Факт-чек, перевірка, результат

Останній рубіж перед видачею результату — і саме тут працює контрольний шар системи. Чотири незалежні перевірки покривають різні типи помилок: цифри, бренд-стандарти, технічну збірку документа та фінальну повноту. Це не одна перевірка "на все відразу", а послідовність вузьких, тому що агент, який шукає розрахункові помилки, не той самий, що стежить за тоном комунікації чи гарантіями, які не можна давати клієнту.

| Крок | Агент                             | Що робить                                                                                  |
| ---- | --------------------------------- | ------------------------------------------------------------------------------------------ |
| 12   | **LIZ-MET-03** Fact-Check         | Перевіряє числа, формули, джерела, припущення, відсутність галюцинацій                     |
| 13   | **LIZ-MET-05** Brand & Compliance | Перевіряє бренд, tone of voice, дисклеймери, відсутність гарантій щодо схвалення чи ставки |
| 14   | **LIZ-MET-06** Document Assembler | Збирає DOCX/PDF, таблиці, додатки, інфографіку в фінальний файл                            |
| 15   | **LIZ-MET-08** Final QA           | Фінально перевіряє повноту, логіку, розрахунки, висновки й готовність до відправки         |
| 16   | **LIZ-ORC-00** Оркестратор        | Передає користувачеві фінальний результат                                                  |

### Скільки це реально економить часу

На таку роботу в людини йде година-півтора: звести графіки вручну, порахувати переплату по кожній пропозиції, перечитати умови на предмет прихованих застережень, оформити презентабельний документ. Система агентів проходить весь ланцюжок за 10 хвилин.

При цьому менеджер залишається фінальним валідатором — перевіряє результат, за потреби відправляє на доопрацювання і сам ухвалює рішення, що саме піде клієнту. Система не замінює його роль, вона знімає з нього рутинну частину роботи — зведення даних, розрахунки, першу перевірку ризиків — і залишає йому те, що справді вимагає людського рішення.