Transpareo в епоху агентів штучного інтелекту

Щойно закінчилася зміна. Співробітниця, відповідальна за дотримання нормативних вимог, експортує список змін із виробничої системи, завантажує його у свій помічник і вводить таке речення: «Опублікуй паспорти продукту для осередків із цього списку.»

Асистент зчитує 1240 серійних номерів разом із їхніми партіями, запитує у Transpareo, що потрібно для паспорта цього продукту, створює паспорти та перевіряє їх на відповідність вимогам регламенту. Відповідь: 1237 готові, 3 - ні, оскільки в одній партії відсутній показник вуглецевого сліду. Компанія надає це значення, а помічник оприлюднює його. Через два дні елементи виходять із заводу, кожен із QR-кодом, за яким можна переглянути його паспорт.

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

Спробуйте це вже зараз

Чи маєте ви обліковий запис у Claude, ChatGPT, Grok або Gemini, який дозволяє підключати додатки? Тоді підключіть його до нашої відкритої демо-версії. Це своєрідний ігровий майданчик: щогодини вона відновлюється, а все, що ви там робите, до того часу зникає.

1. Підключення. Створіть у свого постачальника послуг ШІ новий сервер MCP з адресою https://demo.transpareo.com/mcp . Залежно від постачальника, цю опцію можна знайти в розділі «Connector», «Integration» або «App».
2. Погодьтеся. Увійдіть за допомогою tester та Tester@12345 - дані для входу вказано тут навмисно. На екрані, що з’явиться після цього, кожен дозвіл зазначено окремо. Дозволи на читання можна надати назавжди; а щодо дозволів на запис - краще підтверджувати їх окремо.
3. Запитання. Повернувшись у вікно чату, задайте запитання повсякденною мовою, наприклад : «Перелічіть наші паспорти продукту».

Просили надати список; а прочитали - стан справ.

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

Саме це і стало приводом для написання цієї статті. Далі пояснюється, чому це працює.

Сказано - зроблено

Потрібно було підключити лише одну сторону: асистент до Transpareo - ті три кроки, про які щойно йшлося. Іншою стороною був файл, який видає виробнича система й так. Ніхто не визначав, який стовпець відповідає якому полю, ніхто не підтримує інтерфейс: Асистент прочитав список і створив паспорти, а те, що він мав зробити, було викладено в одному реченні. Якщо список змінюється, змінюється лише інструкція для асистента, а не програмний код.

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

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

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

Робота з інтеграції, яка раніше була першим етапом кожного проекту з дотримання нормативних вимог, сьогодні можна описати одним реченням повсякденною мовою.

Ось це і є справжня революція. За умови, що платформа на іншому кінці може повідомити програмі, чого вона потребує.

Програми завжди були основними читачами

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

Саме тому Transpareo побудовано навколо свого інтерфейсу. Кожен опублікований паспорт є підписаним, машиночитаним документом, а інтерфейс охоплює весь життєвий цикл: від типів властивостей продукту через валідацію та створення аж до публікації та подій, пов’язаних з окремим одиниці в польових умовах. Крім того, вона має версійність: той, хто сьогодні щось для неї розробляє, не будує на піску. Отже, новим є не те, що програми працюють із паспортами. Новим є те, які саме програми.

І саме тому робота асистента не обмежується лише створенням. Такий самий тип речень проходить червоною ниткою через решту резюме:

• «Відкликай усі паспорти партії B-2214.»
• «Внеси нове значення CO₂ для партії 88.»
• «Покажи мені всі паспорти, які цього місяця були відправлені на ремонт.»

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

Асистент повинен вміти запитувати, а не здогадуватися

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

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

{
  "identifiers": {
    "batchIdentifier": { "required": true },
    "modelIdentifier": { "required": true, "source": "product", "value": "4006381333931" },
    "serialIdentifier": { "required": true }
  }
}

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

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

Він повинен зрозуміти, чому щось було відхилено. Повідомлення про відхилення вказує поле та пояснює, що потрібно зробити:

PRODUCT_INVALID: Product invalid
Correct the attributes listed under fields and resend the request.
  brand: Brand needs a brand - none was given
  componentsInput: Components input missing

Асистент, який це читає, доповнює дві позиції та надсилає повторно. Той, хто отримує лише номер помилки, пробує різні варіанти. Це той самий текст, який бачить людина в командному рядку.

Він не повинен помилитися в підрахунку. Якщо з’єднання обривається і асистент робить ще одну спробу, все одно створюється лише один паспорт, а не два. Запити, що записуються, містять ключ, за яким платформа розпізнає повтор як повтор.

Кожен доступ можна скасувати

