Prozeduren

Übersicht

Eine Prozedur enthält Anweisungen für eine bestimmte Aufgabe. Jede Prozedur hat einen Trigger, der beschreibt, wann sie gilt, und Inhalte, die beschreiben, was zu tun ist. Wenn eine Konversation dem Trigger entspricht, lädt der Agent die Prozedur.

Verwenden Sie Prozeduren, wenn Ihr Agent viele unterschiedliche Aufgaben bearbeiten muss. Ein Beispiel ist ein Kundensupport-Agent, bei dem jede Prozedur eine Art von Anfrage abdeckt: Rückerstattungen, Identitätsprüfung, Kontowiederherstellung oder Hilfe bei Verbindungsproblemen.

Arten von Prozeduren

Es gibt zwei Arten von Prozeduren:

• Freiform-Prozeduren werden als Anweisungen in natürlicher Sprache geschrieben, die der Agent interpretiert und an die Situation anpasst.
• Strukturierte Prozeduren sind eine geordnete Liste typisierter Schritte, die der Agent jedes Mal auf dieselbe Weise ausführt.

Sie können beide Arten für denselben Agenten verwenden. Der Agent wählt anhand des Triggers die passende Prozedur aus, unabhängig vom Typ.

Ein Agent kann Prozeduren, einen Workflow oder beides haben. Wenn beides vorhanden ist, ist jede Prozedur von jedem Punkt im Workflow aus verfügbar; eine Prozedur kann nicht auf bestimmte Workflow-Knoten beschränkt werden. Die meisten Agenten basieren auf einem der beiden Ansätze, aber sie lassen sich kombinieren.

Wann Prozeduren sinnvoll sind

Jeder Agent hat einen System-Prompt. Prozeduren und Workflows sind zwei Möglichkeiten, zusätzliche Struktur hinzuzufügen, und ein Agent kann beides verwenden. Wählen Sie einen Ausgangspunkt danach, wie stark die Konversation variieren kann.

Freiform-Prozeduren sind die Standardwahl. Sie lassen sich am schnellsten schreiben, lesen sich wie ein Dokument, sodass auch nichttechnische Teams sie verwalten können, und der Agent kann sich erholen, wenn eine Konversation vom Skript abweicht. Verwenden Sie eine strukturierte Prozedur, wenn ein übersprungener oder umsortierter Schritt hohe Kosten verursacht, etwa bei Authentifizierung, Eskalation oder einer Finanztransaktion. Verwenden Sie einen Workflow, wenn Sie Routing-Logik oder Modellsteuerung pro Schritt benötigen, die keine der beiden Prozedurarten bietet.

Prozeduren verwalten

Das Dashboard ist die empfohlene Methode zum Erstellen von Prozeduren. Verwenden Sie die CLI oder API, um Prozeduren programmatisch zu verwalten oder in Deployment-Tools zu integrieren.

Prozeduren pro Konversation auswählen

Standardmäßig kann jede Konversation alle Prozeduren des Agenten verwenden, und der Agent lädt eine Prozedur erst, wenn die Konversation ihrem Trigger entspricht. Ihre Anwendung weiß oft schon vor Beginn der Konversation mehr: wer der Benutzer ist, in welcher Region er sich befindet oder worüber er anruft. Übergeben Sie Prozedur-IDs in den Clientdaten zur Konversationsinitiierung, um dieses Wissen zu nutzen. Sie bestimmen, welche Prozeduren der Agent verwenden kann und welchen er ab dem ersten Turn folgt.

Eine Prozedur in start_procedure_ids ist bereits geladen, wenn der Benutzer erstmals spricht, sodass der Agent den LLM-Aufruf zum Laden überspringt. Jede aktive Prozedur bleibt bei jedem Turn im Prompt, unabhängig davon, ob der Agent oder Ihre Anwendung sie gestartet hat. Eine gestartete Prozedur, die für die Konversation nie benötigt wird, fügt ihren Inhalt dennoch bei jedem Turn hinzu. Starten Sie daher nur Prozeduren, die die Konversation voraussichtlich verwendet.

{
  "type": "conversation_initiation_client_data",
  "procedure_ids": [
    "agtprc_4101k8f3w2pqv6xs9mhdr0tz7n3b",
    "agtprc_2301k8f3xq9zfa7tkrqs6m4bdn5e",
    "agtprc_7801k8f3yt4mfzh2xbq9d0vcpw1r"
  ],
  "start_procedure_ids": ["agtprc_4101k8f3w2pqv6xs9mhdr0tz7n3b"]
}

Für beide Felder gelten diese Regeln:

• Jede ID in procedure_ids muss zum Agenten gehören. Wenn eine ausgewählte Prozedur Unterprozeduren aufruft, schließen Sie auch diese ein.
• Jede ID in start_procedure_ids muss eine Freiform-Prozedur sein. Wenn Sie auch procedure_ids übergeben, muss jede ID auch in dieser Liste stehen.
• procedure_ids gilt nur für den Agenten, mit dem die Konversation startet. Nach einer Agentenübergabe gilt es nicht mehr.
• Gestartete Prozeduren zählen zu den fünf aktiven Prozeduren unter Einschränkungen. Der Konversationsverlauf zeichnet jede davon als start_procedure-Tool-Aufruf auf.

Einschränkungen

• Der Inhalt einer Prozedur ist auf 50.000 Zeichen begrenzt.
• Der Agent behält die fünf zuletzt gestarteten Prozeduren im Kontext. Wenn in einer Konversation weitere gestartet wurden, fallen Inhalt, Inline-Tools und Wissensdatenbankdokumente der ältesten Freiform-Prozeduren aus dem Prompt. Halten Sie Prozeduren fokussiert und verwenden Sie Unterprozeduren, damit nur wenige gleichzeitig aktiv sind.
• Sie können den Typ einer Prozedur nach ihrer Erstellung nicht ändern. Um zwischen Freiform und strukturiert zu wechseln, erstellen Sie eine neue Prozedur und aktualisieren alle Verweise darauf.
• Prozeduren gehören zu einem Agenten. Sie können nicht zwischen Agenten geteilt oder als Ressourcen auf Workspace-Ebene gespeichert werden.
• Beim Duplizieren eines Agenten werden seine Prozeduren kopiert, nicht geteilt. Die Kopien erhalten neue Prozedur-IDs, daher müssen Verweise im duplizierten Agenten diese neuen IDs verwenden.
• Prozeduren können nicht auf bestimmte Workflow-Knoten beschränkt werden. Wenn ein Agent beides hat, ist jede Prozedur von jedem Knoten aus verfügbar.
• Strukturierte Prozeduren können nicht auf Wissensdatenbankdokumente verweisen.