Procedurer i fri form
Uppgiftsspecifika instruktioner skrivna på naturligt språk
Översikt
En fritextprocedur beskriver en uppgift på enkelt, naturligt språk. Agenten tolkar instruktionerna och anpassar formulering och ordning efter situationen. En fritextprocedur kan anropa verktyg (inklusive systemverktyg som att avsluta ett samtal), söka upp kunskapsbasdokument och kedja vidare till andra procedurer.
När du ska använda en fritextprocedur
Använd en fritextprocedur när agenten kan anpassa formulering och ordning efter situationen och du vill skapa den snabbt med vanligt språk. Information om hur den jämförs med strukturerade procedurer, arbetsflöden och systemprompten finns i När du ska använda procedurer.
En procedurs delar
Här är en återbetalningsprocedur i redigeraren:

En procedur har två huvuddelar: en utlösare och innehåll. Båda kan innehålla infogade referenser till andra resurser, som visas i skärmbilden ovan som taggar med skiftnyckelikoner. Varje procedur har också ett namn som visas i dashboarden.
Namn
En kort etikett som identifierar proceduren i dashboarden. Namnet skickas aldrig till LLM:en, så det påverkar inte agentens beteende.
Utlösare
En beskrivning av när agenten ska använda proceduren, till exempel När användaren ber om att få en beställning återbetald.
Lämna utlösaren tom endast när du skapar en underprocedur.
Innehåll
Procedurens huvudtext, skriven i markdown. Innehållet beskriver vad agenten ska göra: ställa en fråga, slå upp en beställning, anropa ett verktyg eller avsluta samtalet. Det kan vara en numrerad följd av steg att följa eller allmän vägledning för situationen. Varje steg eller riktlinje kan vara en enda mening (Be användaren om deras beställnings-ID) eller ett kort stycke som förklarar vad som ska göras och varför.
Använd numrerade steg för åtgärder i följd och punktlistor för krav eller delpunkter inom ett steg.
Infogade referenser
Procedurer kan referera till olika typer av resurser direkt i texten:
- Verktyg (t.ex. slå upp en beställning, debitera ett kort, avsluta samtalet, överföra till en människa)
- Kunskapsbasdokument
- Andra procedurer
Använd infogade referenser när ett steg kräver att agenten använder ett verktyg, ett kunskapsbasdokument eller en annan procedur. Referenser kopplar automatiskt resursen till proceduren så att agenten kan använda den. Vanliga omnämnanden i text (som använd kalkylatorverktyget här) fungerar också, men bara om resursen redan är kopplad till agenten.
Infoga en referens genom att skriva / i utlösaren eller innehållet och välja resursen från snedstrecksmenyn. Referenser visas som klickbara taggar i redigeraren. Klicka på en tagg för att öppna den underliggande resursen och bekräfta dess konfiguration.
När du skriver fritextinnehåll via API:et infogar du referenser med följande syntax:
En infogad procedurreferens måste använda en procedur från samma agent. Se Begränsningar för information om agentomfattning och dupliceringsbeteende.
En referens i utlösaren gör att proceduren kan köras baserat på en resurs utdata, till exempel När get_user returnerar nivån ‘gold’. En referens i innehållet instruerar agenten att anropa eller konsultera resursen i det steget.

Om en refererad resurs senare tas bort, eller om ditt konto förlorar åtkomsten till den, visas taggen som trasig. Märket Fel högst upp i redigeraren listar dessa referenser: ogiltig om resursen inte längre finns, eller otillgänglig om den finns men ditt konto inte har åtkomst. Öppna märket för att se vilket steg som påverkas och åtgärda eller ta bort referensen.

