> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Verfahren ## Übersicht Ein Verfahren enthält Anweisungen für eine bestimmte Aufgabe. Jedes Verfahren hat einen Auslöser, der beschreibt, wann es gilt, und Inhalte, die beschreiben, was zu tun ist. Wenn eine Unterhaltung dem Auslöser entspricht, lädt der Agent das Verfahren. Verwenden Sie Verfahren, wenn Ihr Agent viele unterschiedliche Aufgaben bearbeiten muss. Ein Beispiel ist ein Kundensupport-Agent, bei dem jedes Verfahren eine Art von Anfrage abdeckt: Rückerstattungen, Identitätsprüfung, Kontowiederherstellung oder Fehlerbehebung bei Verbindungen. ![Tab „Verfahren“ im Agent- Dashboard](/docs/_fern-img/38b190b7a08cb9e628da309a86c5e4b315eabccf238a41d5d3a6c2646aba11af.webp) ## Verfahrenstypen Es gibt zwei Arten von Verfahren: * **[Freiform-Verfahren](/docs/de/eleven-agents/customization/procedures/free-form-procedures)** werden als Anweisungen in natürlicher Sprache verfasst, die der Agent interpretiert und an die Situation anpasst. * **[Strukturierte Verfahren](/docs/de/eleven-agents/customization/procedures/structured-procedures)** sind eine geordnete Liste typisierter Schritte, die der Agent jedes Mal auf die gleiche Weise ausführt. Sie können beide Arten für denselben Agenten verwenden. Der Agent wählt anhand des Auslösers das relevante Verfahren, unabhängig vom Typ. > **Tip** > > Verfahren können einander aufrufen. Ein Freiform-Verfahren ruft ein anderes Verfahren über eine [Inline- Referenz](/docs/de/eleven-agents/customization/procedures/free-form-procedures#inline-references) auf, > und ein strukturiertes Verfahren ruft ein anderes strukturiertes Verfahren mit einem Schritt vom Typ > [Unterverfahren](/docs/de/eleven-agents/customization/procedures/structured-procedures#sub-procedure) > auf. Ein gängiges Muster ist, die offene Bearbeitung in einem Freiform-Verfahren zu halten und die > Teile, die jedes Mal gleich ablaufen müssen, an ein strukturiertes Verfahren zu übergeben. Ein Agent kann Verfahren, einen [Workflow](/docs/de/eleven-agents/customization/agent-workflows) oder beides haben. Wenn beides vorhanden ist, ist jedes Verfahren von jedem Punkt im Workflow aus verfügbar; ein Verfahren 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 Verfahren verwendet werden sollten Jeder Agent hat einen [System-Prompt](/docs/de/eleven-agents/best-practices/prompting-guide). Verfahren und [Workflows](/docs/de/eleven-agents/customization/agent-workflows) sind zwei Möglichkeiten, darauf Struktur aufzubauen, und ein Agent kann beide verwenden. Wählen Sie einen Ausgangspunkt danach, wie stark die Unterhaltung variieren kann. | Anforderung | Verwenden | Warum | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Einfacher Proof-of-Concept-Agent | Nur System-Prompt | Am schnellsten eingerichtet und iteriert, aber ein einzelner Prompt wird unübersichtlich, wenn der Aufgabenbereich des Agenten wächst. | | Aufgabe, bei der der Agent Formulierung und Reihenfolge anpassen kann | [Freiform-Verfahren](/docs/de/eleven-agents/customization/procedures/free-form-procedures) | Hält die gesamte Unterhaltung im Kontext eines LLMs, sodass der Agent Formulierung und Reihenfolge anpasst und unerwarteten Wendungen folgen kann. Nutzt mehr Kontextfenster. | | Aufgabe, deren Schritte jedes Mal gleich ablaufen müssen | [Strukturiertes Verfahren](/docs/de/eleven-agents/customization/procedures/structured-procedures) | Jeder Schritt wird in der von Ihnen festgelegten Reihenfolge und jedes Mal gleich ausgeführt. Sie erstellen es als kurze Liste von Schritten. | | Volle Kontrolle über komplexe Verzweigungen und Sonderfälle | [Workflow](/docs/de/eleven-agents/customization/agent-workflows) | Läuft als Graph von Sub-Agenten, die Sie selbst entwerfen und verbinden, mit voller Kontrolle über Verzweigungen und das Modell jedes Schritts. | Freiform-Verfahren sind die Standardwahl. Sie sind am schnellsten erstellt, lesen sich wie ein Dokument, sodass nicht-technische Teams sie verwalten können, und der Agent kann sich erholen, wenn eine Unterhaltung vom Skript abweicht. Verwenden Sie ein strukturiertes Verfahren, 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 Kontrolle über das Modell pro Schritt benötigen, die kein Verfahrenstyp bietet. ## Verfahren verwalten Das Dashboard ist die empfohlene Methode zum Erstellen von Verfahren. Verwenden Sie die CLI oder API, um Verfahren programmatisch zu verwalten oder in Bereitstellungstools zu integrieren. #### Über das Dashboard erstellen Öffnen Sie Ihren Agenten im [Dashboard](https://elevenlabs.io/app/agents) und wählen Sie dann **Verfahren**. Verwenden Sie **+**, um ein Freiform- oder strukturiertes Verfahren zu erstellen. Verfahren können über dasselbe Menü in Ordnern gruppiert werden. Hinweise zur Erstellung finden Sie unter [Freiform-Verfahren](/docs/de/eleven-agents/customization/procedures/free-form-procedures) und [Strukturierte Verfahren](/docs/de/eleven-agents/customization/procedures/structured-procedures). #### Über die CLI verwalten Die [ElevenLabs CLI](/docs/de/eleven-agents/operate/cli) verwaltet Verfahren mit der Befehlsgruppe `elevenlabs agents procedures`. Legen Sie zuerst `ELEVENLABS_API_KEY` in Ihrer Umgebung fest. ```bash # List the procedures on a branch elevenlabs agents procedures list \ --agent-id agent_7101k5zvyjhmfg983brhmhkd98n6 \ --branch-id agtbranch_0901k4aafjxxfxt93gd841r7tv5t # Create a procedure elevenlabs agents procedures create \ --agent-id agent_7101k5zvyjhmfg983brhmhkd98n6 \ --branch-id agtbranch_0901k4aafjxxfxt93gd841r7tv5t \ --json '{"name": "Refund request", "type": "free_form", "trigger": "When the user asks to refund an order", "content": "Ask for the order ID."}' # Publish every changed procedure draft on the branch elevenlabs agents update \ --agent-id agent_7101k5zvyjhmfg983brhmhkd98n6 \ --branch-id agtbranch_0901k4aafjxxfxt93gd841r7tv5t \ --json '{"version_description": "Publish refund procedure"}' ``` Verwenden Sie `elevenlabs agents procedures drafts`, um einen Entwurf zu lesen, zu aktualisieren oder zu verwerfen, und `elevenlabs agents procedures remove`, um eine Entfernung vorzumerken. Fügen Sie einem beliebigen Befehl `--schema` hinzu, um seinen Ein- und Ausgabe-Vertrag anzuzeigen. #### Über die API verwalten Verfahrensentwürfe folgen dem [Lebenszyklus der Agent- Versionierung](/docs/de/eleven-agents/operate/versioning#drafts). Sie gelten pro Nutzer und Branch, sodass jedes Teammitglied separate Entwürfe in jedem Branch hat. Durch Veröffentlichung werden Ihre Verfahrensänderungen in einer neuen unveränderlichen Agent-Version in diesem Branch gespeichert. Die Entwürfe anderer Nutzer bleiben unverändert. Antworten zur Agent-Konfiguration enthalten Verfahrensmetadaten wie IDs, Namen, Typen und Auslöser, aber keine Verfahrensinhalte oder Entwürfe. Verwenden Sie die Verfahrensendpunkte, um die vollständigen Inhalte zu lesen und zu bearbeiten. Alle Verfahrensendpunkte sind unter `/v1/convai/agents/{agent_id}/branches/{branch_id}` verschachtelt. ### Einen Entwurf erstellen oder aktualisieren Erstellen Sie ein Verfahren mit `POST /procedures`. Aktualisieren Sie es mit `PATCH /procedures/{procedure_id}/draft` und geben Sie bei jeder Anfrage `name`, `content`, `type` und `trigger` an. Der `type` muss dem bestehenden Typ des Verfahrens entsprechen. Verwenden Sie `GET /procedures/{procedure_id}/draft`, um unveröffentlichte Änderungen zu lesen. Wenn Sie keinen Entwurf haben, gibt der Endpunkt die veröffentlichte Version zurück. ### Änderungen veröffentlichen Veröffentlichen Sie die Entwürfe, indem Sie mit [Agent aktualisieren](/docs/de/api-reference/agents/update) eine neue Agent-Version erstellen. Eine Anfrage veröffentlicht jeden geänderten Verfahrensentwurf im Branch, für beide Verfahrenstypen. Wenn der Branch strukturierte Verfahren enthält, werden diese bei der Veröffentlichung validiert und kompiliert (ihre Schritte werden in die Form umgewandelt, die der Agent ausführt), und mögliche Fehler werden zurückgegeben. Wenn die Validierung erfolgreich ist, wird die Agent-Konfiguration veröffentlicht. Sie müssen nichts selbst kompilieren. Folgen Sie den typspezifischen Anweisungen für [Freiform-Verfahren](/docs/de/eleven-agents/customization/procedures/free-form-procedures#manage-a-free-form-procedure) oder [strukturierte Verfahren](/docs/de/eleven-agents/customization/procedures/structured-procedures#manage-a-structured-procedure). ### Ein Verfahren verwerfen oder entfernen `DELETE /procedures/{procedure_id}/draft` verwirft unveröffentlichte Bearbeitungen und stellt die veröffentlichte Version wieder her. Wurde das Verfahren noch nie veröffentlicht, wird es dadurch gelöscht. `DELETE /procedures/{procedure_id}` merkt die Entfernung eines veröffentlichten Verfahrens vor. Veröffentlichen Sie die Änderung über denselben Ablauf. Vollständige Endpunktschemas finden Sie in der [API-Referenz für Verfahren](/docs/de/api-reference/agents/procedures/). ## Einschränkungen * Der Inhalt eines Verfahrens ist auf 50.000 Zeichen begrenzt. * Der Agent hält die fünf zuletzt gestarteten Verfahren im Kontext. Wenn in einer Unterhaltung mehr Verfahren gestartet wurden, fallen die Inhalte, Inline-Tools und Wissensdatenbankdokumente der ältesten Freiform-Verfahren aus dem Prompt. Halten Sie Verfahren fokussiert und verwenden Sie Unterverfahren, damit nur wenige gleichzeitig aktiv sind. * Sie können den Typ eines Verfahrens nach der Erstellung nicht ändern. Um zwischen Freiform und strukturiert zu wechseln, erstellen Sie ein neues Verfahren und aktualisieren alle Verweise darauf. * Verfahren gehören zu einem Agenten. Sie können nicht agentübergreifend geteilt oder als Ressourcen auf Workspace-Ebene gespeichert werden. * Beim Duplizieren eines Agenten werden seine Verfahren kopiert, statt geteilt. Die Kopien erhalten neue Verfahrens-IDs, daher müssen Verweise im duplizierten Agenten diese neuen IDs verwenden. * Verfahren können nicht auf bestimmte Workflow-Knoten beschränkt werden. Wenn ein Agent beides hat, ist jedes Verfahren von jedem Knoten aus verfügbar. * Strukturierte Verfahren können nicht auf Wissensdatenbankdokumente verweisen.