# Ваші програми як інструменти для ШІ-агентів Більшість бізнес-програм створено для того, щоб у них клацали: екран, форма, кнопка й людина перед ними. Агент теж уміє клацати — повільно й навмання, — і все ламається того дня, коли кнопку переносять в інше місце. Кращий шлях для нього — описаний інструмент: операція з назвою, типізованими вхідними даними, зрозумілою відповіддю й перевіркою прав. Ми беремо програми, якими ви вже користуєтеся, — ті, від яких залежить ваш бізнес, хоч би якими старими вони були, — і прокладаємо до них цей шлях, не зупиняючи бізнес заради переписування. ## Розібрано: правила, витягнуті з екранів Правила, за якими працює бізнес, ховаються в програмах: у валідації форми, у збереженій процедурі, у звіті, який ніхто не наважується змінити, у голові людини, яка все це створила. Ми знаходимо їх, записуємо й переносимо кожне в один шар — часто в саму [базу даних](/uk/glossary/#database), — де кожен, хто звертається, отримує ту саму відповідь. Тоді екран, агент та інтеграція з партнером ставлять те саме запитання тому самому правилу — і не можуть отримати різних відповідей. ## Відкрито: описані інструменти, які агент може викликати Кожна операція, потрібна агентові, доступна як інструмент, названий за дією, — забронювати слот, розрахувати ціну, відвантажити замовлення, — з типізованими вхідними даними, помилками, на які агент може зреагувати, та [ідемпотентними](/uk/glossary/#idempotent) викликами, тож повторна спроба не створить другого бронювання. Опис — це документ [OpenAPI](/uk/glossary/#openapi), згенерований із коду, а MCP-сервер надає ті самі операції агентам, що підтримують цей протокол. [Автентифікація](/uk/glossary/#authentication) — через OAuth, тож агент діє від імені користувача без передавання пароля і лише в межах [прав](/uk/ai-security/) цього користувача. ## Без зупинки: крок за кроком, а не все одразу Переписування з нуля зупиняє бізнес на весь час проєкту й ставить усе на останній день. Ми відкриваємо програму поступово, по одній операції, поряд із системою, що вже працює, і порівнюємо новий шлях зі старим, доки їхні результати не збіжуться. Тривалі операції переходять у [чергу](/uk/glossary/#queue), тож агент одразу отримує відповідь, а робота триває у фоні. Екрани, якими користуються ваші працівники, весь цей час працюють, а старий код виводять з ужитку лише тоді, коли до нього більше ніхто не звертається. ## Контракт, що завжди збігається з кодом Опис інструмента, написаний вручну, застаріває вже за тиждень після випуску, а агент однаково йому вірить. Наші описи генеруються з коду — від бази даних до API, опису й клієнта, — з перевіркою на кожному кроці, яка зупиняє збірку, щойно два з них перестають збігатися. Агент, читаючи опис, дізнається, що програма робить сьогодні, а зміну, яка зламала б чиюсь інтеграцію, виявляють до випуску, а не після. ## Робота, що за цим стоїть Так ми вже відкривали великі системи. Ми [згенерували API-контракт із бази даних](/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](/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/), [збудували платформу з чітким поділом на шари](/uk/portfolio/a-maritime-platform-built-in-clean-layers/), де бізнес-правила зібрано в одному місці, [винесли повільні операції в чергу завдань](/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/) *(відповідаємо того ж дня)*.