Zašto napisati specifikaciju prije izrade agenta
AI agent izvršava akcije u vašim sistemima u ime ljudi. Prije početka izrade tim treba zajednički, pisani odgovor na nekoliko pitanja: koji proces agent vodi, šta smije dirati, ko odobrava njegov rad, kako ćete znati da dobro radi i kako ga isključiti. Ti odgovori stoje u specifikaciji.
Specifikacija sprječava da se obim širi. Sigurnosnom timu i pravnoj službi daje nešto konkretno za pregled, a postaje i referenca kada neko mjesecima kasnije pita zašto agent smije nešto raditi. Praznine otkriva rano. Ako niko ne može reći šta agent treba uraditi kada faktura dobavljača nema narudžbenicu, to je pitanje procesa koje treba riješiti prije nego što se napiše ijedna linija koda.
Preuzimanje, ai-agent-spec.md, sadrži:
- Naslove za svih deset poglavlja, svaki s komentarom koji objašnjava šta napisati.
- Tabele za izvore podataka, alate, odobrenja, kriterije za puštanje u rad, upozorenja, rizike i izmjene.
- Skraćen razrađen primjer agenta za uparivanje faktura dobavljača, da vidite koliko detalja trebate ciljati.
Poglavlja predloška
| Poglavlje | Na šta odgovara |
|---|---|
| 1. Sažetak i odgovornost | Šta agent radi u jednom pasusu, ko je odgovoran za ishod, ko ga vodi i šta nije u obimu. |
| 2. Proces | Okidač, današnji koraci, koraci s agentom i poznati izuzeci. |
| 3. Ulazi i podaci | Koje sisteme i dokumente čita, koliko su ažurni i gdje su uključeni lični podaci. |
| 4. Alati i prava pristupa | Svaki alat koji može pozvati, da li čita ili upisuje, njegov obim i pod čijim identitetom radi. |
| 5. Odobrenja i eskalacija | Koje akcije trebaju čovjeka, ko je ta osoba, šta vidi i šta se dešava kada niko ne odgovori. |
| 6. Rezultati i kada je posao gotov | Šta agent proizvodi, u kojem formatu i kako to neko provjerava. |
| 7. Evaluacije i kriteriji uspjeha | Skup testova, pragovi za puštanje u rad i mjere koje pratite nakon toga. |
| 8. Praćenje i povratak na prethodnu verziju | Logovi, upozorenja, prekidač za gašenje i put nazad na ručni proces. |
| 9. Rizici i otvorena pitanja | Poznati načini na koje agent može pogriješiti i odluke koje tek treba donijeti. |
| 10. Evidencija izmjena | Šta se promijenilo, kada, koju verziju skupa testova je prošlo i ko je to odobrio. |
Redoslijed je važan. Poglavlja od 2 do 5 opisuju posao i njegove granice, i poslovni vlasnik treba ih odobriti prije nego što se napišu poglavlja od 6 do 8, jer pragovi i upozorenja imaju smisla tek kada je obim utvrđen. Poglavlje 9 pišite iskreno: otvoreno pitanje koje je zapisano dobije nekoga ko je za njega zadužen.