Agentske radnje: pretraga, kontakt i rezervacija

Jasne agentske radnje čine javni sajt upotrebljivim za model: pretraga, kontakt, rezervacija i jasan checkout, umjesto nade da će agent pogoditi pravu kontrolu u neurednom rasporedu. Čovjek se snađe i na zbunjujućoj stranici. Agent često pogodi, promaši polje i stane, a upit ili prodaja nestanu bez zapisa o tome gdje je stao.

Verzija koju možete isporučiti sada običan je web posao. Stranice koriste pravi HTML, adrese ostaju stabilne, a mali opisani API vraća iste činjenice koje stranica pokazuje: naslove, cijene, slobodne termine i URL na kojem čovjek završava. Nema posebnog sajta za agente, i prijedlog u browseru to neće uraditi umjesto vas.

Ovo je za prodavnice, klinike, hotele i firme koje već imaju pretragu, formu, kalendar ili korpu. Asistent treba da uradi prve korake koje bi kupac uradio, pa da vrati link kojem čovjek može vjerovati. Sam asistent je zaseban posao, pokriven u našoj izradi AI chatbota i agenata. Ovaj tekst je o javnom sajtu koji taj agent mora da koristi.

Četiri agentske radnje koje vrijedi izložiti prve

Počnite od četiri operacije koje kupac već razumije. Svaka ima stabilan URL, zapisan rezultat i pravilo ko je potvrđuje. Povrate, ponude po mjeri i otvorene zahtjeve ostavite po strani dok ove četiri ne budu pouzdane.

Pretraga

Pretraga je čitanje. /search?q=blue+coat mora raditi i kad se podijeli ili ponovo povuče sutra. Odgovarajući API, /api/search, vraća iste pogodke koje stranica pokazuje: naslov, URL, cijenu i to da li se stavka može kupiti ili rezervisati. Agent citira ta polja i ne izmišlja proizvod koji nije u odgovoru.

Kontakt

Kontakt je poruka osobi kod vas. Polja su ona sa forme: ime, mejl, tema, tekst. Agent smije da sastavi nacrt sa posjetiocem, a ne smije da ga pošalje dok posjetilac tekst ne vidi i ne pristane. Greška imenuje polje. Uspjeh vraća broj reference, a ne samo riječ hvala.

Rezervacija

Rezervacija počinje kao još jedno čitanje: slobodni termini za uslugu, sa vremenskom zonom i vremenom kraja. Kratko držanje zauzima jedan termin, a potvrda tog držanja pravi zakazivanje. Ponovni poziv poslije prekida veze mora vratiti prvi termin, a ne drugi. Termin koji nije u odgovoru o dostupnosti ne može se rezervisati.

Checkout

Checkout je jasan korak, a ne šetnja kroz korpu. Agent smije dodati poznat proizvod i količinu, pa pročitati ukupno sa servera i checkout URL. Osoba plaća na toj stranici. Agent ne unosi broj kartice, ne mijenja cijenu i ne označava narudžbu plaćenom. Kako se sama prodavnica gradi, opisano je u našoj izradi online prodavnice. Isporučite ove agentske radnje prije nego što dodate petu.

Forme koje su pravi HTML

Agent, browser bez JavaScripta i korisnik tastature trebaju isto: form sa action, method, label na svakom polju i dugme za slanje. Divovi koji reaguju samo na klik nevidljivi su svemu što ne pokrene vaš bundle. HTML form element je ugovor, i API treba da prima ista imena polja.

Greške stoje pored polja, a vrijednosti koje je posjetilac ukucao ostaju tu. Potvrda koja nikad ne mijenja URL ne može se kasnije podijeliti. URL potvrde može. Bez pravih polja i pravog action URL-a, agentske radnje nemaju šta stabilno da pozovu.

• Jedna forma, jedna svrha. Kontakt nije pomiješan sa prijavom na novosti na istom slanju.
• Obavezna polja označena su u HTML-u, a ne samo obojenim okvirom.
• Stanja uspjeha i greške imaju svoju adresu ili jasan odgovor.
• Stranica se i dalje šalje ako skripta padne. Skripta smije da poboljša formu. Ona nije forma.

Potvrda prije nego što agentske radnje nešto pošalju ili naplate

Čitanja mogu odmah. Upisi čekaju. Prije nego što poruka ode, termin se potvrdi ili novac krene, posjetilac vidi tačan sadržaj: primaoca, tekst, cijenu i šta slijedi. Agent priprema taj pregled. Posjetilac ga prihvata. Siguran model nije prihvatanje.

