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

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

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

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

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

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

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

Запитували список; прочитали стан.

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

Ось чому з’явилася ця стаття. У решті тексту пояснюється, чому це працює.

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

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

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

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

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

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

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

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

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

І тому робота асистента не закінчується на етапі створення. Такий самий тип запиту застосовується протягом усього життєвого циклу:

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

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

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

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

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

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

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

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

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

PRODUCT_INVALID: Продукт недійсний
Виправте атрибути, перелічені в полях, та надішліть запит знову.
  brand: Потрібно вказати бренд - його не вказано
  componentsInput: Відсутні дані про компоненти

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

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

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

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

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

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

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

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

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

Для європейської компанії це є вирішальним моментом. Сама платформа розміщена в сертифікованих за стандартом 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, а доступ для програм входить у кожен тарифний план. Підраховуються опубліковані паспорти, а не кількість людей чи програм, які над ними працюють. Той, хто автоматизує свою роботу з дотримання вимог, не повинен отримувати за це рахунок.

Робота починається ще до набрання чинності

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

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