Underprocedurer
En underprocedur har en tom utlösare. Agenten kan bara köra den från en annan procedur som refererar till den.
Använd underprocedurer för att dela steg inom en agent och minska antalet procedurer som är tillgängliga samtidigt. Ge startproceduren en utlösare, referera till relaterade underprocedurer från dess innehåll och lämna deras utlösare tomma.
En underprocedur för eskalering kan innehålla stegen för att lämna över samtalet till en människa. Referera till den från procedurerna för återbetalning och avbokning och lämna dess utlösare tom. Agenten kan eskalera som ett steg i båda procedurerna, men utanför dem förblir underproceduren otillgänglig.
Importera från ett dokument
Du kan börja med en befintlig standardprocedur (SOP). Välj Från SOP i procedurlistans +-meny och ladda sedan upp en fil.
Format som stöds: PDF, DOCX, TXT, MD, HTML, EPUB. Filer måste vara högst 20 MB.
Importverktyget analyserar dokumentet, identifierar upp till 10 separata procedurer och skapar ett utkast för var och en med ett genererat namn, en utlösare och innehåll. Öppna varje utkast för att förfina det. Om dokumentet innehåller fler än 10 SOP:er delar du upp det i mindre filer innan du laddar upp det.

Hantera en fritextprocedur
Skapa via dashboarden
Hantera via API:et
Öppna din agent i dashboarden och välj sedan Procedurer. Använd + för att skapa en fritextprocedur. Lägg till en utlösare och skriv instruktionerna i innehållsredigeraren. Publicera sedan agentändringarna.
Bästa praxis
Agenten måste välja rätt procedur utifrån dess utlösare och följa innehållet. Mer kapabla modeller gör detta mer tillförlitligt när antalet procedurer ökar. Se Modeller för alternativ.
Att skriva bra procedurer innebär att skriva två delar väl: en utlösare som kör proceduren när den ska köras, och innehåll som agenten kan följa.
Skriva utlösare
Håll utlösare konkreta och separata
Överlappande eller vaga utlösare kan göra att fel procedur körs. Föredra När användaren ber om att avsluta en prenumeration framför _När användaren har en fråga om sitt konto _.
Skriv ur användarens perspektiv
Beskriv vad användaren ber om, inte vad agenten ska göra. Utlösare som formuleras som agentåtgärder är mindre tillförlitliga.
Täck hur användare faktiskt frågar
En snäv utlösare kan missa verkliga förfrågningar när användaren uttrycker sig annorlunda. Inkludera variationerna som användaren kan säga. När användaren ber om återbetalning, vill returnera eller få tillbaka pengar för en beställning körs mer tillförlitligt än _När användaren begär en återbetalning _.
Skriva innehåll
Använd imperativ
Skriv steg som instruktioner till agenten: Slå upp kundens senaste beställning i stället för _Du bör slå upp kundens senaste beställning _. Direkta instruktioner är enklare att följa än förslag.
Förklara varför ett steg är viktigt
Resonemang kan tillämpas på specialfall som proceduren inte räknar upp. Ett kort eftersom vi behöver beställnings-ID:t för att utfärda en återbetalning hjälper agenten att hantera situationer som stegen inte förutsåg. Undvik krav med enbart versaler och rigida manus när en förklaring på en rad gör samma jobb.
Håll varje procedur fokuserad på en uppgift
Om en procedur börjar förgrena sig till orelaterade resultat delar du upp den i mindre procedurer och låter agenten dirigera mellan dem.
Sätta ihop procedurer
Bryt ut delade steg till en egen procedur
Om samma steg förekommer i flera procedurer (verifiera en kunds identitet, slå upp en beställning, eskalera till en människa), bryter du ut dem till en särskild procedur och refererar till den från var och en som behöver den via snedstrecksmenyn. Att underhålla de delade stegen på ett ställe gör alla procedurer som använder dem konsekventa.
Använd underprocedurer för reaktiva åtgärder
Använd en underprocedur för en åtgärd som agenten bara ska köra när en annan procedur begär den, som identitetsverifiering eller eskalering. Utan utlösare konkurrerar den inte med startprocedurer när samtalet börjar. Färre val av utlösare håller dirigeringen fokuserad.
Använd systemprompten för globalt beteende
Ton, identitet, policyer för att avböja och skyddsräcken hör hemma i systemprompten. Lägg uppgiftsspecifika steg i procedurer.
Procedurer versioneras med agenten
Procedurer är en del av agentens konfiguration, så de sparas tillsammans när du publicerar en ny agentversion. Återställ en tidigare agentversion för att gå tillbaka till en tidigare uppsättning procedurer. Se Agentversionering.
Börja med befintlig dokumentation
Om ditt team redan har SOP:er använder du importverktyget för att omvandla dem till utkast och förfinar dem sedan.