Агент со вештачка интелигенција станува навистина корисен кога ќе престане да наликува на паметно поле за автоматско довршување и ќе почне да се однесува како добро интегриран соиграч: таков што може да го разгледа контекстот, да преземе ограничени дејства, да извести што направил и да ја врати контролата во вистинскиот момент.

Таа разлика е важна. Помошникот одговара на прашање или изработува нацрт на функција. Агентот учествува во работен тек. Тој може да следи неуспешен тест низ граница на услуга, да предложи тесна закрпа, да ги изврши релевантните проверки и да ги сумира доказите. Кога се користи добро, тој не ја заменува инженерската проценка. Ги приближува рутинското истражување и извршувањето до местото каде што веќе се наоѓа кодот.

Сметајте ги агентите за системи, а не за прозорци за разговор

Интерфејсот за разговор е само видливиот раб на агентот. Корисниот дел е системот околу него: моделот, упатствата, алатките што може да ги повика, контекстот од кодната база што може да го прочита, ограничувањата на неговите овластувања и повратните информации што ги добива по дејствувањето.

Ако некој од тие делови е нејасен, и излезот на агентот ќе биде нејасен. Давањето широк пристап на агент без јасни граници создава ризик. Давањето совршени граници, но без релевантен контекст, создава непотребна работа. Сигурното усвојување произлегува од намерно дизајнирање на целиот циклус.

• Контекст: структурата на складиштето, конвенциите, описот на задачата, релевантните датотеки и тековната состојба на работата.
• Алатки: тесно ограничени способности како пребарување код, извршување тест, читање дневници или отворање барање за повлекување.
• Овластување: експлицитна дефиниција за тоа што агентот смее да чита, менува, извршува или испраќа.
• Потврда: тестови, lint-проверки, преглед, проверки на политики и човечка потврда таму каде што последиците се важни.

Ова не се административни детали. Тие се разликата помеѓу впечатлива демонстрација и сигурна инженерска способност.

Почнете со работни текови што имаат јасни граници

Најдобрите почетни случаи на употреба обично не се „изгради ја целата функционалност“. Тоа се повторливи, ограничени задачи со набљудливи критериуми за успех. Добриот работен тек за агент има дефиниран влез, ограничен сет дејства и начин да се утврди дали резултатот е прифатлив.

На пример, агент може да истражи неуспешна задача за континуирана интеграција со читање на излезот од неуспехот, лоцирање на засегнатиот код и тестови и изработка на концизна дијагноза. Може да ја ажурира документацијата по промена на API, под услов да му се прикажани договорот за API и конвенциите за документацијата. Може да подготви гранка за ажурирање на зависност, да ги изврши постојните команди за валидација и јасно да ги разликува успешните проверки од нерешените неуспеси.

Корисен почетен образец: дијагностицирај, предложи, потврди

Наместо да му дадете дозвола на агентот да прави произволни промени, побарајте од него да работи по фази:

1. Разгледај го релевантниот контекст и преформулирај го проблемот со конкретни поими.
2. Идентификувај ги веројатните причини и најмалата безбедна промена.
3. Направи ја промената само во дозволениот опсег.
4. Изврши ги наведените проверки и пријави го нивниот вистински исход.
5. Ескалирај ја неизвесноста наместо да ги пополнуваш празнините со самоуверени претпоставки.

Овој образец го задржува човекот одговорен за одлуките, додека му овозможува на агентот да го намали триењето при извршувањето. Тој создава и трага за ревизија што прегледувачите можат брзо да ја оценат.

Дајте му на агентот контекст својствен за складиштето

Многу слаби промени потпомогнати со вештачка интелигенција не се неуспеси на моделот; тие се неуспеси на контекстот. Агентот гледа тикет и неколку датотеки, но не и архитектурата на проектот, правилата за именување, стратегијата за тестирање, ограничувањата за распоредување или локалните упатства. Потоа произведува код што е веродостоен изолирано, но незгоден во кодната база.

Направете го знаењето за проектот достапно таму каде што се одвива работата. Чувајте концизни инженерски насоки блиску до складиштето: како да се постави проектот, кои команди се меродавни, каде припаѓа конфигурацијата, кои модули се сопственици на кои области и што не смее да се менува непромислено. Претпочитајте конкретни упатства како „изврши ги насочените единични тестови пред целиот пакет“ наместо општи совети како „обезбеди квалитет“.

