Razvoj

Beyond Prompts: Architecting AI's Business Sense from Your Code

Više od promptova: oblikovanje poslovnog razumijevanja umjetne inteligencije na temelju vašeg koda

Asistent s umjetnom inteligencijom može objasniti što PHP metoda radi, a ipak pogrešno razumjeti čime se vaša tvrtka bavi. Može naići na metodu refund() i pretpostaviti da se svako plaćanje može poništiti, dok stvarno pravilo ovisi o statusu namire, prodajnom kanalu i iznimci dogovorenoj s pružateljem platnih usluga.

Taj jaz obično nije problem u promptu. To je arhitekturni problem: poslovno značenje raspršeno je po kodu, konvencijama baze podataka, konfiguraciji i znanju ljudi koji ih održavaju. Bolji promptovi pomažu asistentu postavljati korisna pitanja, ali ne mogu pouzdano pružiti pravila koja u sustavu nikada nisu izričito definirana.

Kod sadržava poslovno znanje, ali nije sve očito

Pozadinski sustavi ugrađuju odluke u mnogim oblicima. Ograničenje baze podataka može spriječiti dupliciranje računa. Uvjetna naredba može razlikovati korisnika probnog razdoblja od korisnika koji plaća uslugu. Radni proces reda čekanja može ponovno pokušati obraditi obavijest o plaćanju, dok druga usluga odlučuje je li sigurno obraditi tu obavijest dvaput.

Ti su detalji važni, ali za njihovo razumijevanje potreban je kontekst. Polje naziva status moglo bi predstavljati stanje vidljivo korisniku, interni korak u radnom procesu ili oznaku za integraciju sa zastarjelim sustavom. Čak i točni sažeci koda mogu propustiti objasniti zašto pravilo postoji ili primjenjuje li se na novu funkcionalnost.

Započnite utvrđivanjem poslovnih pojmova koji imaju najveće posljedice: novac, dozvole, obveze prema korisnicima, zalihe i regulatorne obveze. Za svaki od njih potražite pravila koja aplikacija provodi i pretpostavke povezane s njima. Komentare i dokumentaciju smatrajte izvorima koje treba provjeriti u odnosu na ponašanje sustava, a ne automatskim dokazom.

Smjestite važna pravila unutar jasnih granica

Alati umjetne inteligencije rade s materijalom koji mogu pronaći. Isto vrijedi i za razvojne programere. Pravilo izraženo na jednom jasno nazvanom mjestu lakše je pronaći i procijeniti nego isto pravilo ponovljeno u kontrolerima, zakazanim zadacima i SQL upitima.

Razmotrite narudžbu koja se može otkazati samo prije nego što je otpremljena. Umjesto da ponavljate usporedbu statusa svugdje gdje se nudi otkazivanje, smjestite odluku u domenski model ili aplikacijsku uslugu:

final class Order
{
    public function __construct(
        private string $status,
    ) {}

    public function canBeCancelled(): bool
    {
        return in_array($this->status, ['new', 'confirmed'], true);
    }
}

Naziv metode jasno izražava poslovno pitanje, a implementacija daje konkretan odgovor. Ovaj je primjer namjerno jednostavan: stvarni postupak otkazivanja može zahtijevati i autorizaciju, promjenu stanja, trajnu pohranu te koordinaciju s procesom ispunjavanja narudžbe. Ako se otprema i otkazivanje mogu dogoditi istodobno, sustav mora zaštititi i odluku i ažuriranje kao cjelinu, primjerice odgovarajućom transakcijom baze podataka i strategijom zaključavanja.

Cilj nije svaku uvjetnu naredbu smjestiti u klasu. Cilj je omogućiti prepoznavanje, dosljednu primjenu i testiranje odluka koje imaju važne posljedice. Asistent kojemu se zada promjena ponašanja pri otkazivanju tada može pregledati jasno određeno mjesto umjesto da nagađa koja je od nekoliko sličnih provjera mjerodavna.

Učinite poslovni ugovor vidljivim

Kod pokazuje što sustav trenutačno radi. Sažet ugovor može objasniti što bi trebao jamčiti i gdje to jamstvo prestaje. Držite te bilješke dovoljno blizu implementacije kako bi se promjene mogle zajedno pregledavati.