Dokumentacija za agentske radnje uključuje ovu tabelu. Ako nova funkcija ne staje ni u jedan red, ne isporučuje se kao poziv koji model smije sam da izvrši.

Idempotency za poruke, rezervacije i korpe

Agenti ponavljaju. Istek vremena i drugi klik izvana izgledaju isto. Idempotency znači da ponavljanje vrati prvi rezultat umjesto da ponovi efekat. Klijent šalje jedan Idempotency-Key po namjeravanoj operaciji. Taj ključ čuvate uz odgovor u prozoru koji izaberete, često oko jednog dana. Isti ključ sa istim tijelom vraća prvu rezervaciju. Isti ključ sa drugim tijelom je sukob, a ne nova narudžba.

Posjetilac pravi novi ključ samo kad zaista hoće novi zahtjev. Istek vremena ponovo koristi isti ključ. Idempotency čuva agentske radnje od druge rezervacije ili drugog mejla. Ne zamjenjuje potvrdu. Samo čini potvrdu sigurnom za ponavljanje.

Auth za radnje na nalogu

Javna pretraga i javna dostupnost ne traže prijavu. Dovoljno je ograničenje broja poziva i uzak odgovor. Kontakt i rezervacija mogu ostati anonimni kad već primate anonimne upite, uz potvrdu i idempotency, a agentske radnje na nalogu rade samo kao taj posjetilac: njegove narudžbe, njegova adresa, njegov termin. Sesija je ona koju je osoba otvorila, ili token koji je dala za taj opseg.

• Ne stavljajte lozinku osoblja ni admin API ključ u prompt, widget ili javni dokument.
• Token koji čita narudžbe jednog kupca ne čita tuđe i ne radi povrat.
• Opoziv pristupa je običan put, a ne hitni postupak koji smišljate kasnije.
• Interni alati ne idu na javni API. Pripadaju privatnom serveru, opisanom ispod.

Šta ostaje čovjeku

Neki posao ne treba da postane alat. Plaćanje ne spada u agentske radnje koje ostavljate bez nadzora. Isto važi za povrat, žalbu, izuzetak u cijeni i svako obećanje iza kojeg vaše osoblje mora stati. Ako zahtjev traži procjenu, vratite link ka osobi, sa već upisanim kontekstom.

• Brojevi kartica, jednokratne lozinke i pune lozinke naloga nikad ne idu kroz model.
• Pravno prihvatanje, gdje tražite da se osoba složi, dešava se na vašoj stranici.
• Medicinski, pravni ili finansijski savjet ostaje kod stručnjaka koji smije da ga da.
• Sve što API dostupnosti ili kataloga nije ponudio razgovor je, a ne upis.

Javni sajt nije privatni MCP server

Uvod u Model Context Protocol opisuje kako se asistent veže na alate: fajlove, baze, interne API-je. Taj obrazac odgovara poslu unutar firme, gdje je osoblje poznato i mreža vaša. Greška je i dalje ozbiljna, ali pozivalac nije cijeli internet.

Na javnom sajtu pozivalac nije neko koga ste vi pustili unutra. Ne vidite njegov prompt. Javne agentske radnje ostaju malobrojne jer pozivalac nije vaš kolega. Podaci su ili javni ili pripadaju jednom posjetiocu pred ekranom. Svaki upis čeka tog posjetioca.

• Publika. Privatni MCP server služi vašem timu. Sajt služi kupcima i njihovim asistentima.
• Pristup. Identitet osoblja ostaje privatan. Javna strana nema ključ, ili ima sesiju koju je posjetilac napravio.
• Opseg. Interni alati smiju biti široki. Javni alati su četiri radnje, svaka sa listom odbijanja.
• Pad. Kolega može ponoviti interni alat. Javni upis mora ostati siguran kad je ponavljanje automatsko.

WebMCP je prijedlog, a ne obaveza za lansiranje

WebMCP je rani prijedlog za browser: stranica izlaže alate agentu kroz browser, umjesto da svaki sajt izmišlja privatni kanal. Vrijedi znati za njega. Nije kućica koju morate označiti prije nego kupac koristi sajt, i nije nešto što svaki javni sajt mora isporučiti sada. Za posjetioce se danas možete osloniti na HTML, URL i HTTP.

