# Ваші програми як інструменти для ШІ-агентів

Надайте ШІ-агентам визначений спосіб користуватися наявними бізнес-програмами.
Ми обираємо доречні операції, описуємо їхні вхідні дані й результати та
перевіряємо права перед відкриттям операцій як інструментів. Зміни плануємо
поряд із чинним застосунком, із тестуванням і впровадженням, погодженими під
його експлуатаційні обмеження.

## Розібрано: правила, витягнуті з екранів

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

## Відкрито: описані інструменти, які агент може викликати

Кожна операція, потрібна агентові, доступна як інструмент, названий за дією, —
забронювати слот, розрахувати ціну, дозволити виконання замовлення, — з типізованими
вхідними даними, помилками, на які агент може зреагувати, та
[ідемпотентними](/uk/glossary/#idempotent) викликами, тож повторна спроба не
створить другого бронювання. Опис — це документ [OpenAPI](/uk/glossary/#openapi),
згенерований із коду, а MCP-сервер надає ті самі операції агентам, що
підтримують цей протокол. [Автентифікація](/uk/glossary/#authentication) —
через OAuth, тож агент діє від імені користувача без передавання пароля і лише
в межах [прав](/uk/ai-security/) цього користувача.

## Впроваджуйте операції контрольованими кроками

Відкриваємо вибрані операції поряд із чинним застосунком і порівнюємо новий
шлях із поточною поведінкою. Повільну роботу можна переносити до
[черги](/uk/glossary/#queue), де це доречно. Залежності, міграцію, вікна
обслуговування та повернення до попереднього стану оцінюємо до впровадження. Наявні екрани залишаємо
доступними, де дозволяє погоджена архітектура; перерви плануємо разом із людьми,
які експлуатують сервіс.

## Генеруйте контракт і перевіряйте розбіжності

Де архітектура дозволяє, генеруємо опис із визначень
бази даних та [API](/uk/glossary/#api) і порівнюємо
опублікований контракт із реалізацією. Перевірки виявляють розбіжності в
охоплених операціях і показують зміни сумісності під час перегляду. Тести та
їхнє покриття передаємо разом із результатом; сам згенерований опис не доводить
правильність усієї поведінки.

## Робота, що за цим стоїть

Так ми вже відкривали великі системи. Ми
[згенерували API-контракт із бази даних](https://engineer.company/uk/portfolio/generated-the-api-contract-from-the-database-out/)
з перевіркою на кожному кроці і
[перенесли API з 760 операцій зі стовідсотковою відповідністю](/uk/portfolio/migrated-the-api-to-huma-v2-at-100-parity/)
його опублікованому опису. Ми
[спроєктували наскрізну передачу JSON з PostgreSQL до API](https://engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/),
[збудували платформу з чітким поділом на шари](https://engineer.company/uk/portfolio/a-maritime-platform-built-in-clean-layers/),
де бізнес-правила зібрано в одному місці,
[винесли повільні операції в чергу завдань](https://engineer.company/uk/portfolio/moved-slow-work-onto-a-river-job-queue/)
і [створили операторський бек-офіс](/uk/portfolio/built-the-operator-back-office-for-the-platform/),
через який оператори керують платформою без доступу до бази даних.

## Як іде співпраця

Усе починається зі списку того, що ваші люди щодня роблять у програмі, —
упорядкованого за тим, як часто це трапляється і скільки їм коштує. Ми беремо
перші кілька операцій, знаходимо їхні правила й відкриваємо їх як описані
інструменти — з тестами й правами доступу, поруч з екранами, а не замість них.
Потім наступні кілька. Код, тести й опис лишаються у вашої команди;
інструменти може викликати
[ШІ-агент, створений для вашої галузі](/uk/ai-agents/), асистенти, якими ваші
працівники вже користуються, або система партнера. Замовляють цю роботу, як і
решту наших послуг, — на умовах, описаних на сторінці
[скільки це коштує](/uk/what-it-costs/).

Якщо ваша програма працює лише тоді, коли хтось у ній клацає,
[розкажіть, що це за програма](/uk/contact/) *(прочитає інженер)*.

<https://engineer.company/uk/ai-tools/>
