AI (Вештачка Интелигенција)

Code as Context: Empowering AI with Your System's Real Logic

Кодот како контекст: Дајте ѝ на вештачката интелигенција пристап до вистинската логика на вашиот систем

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

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

Кодот открива однесување што описите може да го пропуштат

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

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

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

Изградете патека низ логиката

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

Корисен опис на задачата може да биде краток:

  • Цел: Додајте проверка на подобноста за поврат на средства за одредена состојба на нарачката.
  • Влезна точка: Посочете го обработувачот или услугата каде што започнува барањето.
  • Правила: Посочете ги постојната валидација и премините меѓу состојби.
  • Ограничувања: Наведете кое јавно однесување мора да остане компатибилно.
  • Докази: Посочете ги релевантните тестови и проверките што треба да се извршат.

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

Дајте им на агентите алатки со јасни граници

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

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

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

Користете ги тестовите како доказ, а не како замена за разбирање

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

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

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

Одржувајте го контекстот ажурен и проверлив

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

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

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

Портрет на автор на блогот

Mihajlo

Јас сум Михајло - развивач поттикнат од љубопитност, дисциплина и постојаната желба да создадам нешто значајно. Споделувам увиди, упатства и бесплатни услуги за да им помогнам на другите да ја поедностават својата работа и да растат во постојано развивачкиот свет на софтверот и вештачката интелигенција.