Friformsprocedurer

Översikt

En friformsprocedur beskriver en uppgift på enkelt, naturligt språk. Agenten tolkar instruktionerna och anpassar formuleringen och ordningen efter situationen. En friformsprocedur kan anropa verktyg (inklusive systemverktyg som att avsluta ett samtal), slå upp dokument i kunskapsbasen och kedja till andra procedurer.

När du ska använda en friformsprocedur

Använd en friformsprocedur när agenten kan anpassa formulering och ordning efter situationen, och du vill skapa den snabbt på vanligt språk. Information om hur den jämförs med strukturerade procedurer, workflows 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 på kontrollpanelen.

Namn

En kort etikett som identifierar proceduren på kontrollpanelen. 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 order återbetald.

Lämna utlösaren tom endast när du skapar en underprocedur.

Innehåll

Procedurens brödtext, skriven i markdown. Innehållet beskriver vad agenten ska göra: ställa en fråga, slå upp en order, 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 order-ID:t) 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 order, debitera ett kort, avsluta samtalet, överföra till en människa)
• Dokument i kunskapsbasen
• Andra procedurer

Använd infogade referenser när ett steg kräver att agenten använder ett verktyg, ett dokument i kunskapsbasen 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 endast 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 friformsinnehåll via API:t infogar du referenser med följande syntax:

[tool id="tool_abc123"]
[kb id="kb_abc123"]
[procedure id="agtprc_abc123"]
[system_tool id="end_call"]
{{customer_id}}

En infogad procedurreferens måste använda en procedur från samma agent. Se Begränsningar för agentomfång och dupliceringsbeteende.

En referens i utlösaren gör att proceduren kan starta baserat på en resurs utdata, till exempel När get_user returnerar nivå ‘gold’. En referens i innehållet talar om för agenten att anropa eller konsultera resursen vid det steget.

Dokument i kunskapsbasen som refereras i en procedur använder alltid användningsläget auto användningsläge: när RAG är aktiverat för agenten hämtar agenten relevanta avsnitt i stället för att placera hela dokumentet i prompten. Om dokumentet också är kopplat till agenten används agentens användningsläge för dokumentet i stället, så koppla det till agenten med användningsläget prompt för att behålla hela texten i prompten.

Om en refererad resurs senare tas bort, eller om ditt konto förlorar åtkomst 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 ingångsproceduren 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 uppsägning och lämna dess utlösare tom. Agenten kan eskalera som ett steg i någon av procedurerna, men utanför dem förblir underproceduren otillgänglig.

Importera från ett dokument

Du kan utgå från en befintlig standardrutin (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:ar bör du dela upp det i mindre filer innan du laddar upp det.

Hantera en friformsprocedur

Bästa praxis

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.

Iterera på en procedur

Vi rekommenderar att du börjar i liten skala och använder agenttester för att kontrollera varje ändring innan du gör nästa.

När ett test eller ett verkligt samtal misslyckas ska du leta efter typen av misstag bakom det. Om agenten sa något fel löser Säg inte det ett samtal. Sök igenom tidigare samtal efter liknande fel och skriv en instruktion som täcker dem alla. Orsaken kan också finnas i kunskapsbasen eller agentkonfigurationen. Architect kan göra denna sökning: öppna det misslyckade samtalet, välj Architect och be den hitta liknande fel och föreslå en lösning. Architect kan också omvandla samtalet till ett test.

Skriva utlösare

Skriva innehåll

Sammansätta procedurer