Za API koji prihvaća zahtjeve za otkazivanje koristan ugovor mogao bi objasniti u kojim je stanjima narudžbe dopušteno otkazivanje, tko ga smije zatražiti, kakav odgovor pozivatelj dobiva kada je narudžba već otpremljena i ima li ponavljanje uspješnog zahtjeva isti učinak. Trebao bi navesti i sve naknadne radnje, poput obavještavanja skladišta, te što se događa ako te radnje ne uspiju.

Primjeri olakšavaju tumačenje tih pravila. Test nazvan prema poslovnom ishodu, kao što je odbijanje otkazivanja nakon otpreme, pruža konkretan scenarij koji mogu pratiti i razvojni programer i asistent. Testovi pokazuju ponašanje koje je njima obuhvaćeno; ne dokazuju da je obuhvaćen svaki važan scenarij.

Zabilježite i neriješena pitanja. „Može li se potvrđena narudžba otkazati nakon što je skladište započelo pakiranje?” korisnije je nego prešutno dopustiti asistentu da iz nepotpune implementacije sam izvede odgovor. Neizvjesnost je dio konteksta sustava.

Omogućite umjetnoj inteligenciji pristup dokazima

Predaja cijelog repozitorija asistentu rijetko može zamijeniti usmjeravanje njegove pozornosti. Veliki sustavi sadržavaju zastarjele putanje, konkurentske implementacije i operativne detalje koji se možda ne odnose na zadatak.

Postavite asistentu jasno ograničeno pitanje i uputite ga na relevantne dokaze. Na primjer:

Objasni trenutačna pravila otkazivanja za narudžbe stvorene putem javnog API-ja. Pregledaj krajnju točku, aplikacijsku uslugu, relevantna ograničenja trajne pohrane i testove. Utvrdi proturječnosti u ponašanju i pitanja koja zahtijevaju poslovnu odluku. Za svaki zaključak navedi datoteke i metode na kojima se temelji.

Ovaj zahtjev traži istraživanje, a ne izmišljanje pravila. Pregledajte navedeni kod, osobito kada zaključak ovisi o konfiguraciji, zastavicama funkcionalnosti, stanju baze podataka ili ponašanju druge usluge. Ako asistent predloži promjenu, zatražite da prati tijek uspješnog izvršavanja i tijekove u slučaju pogreške: što se sprema, što se može ponovno pokušati i što pozivatelj može sigurno ponoviti.

Zaštitite kontekst koji dijelite

Za koristan kontekst nije potrebno predati svaki produkcijski zapis ili pristupnu vjerodajnicu. Upotrijebite reprezentativne primjere iz kojih su uklonjene osjetljive vrijednosti i slijedite pravila svoje organizacije za alate i podatke kojima se koristite. Sheme baze podataka i primjeri testnih podataka iz kojih su uklonjeni osjetljivi podaci često mogu objasniti odnose bez otkrivanja podataka o korisnicima.

Zaokružite postupak kada se sustav promijeni

Poslovno znanje zastarijeva kada se kod, testovi i objašnjenja počnu razilaziti. Uključite relevantni ugovor u promjenu: kada se promijeni pravilo otkazivanja, zajedno pregledajte ponašanje API-ja, domensku logiku, testove i operativne posljedice. U zahtjevu za spajanje može se navesti pravilo koje se mijenja i uputiti pregledavatelje na dokaze.

Takva disciplina poboljšava i rad na performansama te arhitekturne odluke. Prije predmemoriranja odluke o ispunjavanju uvjeta, primjerice, utvrdite koje činjenice utječu na nju i koliko brzo promjena neke od njih mora stupiti na snagu. U suprotnom, tehnički brz odgovor može biti poslovna pogreška.

Umjetna inteligencija postaje korisnija kada odluke može povezati s jasnim pravilima i konkretnim dokazima. Trajno ulaganje nije savršen prompt, nego baza koda koja svoje poslovne obveze prikazuje dovoljno jasno da ih ljudi i alati mogu preispitivati, mijenjati i održavati.

Portret autora bloga

Mihajlo

Ja sam Mihajlo — programer vođen znatiželjom, disciplinom i stalnom željom da stvorim nešto smisleno. Dijelim uvide, tutorijale i besplatne usluge kako bih pomogao drugima da pojednostave svoj rad i rastu u svijetu softvera i umjetne inteligencije koji se neprestano razvija.