Open in
Príručka štýlu promptov
Ako písať a upravovať prompt hlasového agenta ThunderPhone: kontroly pri revízii promptu podľa týchto pokynov, s ID, na ktoré sa odvolávajú ich zistenia.
Táto príručka je určená pre každého, kto píše alebo upravuje prompt hlasového agenta: pre osobu v nástroji Builder, Copilot alebo programovacieho agenta pracujúceho prostredníctvom API. Nástroj na kontrolu promptov ju používa ako hodnotiace kritériá a uvádza identifikátory jej pravidiel (P1, W2 a podobne).
Volajúci počuje agenta raz, v tempe reči, a nemôže sa vrátiť späť. Agent číta prompt pri každom kole a jeho formulácie presne kopíruje. Obe tieto skutočnosti určujú všetko nižšie uvedené.
Štruktúra
P1. Napíšte ho tak, ako by človek zaškoľoval novú recepčnú. Krátky úvod uvádza, kto agent je a pre koho pracuje. Hovor potom nasleduje v poradí, v akom prebieha: ako sa začína, čo treba zistiť, čo potvrdiť, ako sa končí. Každé pravidlo patrí do časti hovoru, v ktorej sa uplatňuje. Čitateľ by si pri každom odseku mal vedieť položiť otázku: „mohol toto napísať človek, ktorý vedie tento podnik?“ To, čo treba zistiť, zahŕňa informácie, ktoré podnik potrebuje na vybavenie požiadavky, nielen kto volá a ako ho kontaktovať.
P2. Jednoduché nadpisy, pod nimi súvislý text. Pomáhajú nadpisy ako „Kto ste“, „Hovor“, „Fakty“ a „Odovzdanie hovoru“. Štruktúra v štýle strojového zápisu však nie: číslované príručky pravidiel, nadpisy v camelCase alebo podobné kódu, dlhé odrážkové zoznamy pravidiel s pomlčkami, referencie na nástroje na začiatku ani krížové odkazy ako „pozrite si časť 4 nižšie“. Zoznamy sú vhodné pre údaje, ktoré agent vyhľadáva (otváracie hodiny, ceny, adresa).
P3. Spôsob vyjadrovania raz, stručne. To, ako agent hovorí počas celého hovoru (krátke odpovede v prvej osobe, vrúcnosť, jednoduché slová; pozrite S2), patrí do jedného krátkeho odseku v hornej časti. Všetko, čo sa týka konkrétneho kroku, patrí do tohto kroku.
P4. Fakty oddeľte od správania. Otváracie hodiny, ceny, miesta, pravidlá a ďalšie fakty patria do časti s faktami promptu alebo do databázy znalostí, nie roztrúsené v priebehu hovoru. Dlhé katalógy a časté otázky patria do databázy znalostí. Agent môže uvádzať iba fakty, ktoré dostal.
Obsah
C1. Zásady a fakty, nie scenáre. Opíšte, čo sa agent snaží dosiahnuť a čo potrebuje vedieť. Vynechajte vetvy typu „ak volajúci povie X, povedzte Y“, pripravené odpovede na očakávané otázky a predpripravené formulácie. Nakonfigurovaný úvodný pozdrav je jediným prvkom napísaným ako scenár.
C2. Oprava uvádza všeobecnú zásadu. Keď zmena promptu reaguje na pozorované zlyhanie, zmena pridá všeobecnú zásadu alebo chýbajúci fakt, nie opravu pre tento jeden prípad. Konkrétne údaje zlyhaného hovoru (mená, čísla, presné slová) do promptu nepatria.
C3. Uprednostnite odoberanie pred pridávaním. Keď možno zlyhanie vysledovať k existujúcemu pravidlu, ktoré je príliš konkrétne, príliš všeobecné alebo zle umiestnené, zmeňte alebo odstráňte toto pravidlo namiesto pridania protichodného pravidla vedľa neho.
C4. Niektoré veci určujú nastavenia, nie prompt. Toto sú nastavenia agenta a text promptu o nich sa ignoruje alebo je s nimi v rozpore: čo sa hovorí počas spúšťania nástroja (úvodná veta nástroja, výplňové frázy), kontroly pri tichu a záverečná akcia po tichu, tempo opakovania údajov, štýl prepínania jazykov, oznámenie o nahrávaní a to, či hovorí ako prvý agent alebo volajúci. Prompt nasmerujte na výsledok („pred uložením potvrďte e-mailovú adresu“) a nastavte príslušné nastavenie. Samotný úvodný pozdrav sa píše do promptu.
C5. Príklady sú vety, ktoré agent povie. Agent kopíruje formulácie z príkladov takmer slovo za slovom, preto musí byť každý príklad úplnou, prirodzenou hovorenou vetou a niekoľko rôznorodých príkladov je lepších než jeden. Uveďte ich ako príklady („Napríklad môžete povedať ...“), nie ako povinnú vetu. Skrátené označenia ako „Stále platné?“ znejú po vyslovení stroho.
C6. Žiadne príklady z hovorov našich vlastných zákazníkov. Príklady opisujú typ situácie všeobecne alebo používajú vymyslený podnik.
C7. Výzva je určená volajúcim, nie informáciám o príprave. Volajúci počujú všetko, čo výzva obsahuje, keď je aktívna, preto sa do nej nezahŕňajú poznámky o príprave, testovaní alebo stave súladu s predpismi („táto verzia je určená na testovanie“, „TEST“ v názve rezervácie, „kým nebudú podpísané dohody“). Nezahŕňajú sa ani vylúčenia zodpovednosti, upozornenia na zodpovednosť ani záverečné zhrnutia, o ktoré firma nepožiadala, napríklad čo prijatie plánu nezakladá alebo zhrnutie toho, čo ešte nie je potvrdené. Agent odpovie na to, na čo sa volajúci opýtal, a skončí; firma pridá upozornenie, keď ho chce. Chýbajúci údaj alebo systémové obmedzenie sa uvádza ako to, čo agent urobí („pri cenách ponúknite spätné zavolanie z kancelárie“), nie ako poznámka, že údaj nebol poskytnutý, ani o tom, ako sa požiadavky zaznamenávajú, a nezostáva nič z procesu tvorby, napríklad osamotené meno alebo nadpis.
Formulácia
W1. Povedzte, čo má urobiť, jasne a raz. Požadované správanie vyjadrite ako pokyn bežnými slovami: „Prečítajte číslo objednávky späť číslicu po číslici, aby ho volajúci mohol opraviť.“ Uveďte to raz tam, kde to platí.
W2. Bez zdôrazňovania. Žiadne označenia DÔLEŽITÉ, POZNÁMKA ani KRITICKÉ, žiadne slová písané veľkými písmenami na zvýraznenie, žiadne výkričníky, žiadne dvojice „Zle:“ a „Správne:“ ani bloky o tom, čo nerobiť. Sem patria aj slová ako „nikdy“, „vždy“ a „musí“, ak sa používajú na zdôraznenie. Zdôrazňovanie priťahuje pozornosť modelu k jednému pravidlu a zhoršuje jeho výkon vo zvyšku hovoru. Keď agent pokyn ignoruje, urobte pokyn jasnejším, konkrétnejším alebo ho lepšie umiestnite, nie hlasnejším.
W3. Opravte štruktúru, ktorá spôsobuje správanie. Pred pridaním pravidla proti niečomu, čo agent robí, nájdite formuláciu alebo štruktúru, ktorá k tomu vedie: šablónu, ktorú model vypĺňa doslovne, výraz s dvoma významami, vetvu if-else, ktorú rýchly model číta voľne. Zmeňte ju.
W4. Konkrétne je lepšie než všeobecné. „Ponúknite dva najskoršie voľné termíny a potom sa opýtajte, ktorý vyhovuje“ je lepšie než „pomôžte s plánovaním“. Nejasné pokyny vedú k nejasnému správaniu.
W5. Overte to predtým, než sa na to opýtate. Keď volajúci uvedie niečo, čo môže nástroj na vyhľadávanie iba na čítanie overiť (produkt, objednávku, existujúcu rezerváciu), agent to overí podľa slov, ktoré volajúci uviedol, a doplňujúcu otázku položí iba vtedy, ak si to výsledok vyžaduje. „Overte skladové zásoby produktu, ktorý volajúci uvedie, a povedzte mu, čo zistíte“ je lepšie než „upresnite značku, veľkosť a variant a potom overte skladové zásoby“: agent, ktorému je najprv povedané, aby upresňoval, sa bude stále pýtať a overenie sa nikdy nevykoná. Platí to iba pre vyhľadávania. Pred použitím nástroja, ktorý niečo rezervuje, mení, ruší alebo ukladá, agent stále potvrdí podrobnosti s volajúcim.
Reč
S1. Jedna otázka na ťah a otázka ukončuje ťah. Čokoľvek povedané po otázke prekrýva odpoveď volajúceho. Každé vysvetlenie uveďte pred otázkou.
S2. Krátke repliky v úplných hovorených vetách. Jedna alebo dve krátke vety, pokiaľ volajúci nepožiada o podrobnosti. Hovorené možnosti obmedzte na niekoľko. Krátke znamená málo slov, nie úsečné formulácie: hlasový agent hovorí tak, ako dobrý recepčný po telefóne, v úplných vetách v prvej osobe, napríklad „Hneď vám to zarezervujem“ alebo „Zapíšem si vás na pondelok o desiatej.“ Fragmenty v štýle poznámok („Zarezervujem vám to.“, „Hotovo.“, „Zapísané.“) znejú po vyslovení stroho a e-mailové formulácie („Upozorňujeme, že ...“, „Láskavo ...“, „Dúfame, že to pomôže“) znejú skôr čítane než prirodzene vyslovene. Odsek pokynu o spôsobe vyjadrovania to uvádza jasne, napríklad: „Každú repliku obmedzte na jednu alebo dve vety a hovorte v prvej osobe tak, ako by hovoril recepčný po telefóne.“
S3. Píšte pre ucho. V tom, čo agent hovorí, sa vyhnite markdownu, symbolom a zápisu, ktorý hlas prečíta zvláštne (lomky, ampersandy, „@“, „.com“, oddeľovače tisícov, telefónne čísla bez medzier). Fakty a hodnoty, ktoré agent odovzdáva nástroju, napríklad e-mailová adresa alebo číslo účtu, zostávajú v presnej písomnej podobe; ak sa niektorý údaj musí aj vysloviť, vedľa neho uveďte, ako sa vyslovuje, namiesto jeho prepísania. Uveďte, ako sa vyslovujú nezvyčajné mená alebo skratky, a pred ich ponechaním si nové výrazy vypočujte hlasom agenta.
S4. Potvrďte údaje, pri ktorých by chyba bola nákladná. Čísla, e-mailové adresy, adresy a kódy sa raz zopakujú vo forme, v akej boli uvedené, v odpovedi hneď po tom, ako ich volajúci poskytne, a pred ďalšou otázkou, pričom pri každom zopakovaní sa uvádza jedna hodnota. Meno sa štandardne prijme tak, ako bolo povedané, bez zopakovania, a hlasový agent požiada o jeho vyhláskovanie iba vtedy, ak je nezvyčajné alebo nejasné, a iba raz. Keď firma potrebuje meno presne, napríklad na zhodu so svojimi záznamami alebo pri rezervácii na toto meno, pokyn to uvedie a hlasový agent meno vyhláskuje naspäť. Zopakovanie dáva volajúcemu príležitosť opraviť hodnotu, nie je to brána: volajúci, ktorý odpovie ďalším údajom alebo pokračuje bez opravy, hodnotu prijal a na prijatú hodnotu sa už znova nepýta. Výnimkou je telefónne číslo, na ktoré firma zavolá alebo pošle správu: jeho zopakovanie ukončí repliku a čaká na odpoveď volajúceho. Pokyn, ktorý žiada čítanie po čísliciach, uvádza iba hodnoty, ktoré sa takto čítajú (telefónne číslo, kód); číslo domu, cena, čas alebo dátum sa vyslovujú tak, ako ich ľudia bežne hovoria. Pokyn určuje, čo potvrdiť; platforma určuje tempo zopakovania.
Iterácie
I1. Pred ponechaním zmeny ju otestujte. Spustite vývojovú sadu agenta na upravenom návrhu a porovnajte ju s aktuálnou verziou: ktoré príklady zmena opravila a ktoré pokazila. Odpovede čítajte tak, ako by ich počul volajúci. Čokoľvek, čo by si volajúci všimol, je problém, nie detail.
I2. Nezávislá sada sa kontroluje iba raz. Laďte iba na vývojovej sade. Testovaciu sadu spustite až keď je zmena pripravená a jej výsledok uveďte bez úprav. Zmena vykonaná po zobrazení výsledkov testu vyžaduje nové testovacie príklady.
I3. Keď sa hromadia záplaty, vykonajte refaktorizáciu. Prompt, ktorý nazbieral veľa malých opráv, sa odchyľuje od P1: pravidlá sa opakujú, sú v rozpore alebo sú ďaleko od kroku, ktorý riadia. Potom ho prepíšte do tejto podoby so zachovaním každého správania, ktoré vyžaduje. Pri každom správaní uveďte, či bolo zachované, zlúčené, preformulované alebo odstránené, a nič neodstraňujte bez uvedenia. Vývojovú sadu spustite pred aj po úprave; refaktorizácia má zmeniť formuláciu, nie správanie.
I4. Pred výzvou skontrolujte konfiguráciu. Niektoré zlyhania nie sú spôsobené výzvou: nesprávne rozpoznanie hláskovaných písmen je obmedzením rozpoznávania (vyskúšajte rozpoznávanie Plus), pomalá odpoveď môže súvisieť s úrovňou inteligencie alebo rozpoznávania či s nastavením ukončenia reči. Pred prepisovaním textu vylúčte problémy s konfiguráciou.