Чим більше програм працюють з вашими даними, тим важливішим стає питання, кому що дозволено. Доступ створюється в менеджері застосунку і розкриває свій секрет лише один раз. Після цього програма працює з токенами, які втрачають чинність через годину, і цей секрет надсилається лише до того місця, яке видає токени. Він зберігається у ключовому наборі операційної системи, а не в аргументі командного рядка, який інакше з’являвся б у кожному списку процесів.

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

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

Доступ, який не можна скасувати, - це не доступ, а ключ під килимком.

Ваші дані залишаються у вас

Те, що надходить до постачальника послуг ШІ, - це те, що ви отримуєте через свого асистента, а який саме асистент це буде і чи оброблятиме він дані в межах ЄС, вирішуєте ви, а не ми. До сервісу перекладу надходить значення з ваших даних про продукт лише там, де ви увімкнули переклад, і лише для вас особисто. Інструмент, який встановлює з’єднання, працює на вашому власному комп’ютері, а його вихідний код є відкритим: ваш відділ безпеки може перевірити, що він робить, замість того, щоб просто вірити йому.

Для європейської компанії це є вирішальним фактором. Сама платформа розміщена в сертифікованих за стандартом ISO 27001 центрах обробки даних у Німеччині; куди далі надходять дані, визначається виключно вибором асистента. Ви можете вибрати такого, що обробляє дані в ЄС, або такого, що ніколи не залишає меж вашої компанії: transpareo mcp обслуговує протокол на вашому власному комп’ютері, а яка саме модель за цим стоїть, вирішувати вам.

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

Налаштування займає лічені хвилини

Те саме стосується вашого особистого робочого простору за його власною адресою, наприклад https://dpp.example.com/mcp: ті самі три кроки, нічого встановлювати не потрібно.

Ті, хто віддає перевагу набору тексту або перетворенню процесів на скрипти, використовують командний рядок. « transpareo » - це окрема програма, команди якої генеруються на основі опису інтерфейсу: все, що може платформа, може й цей інструмент, без необхідності ручного узгодження обох. Вона має відкритий код і розміщена на GitHub. Три рядки: встановити, увійти, перевірити, що дозволено для цього облікового запису.

curl -fsSL https://transpareo.com/cli/install.sh | sh
transpareo auth login --host dpp.example.com --client-id <id>
transpareo me

auth login зчитує секрет зі стандартного вводу або з змінної середовища, але ніколи з аргументу, який інакше з’явився б у списку процесів та в історії оболонки. Після цього цей самий бінарний файл обробляє ці процеси:

transpareo dpps requirements --product-id 8 --granularity item
transpareo dpps validate --file passport.json
transpareo dpps create --file passport.json
transpareo dpps publish <code>
transpareo events tail --follow

Якщо на вашому комп’ютері працює помічник, його підключає ще один рядок:

transpareo setup claude

Ці самі операції стають доступними як інструменти під відповідними назвами: dpp_requirements, validate_dpp, create_dpp, publish_dpp, tail_events. Те, що ви вводите в командному рядку, і те, що викликає майстер, - це одне й те саме. До того ж є інструкція для асистентів, яка описує типові процедури, щоб нікому не довелося вивчати послідовність дій методом проб і помилок. А ті, хто воліє програмувати безпосередньо, знайдуть повний опис інтерфейсу в кожному робочому просторі за адресою /apidocs.

Помічник не коштує додатково

Нічого додаткового. Асистент підключається як користувач API, а доступ для програм входить у кожен тариф Transpareo. Підрахунок ведеться за кількістю опублікованих паспортів, а не за кількістю людей чи програм, які над ними працюють. Ті, хто автоматизує свою роботу з дотримання вимог, не повинні отримувати за це рахунки.

Робота починається ще до виконання обов’язків

З лютого 2027 року паспорт продукту для акумуляторів стане обов’язковим, інші групи товарів підуть слідом. Справжні зусилля пов’язані не з самим паспортом, а з упорядкуванням даних про продукцію, і саме цю роботу підприємства зараз доручають асистентам: збирати дані у відповідні поля, виявляти прогалини, уточнювати дані про постачальників, перевіряти, повторювати. Як ці дані взагалі потрапляють до паспорта, описано в статті «Один струм, один напрямок»; а як виглядає власне підключення для цього - у посібнику з підключення до ERP-системи.

Асистент, який змушений вгадувати, створює паспорти, що виглядають правдоподібно, але не витримують перевірки. Асистент, який може задавати питання, створює паспорти, що відповідають дійсності. Різниця полягає не в самому асистенті. Вона полягає в платформі, до якої він звертається.