Nećemo držati lansiranje zbog WebMCP-a, niti zvati sajt nedovršenim jer preskače prijedlog. Ako browseri kasnije ponude stabilan način da se alati registruju, registrujte one koje ste već opisali. Iste agentske radnje u browser API-ju mogu sačekati dok taj put ne bude stvaran za vaše kupce.

Do tada praktičan skup čine čist HTML, stabilni URL-ovi i mali API sa potvrdom, idempotencyjem i authom tamo gdje radnja dira nalog. Čovjek i skripta mogu taj skup testirati odmah. Prijedlog nije test.

Greške koje kvare agentske radnje

• Jedini put je handler na klik, bez forme, bez URL-a i bez API-ja.
• Stranice rezultata koriste adresu sesije koja istekne, pa agent ne može predati link.
• Dokumentacija nabraja polja koja API ne vraća, a model popunjava rupe.
• Jedan endpoint smije da traži, šalje, zakazuje i naplaćuje, pa jedna greška ima najširi efekat.
• Upisi nemaju idempotency ključ, pa istek vremena postane dva mejla ili dva termina.
• WebMCP se tretira kao projekat, dok kontaktna forma i dalje pada bez JavaScripta.

Sredite HTML i URL-ove prije nego što objavite još agentske radnje. Peti alat povrh pokvarene forme ne čini sajt lakšim za korištenje.

Kako radimo

1. Upoznavanje. Nabrajemo četiri puta, ko potvrđuje svaki upis i koji su podaci javni.
2. Plan. Zapišemo mapu URL-ova, imena polja, greške i tekst potvrde prije izrade.
3. Izrada. Uradimo HTML forme, mali API, idempotency i ograničenje broja poziva, da se stranica i API slažu.
4. Test. Čovjek završi svaku radnju. Skriptovani klijent zatim zove iste URL-ove, uključujući ponavljanje.
5. Pokretanje. Kratak dokument imenuje agentske radnje, polja i greške. Nadzor prati upise, a ne samo preglede stranica.
6. Podrška. Kad se stranica promijeni, mijenja se i radnja. Redizajnirana forma koja tiho preimenuje polja je greška.

Zašto CodeWiz

• Stranica i API zajedno. CodeWiz je 2023. u Banjoj Luci osnovao Dragan Plavšić. Radimo web stranice, API-je, e-commerce i SEO, tako da se radnja poklapa sa stranicom koju ljudi već koriste.
• Lokalno i na daljinu. Radimo sa klijentima u Bosni i Hercegovini i u drugim zemljama, na stacku koji sajt već koristi.
• Pretraga koja je pravi URL. Tehnički SEO i stabilna adresa pretrage isti su posao.
• Jasan checkout. Posjetilac plaća na vašem koraku plaćanja. Model ne smije da plati.
• Kratak ugovor. Radnje, polja, potvrda i greške, zapisani tako da ih vaše osoblje može čuvati. Nema garancije ranga.

Često postavljana pitanja

Šta su agentske radnje na sajtu?

To su imenovane operacije koje javni sajt izlaže namjerno: pretraga, kontakt, rezervacija i checkout. Svaka ima adresu, oblik rezultata i pravilo ko je potvrđuje. To nije nada da će model razumjeti neurednu stranicu.

Morate li uvesti WebMCP?

Ne. WebMCP je rani prijedlog za browser. Isporučite čist HTML, stabilne URL-ove i mali opisani API. Browser API za alate pogledajte ponovo tek kad ga možete testirati sa vašim posjetiocima.

Može li agent završiti plaćanje?

Može složiti korpu i otvoriti vaš checkout URL. Posjetilac plaća na toj stranici, preko vašeg provajdera plaćanja. Agent ne skuplja brojeve kartica i ne označava narudžbu plaćenom.

Je li ovo isto što i privatni MCP server?

Ne. Privatni MCP server vezuje asistenta na interne alate za ljude kojima vjerujete. Javni sajt zovu posjetioci koje ne kontrolišete, pa je lista kraća i svaki upis čeka.

Hoće li ovo pomoći SEO?

Stabilni URL-ovi i pravi HTML su ono na čemu tehnički SEO već stoji. Isti posao pomaže čovjeku da podijeli rezultat i agentu da ga povuče. Ne obećavamo poziciju u pretrazi.

Krenite od četiri puta koja već imate

Recite nam šta od pretrage, kontakta, rezervacije i checkouta već postoji, i šta padne kad pozivalac nije pažljiv čovjek. Na stranice koje već imate mapiramo agentske radnje, uključujući potvrdu i opisani API. Javite nam se da krenemo, ili pogledajte naše usluge.