Procedurer

Uppgiftsspecifika instruktioner som din agent läser in när de är relevanta

Översikt

En procedur innehåller instruktioner för en specifik uppgift. Varje procedur har en utlösare som beskriver när den gäller och innehåll som beskriver vad som ska göras. När en konversation matchar utlösaren läser agenten in proceduren.

Använd procedurer när din agent behöver hantera många olika uppgifter. Ett exempel är en kundsupportagent, där varje procedur täcker en typ av ärende: återbetalningar, identitetsverifiering, kontoåterställning eller felsökning av anslutningar.

Fliken Procedurer i agentens
kontrollpanel

Typer av procedurer

Det finns två typer av procedurer:

Friformsprocedurer skrivs som instruktioner på naturligt språk som agenten tolkar och anpassar efter situationen.
Strukturerade procedurer är en ordnad lista med typade steg som agenten kör på samma sätt varje gång.

Du kan använda båda typerna i samma agent. Agenten väljer relevant procedur utifrån dess utlösare, oavsett typ.

Procedurer kan anropa varandra. En friformsprocedur anropar en annan procedur med en inline- referens, och en strukturerad procedur anropar en annan strukturerad procedur med ett delprocedur- steg. Ett vanligt mönster är att behålla öppen hantering i en friformsprocedur och lämna över de delar som måste köras på samma sätt varje gång till en strukturerad procedur.

En agent kan ha procedurer, ett workflow eller båda. När båda finns är varje procedur tillgänglig från varje punkt i workflowet; en procedur kan inte begränsas till specifika workflownoder. De flesta agenter byggs kring det ena eller andra sättet, men de kan kombineras.

När du ska använda procedurer

Varje agent har en systemprompt. Procedurer och workflows är två sätt att lägga till struktur ovanpå den, och en agent kan använda båda. Välj en utgångspunkt baserat på hur mycket konversationen kan variera.

Krav	Använd	Varför
Enkel proof of concept-agent	Endast systemprompt	Snabbast att konfigurera och iterera på, men en enda prompt blir svårhanterlig när agentens omfattning växer.
Uppgift där agenten kan anpassa formulering och ordning	Friformsprocedur	Håller hela konversationen i en LLM:s kontext, så att agenten kan anpassa formulering och ordning samt hantera oväntade vändningar. Använder mer av kontextfönstret.
Uppgift vars steg måste köras på samma sätt varje gång	Strukturerad procedur	Varje steg körs i den ordning du anger, på samma sätt varje gång, och du skriver den som en kort lista med steg.
Full kontroll över komplexa förgreningar och specialfall	Workflow	Körs som en graf av underagenter som du själv utformar och kopplar ihop, med full kontroll över förgreningar och modellen som används i varje steg.

Friformsprocedurer är standardvalet. De går snabbast att skriva, läses som ett dokument så att icke-tekniska team kan ansvara för dem, och agenten kan återhämta sig när en konversation avviker från manuset. Välj en strukturerad procedur när kostnaden för ett överhoppat eller omordnat steg är hög, till exempel vid autentisering, eskalering eller en finansiell transaktion. Välj ett workflow när du behöver routningslogik eller kontroll över modellen per steg som ingen av procedurtyperna erbjuder.

Hantera procedurer

Kontrollpanelen är det rekommenderade sättet att skapa procedurer. Använd CLI eller API för att hantera procedurer programmatiskt eller integrera dem i distributionsverktyg.

Skapa via kontrollpanelen

Hantera via CLI

Hantera via API

Öppna din agent i kontrollpanelen och välj sedan Procedurer. Använd + för att skapa en friformsprocedur eller strukturerad procedur. Procedurer kan grupperas i mappar från samma meny. Se Friformsprocedurer och Strukturerade procedurer för vägledning om hur du skapar dem.

Begränsningar

En procedurs innehåll är begränsat till 50 000 tecken.
Agenten behåller de fem senast startade procedurerna i kontexten. När fler har startats i en och samma konversation tas innehållet, inline-verktygen och kunskapsbasdokumenten för de äldsta friformsprocedurerna bort från prompten. Håll procedurer fokuserade och använd delprocedurer så att få är aktiva samtidigt.
Du kan inte ändra en procedurs typ efter att du har skapat den. Om du vill konvertera mellan friform och strukturerad skapar du en ny procedur och uppdaterar alla referenser till den.
Procedurer tillhör en agent. De kan inte delas mellan agenter eller lagras som resurser på arbetsytenivå.
När du duplicerar en agent kopieras dess procedurer i stället för att delas. Kopiorna får nya procedur-ID:n, så referenser i den duplicerade agenten måste använda dessa nya ID:n.
Procedurer kan inte begränsas till specifika workflownoder. När en agent har båda är varje procedur tillgänglig från varje nod.
Strukturerade procedurer kan inte referera till kunskapsbasdokument.