Агенти за митнически и регулаторни декларации

Голям индустриален производител подава всяка година три семейства регулирани документи: годишен доклад за производствения капацитет, проучвания за разрешения за данъчни стимули и заявления за митнически разрешения. Правилата се пазеха в електронни таблици, в записани срещи и в главите на няколко специалисти, а нищо от това не беше документирано. Грешна цифра в тези документи има регулаторни последствия, затова модел, който сам произвежда числа, беше неприемлив от самото начало.

Преди да напиша какъвто и да е код, възстанових процесите в писмени спецификации. Всяко твърдение отбелязвах като доказано, теория или отворено, а зад доказаните стоеше скрипт, който го доказва. Редът на работа беше определен рано: първо генерираните документи трябваше да са верни, а интерфейсът и агентът идваха след това. Работех в малък екип. Водещият разработчик отговаряше за инфраструктурата, идентичността, шлюза към моделите и пускането на версии, а аз отговарях за модулите на отделите, проверката на изчислителните модули, договореността на интерфейсната част и шаблоните за управление. Своята част изградих с много AI агенти за програмиране, които работеха под проверки преди приемане, проектирани от мен: пиша изискванията и критериите за приемане, чета доказателствата и решавам.

1. 01

   Модули, проверявани по историята на клиента

   Моделът не прави аритметика. Всяко число идва от детерминиран изчислителен модул: генератори на документи, които възпроизвеждат доклада за капацитета във формата на всеки получател, модул за закриване на стимули, класификатор на тарифни кодове и генератор на работни листове за заявления за разрешения. Преди да се доверя на даден модул, включих в проекта оригиналните референтни страници, записах числовия им резултат като еталонен JSON и пренесеният код трябваше да съвпада с него цифра по цифра. Класификаторът е единственото място, където преценява модел, и то само на третото ниво, след търсене в регистрирани връзки и след модул с правила, изграден върху официалния текст на тарифата, а пред модела стои пакет с доказателства.

2. 02

   Нищо не се генерира без преглед

   Качените файлове първо се задържат отделно, сравняват се с текущото състояние и се съпоставят ред по ред. Двусмислено съвпадение се отхвърля, а име без съвпадение проваля вноса. Преди всеки запис предишното състояние се архивира, човек преглежда данните, преди да може да се генерира документ, а генерирането тръгва от замразена моментна снимка на данните. След това втори, независим изчислителен процес преизчислява всеки генериран файл и го изхвърля при всяка разлика. Всичко, което модулите не могат да остойностят, показва изрично състояние „няма двойка“ вместо число.

3. 03

   Агенти около страниците, с подписани одобрения

   Операторите работят върху обикновени страници, захранвани с данни през REST. Всеки отдел има един прост граф LangGraph StateGraph с възел за чат и възел за инструменти, като на всяка стъпка се извиква по един инструмент, а отгоре няма координиращ агент. Където асистент помага, той вижда състоянието на страницата и управлява същите контроли като човека. Инструментите, които променят данни, са разпределени по нива на риск: запис със среден риск чака на карта за одобрение, чийто подпис покрива каноничните аргументи, а цяла серия редакции става едно одобрение, едно решение в одита и едно повишаване на номера на ревизията. При един одит открих път, по който инструментите за запис в интерфейсната част променяха работната база данни без никаква карта, и го премахнах.

4. 04

   Заключена в мрежата на клиента

   Продукцията работи на сървър в мрежата на клиента, зад единен вход (SSO) и входна проверка. Всеки агент има собствена идентичност, а ефективните му права са сечението на правата на потребителя, на агента и на ресурса, така че правомощията могат само да се свиват. Приложението няма общ достъп до интернет: изходящите връзки следват списък с разрешени адреси, с класификация на данните за всяка дестинация, а нощен одит на изходящия трафик проверява дали телеметрията на доставчиците остава изключена. Всеки AI чат се проследява по потребител, всяко извикване на инструмент, действие на администратор и запис на данни попада в таблица за одит само за добавяне, а CI сканира контейнерните образи за уязвимости. Водещият разработчик проектира интеграционната точка за идентичността, а аз написах изискванията за изходящите връзки.

5. 05

   Пускане на версии с агенти за преглед

   Преди версия за продукция седем агента за преглед проверяваха кандидата едновременно и завеждаха находките си като задачи. Агенти за поправки работеха в изолирани git worktree, тестване в браузър върху реалните файлове на клиента откри нови блокиращи проблеми в един от процесите, а поправките бяха тествани повторно, преди всеки pull request да бъде слят, един по един, при отделен пуск на CI, по инструкция за пускане със smoke тест и стъпка за връщане към предишната версия. После продукцията работи с поправената версия. Миграциите са само напред, затова пътят за възстановяване се репетира.

Данните на клиента никога не напускат мрежата му, затова това са възстановки: същата структура, но с измислени продукти, хора и числа.

Системата работи в продукция, изградена върху четири агента за отдели и един общ процес за трите семейства документи. Коректността се доказва чрез повторно възпроизвеждане: модулът за закриване на стимули възпроизвежда и 135-те суми на закрито разрешение, собствената матрица на потреблението на клиента се преизчислява идентично във всичките 1 185 клетки, 166 от 166 реда на доклада за капацитета съвпадат с подписаните окончателни доклади, генераторът на заявления възпроизвежда и 24-те реда на одобрена декларация, а класификацията на редове за внос съвпадна с файла на клиента, класифициран на ръка, в 85 от 85 реда. В последните си пълни пускове наборът от тестове на агентската част премина 8 355 теста, а уеб наборът 1 682, като покритието на редовете беше 92,1% срещу наложен минимален праг. Същата проверка улови преувеличено твърдение за точност, преди то да излезе: независимо повторно извеждане не го потвърди и то беше махнато от чернова за клиента. Ограничения: един от четирите агента за отдели е изключен в продукция, а следенето на грешки още не подаваше данни от продукцията при последната проверка, затова твърдя само проследяването на AI чатовете, отчитането на токените и одита.