Контекстот треба да биде селективен, а не максимален. Внесувањето цело складиште во потсетник е скапо и одвлекува внимание. Добриот агент ги прибира датотеките и правилата релевантни за тековната задача, а потоа бара повеќе информации кога ќе наиде на граница што не може безбедно да ја заклучи.

Пристапот до алатки треба да се заслужи и да биде слоевит

Агент што може да чита код се разликува од оној што може да го менува. Агент што може да измени локална гранка се разликува од оној што може да распореди производна инфраструктура. Третирајте ги како одделни нивоа на доверба.

• Прво дозволете истражување само за читање: пребарување, проверка на датотеки, графови на зависности, излез од тестови и дневници.
• Потоа дозволете локални измени, идеално на изолирана гранка или работен простор.
• Барајте валидација пред да се предложат промени за преглед.
• Задржете ги надворешните последици, како распоредувања, измени на податоци и комуникација со клиенти, зад експлицитно одобрување.

Принципот на најмали привилегии не е кочница за усвојувањето агенти. Тој е она што го овозможува поширокото усвојување. Тимовите имаат доверба во системи што неуспеваат безбедно и ги прават своите дејства разбирливи.

Валидацијата е проверка на реалноста за агентот

Јазичните модели се одлични во генерирање веројатни следни чекори. Испораката на софтвер бара докази дека тие чекори успеале. Тестовите, проверките на типови, статичката анализа, чекорите за градење и прегледот се начинот на кој предлогот на агентот се соочува со реалноста.

Бидете прецизни за тоа што значи „завршено“. Ако промена влијае на парсер, извршете ги фокусираните тестови на парсерот. Ако влијае на јавен интерфејс, потврдете ги очекувањата за компатибилност. Ако команда не успее поради недостапна услуга или недостасувачки акредитиви, агентот треба јасно да го пријави тоа ограничување, а не да тврди успех затоа што кодот изгледа исправно.

npm run test -- --runInBand
npm run lint
npm run build

Тие команди се корисни само кога навистина се предвидените проверки на проектот. Принципот е поважен од командата: прво потврдете го најтесното релевантно однесување, а потоа проширете ја довербата по потреба.

Дизајнирајте за преглед, а не за тивка автономија

Прегледот на код останува вреден кога се вклучени агенти, но неговиот акцент се менува. Прегледувачите треба да поминуваат помалку време во исправка на форматирање и шаблонски код, а повеќе во проверка на претпоставки, граници, безбедносни импликации, оперативно однесување и дали тестовите го докажуваат вистинското нешто.

Ефективното резиме од агент треба да одговори на непосредните прашања на прегледувачот: што се промени, зошто се промени, кои датотеки беа допрени, што беше потврдено и што останува неизвесно. Краток, но искрен извештај е повреден од дотерано објаснување што прикрива неуспешен тест или непотврдена претпоставка.

Целта не е вештачката интелигенција да изгледа автономна. Целта е инженерската работа да стане попромислена, набљудлива и полесна за придвижување напред.

Мерете го работниот тек, а не новитетот

Примамливо е агентите да се оценуваат според најдраматичната задача што ја завршуваат. Подобро прашање е дали работниот тек станал побрз, побезбеден, појасен или полесен за одржување. Дали тријажата стана поконзистентна? Дали развивачите трошат помалку време во лоцирање рутински информации? Дали квалитетот на прегледот се подобри затоа што промените пристигнуваат со подобри докази?

Следете ги и скриените трошоци. Ако инженерите мораат постојано да го поправат излезот на агентот, да реконструираат недостасувачки контекст или да прегледуваат огромни разлики, системот сè уште не заштедува време. Стеснете ја задачата, подобрете ги упатствата, додајте чекор за валидација или отстранете непотребна дозвола за алатка.

Направете го агентот дел од оперативниот модел на кодната база

Најтрајното усвојување на вештачката интелигенција нема да произлезе од барањето моделот да биде брилијантен по команда. Ќе произлезе од градење работни текови во кои моделот го има вистинскиот контекст, ограничени овластувања, сигурни проверки и јасно предавање на луѓето.

Тоа е поскромна визија од целосно автономен програмер, и многу покорисна. Агентот станува составен дел од кодната база кога му помага на тимот да ја зачува намерата, да ги скрати циклусите на повратна информација и да го претвори рутинскиот напор во потврден напредок. Кодната база останува извор на вистина; агентот станува способен учесник во одржувањето на нејзината здравост.