> 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.

### ElevenAgents

- **API für Umgebungsvariablen**: Neue Endpunkte für [Umgebungsvariablen](/docs/de/eleven-agents/integrate/environment-variables) zur Verwaltung von Konfigurationen auf Workspace-Ebene, auf die Agents zur Laufzeit über `{{system_env__<label>}}`-Templating zugreifen können. Unterstützt die Variablentypen String, Secret und Auth-Verbindung mit Wertüberschreibungen pro Umgebung. Zu den Endpunkten gehören [Erstellen](/docs/de/api-reference/environment-variables/create), [Auflisten](/docs/de/api-reference/environment-variables/list), [Abrufen](/docs/de/api-reference/environment-variables/get) und [Aktualisieren](/docs/de/api-reference/environment-variables/update).

- **Verwaltung von Auth-Verbindungen**: Neue API für Auth-Verbindungen auf Workspace-Ebene zur Verwaltung von Anmeldedaten, die von Agent-Tools und Integrationen verwendet werden. Unterstützt mehrere Authentifizierungsmethoden, darunter OAuth2-Client-Anmeldedaten, JWT, Basic Auth, Bearer-Token, benutzerdefinierte Header und von Integrationen verwaltete OAuth2-Autorisierungscode-Flows. Zu den Endpunkten gehören Erstellen, Auflisten und Löschen.

- **Aktualisierung von Knowledge-Base-URLs**: Neuer [Aktualisierungsendpunkt](/docs/de/api-reference/knowledge-base/refresh) (`POST /v1/convai/knowledge-base/{documentation_id}/refresh`) zum erneuten Abrufen und Aktualisieren von Inhalten für URL-basierte Knowledge-Base-Dokumente. Knowledge-Base-Dokumente unterstützen jetzt auch die Konfiguration der automatischen Synchronisierung mit den Feldern `enable_auto_sync`, `auto_remove` und `auto_sync_info`.

- **Guardrail-Wiederholung mit Feedback**: Benutzerdefinierte und Content-Guardrails unterstützen jetzt konfigurierbare [Trigger-Aktionen](/docs/de/eleven-agents/best-practices/guardrails) mit den Optionen `EndCallTriggerAction` und `RetryTriggerAction`. Bei einer Wiederholung generiert der Agent seine Antwort mit eingefügtem Systemfeedback bis zu dreimal neu. Verfügbare Platzhalter sind `{{trigger_reason}}` und `{{agent_message}}` für kontextbezogene Hinweise zur Wiederholung.

- **Systemvariable für den Gesprächsverlauf**: Eine neue dynamische Variable `system__conversation_history` hinzugefügt, die zur Laufzeit einen verzögert ausgewerteten, JSON-serialisierten Gesprächsverlauf bereitstellt. Dies ist nützlich, um Tools, Webhooks oder Übergaben an Sub-Agents den vollständigen Gesprächskontext zu übergeben.

- **Content-Type für Webhook-Tools**: Server-Tools unterstützen jetzt einen konfigurierbaren [Content-Type](/docs/de/eleven-agents/customization/tools/server-tools) für Webhook-Body-Parameter. So können Sie zwischen den Formaten `application/json` und `application/x-www-form-urlencoded` wählen. Das URL-kodierte Format eignet sich für die Integration mit Legacy-Systemen, OAuth-Token-Endpunkten und Zahlungsabwicklern.

- **Ausgehende WhatsApp-Nachrichten**: Die WhatsApp-Integration wurde um einen neuen [Dialog für ausgehende Nachrichten](/docs/de/eleven-agents/whatsapp) im Dashboard erweitert. Damit können Agents zusätzlich zu Anrufen Nachrichten über den WhatsApp-Kanal senden.

- **Filter für Agent- und Ressourcenlisten**: Die Endpunkte [Agents auflisten](/docs/de/api-reference/agents/list), [Knowledge-Base-Dokumente auflisten](/docs/de/api-reference/knowledge-base/list) und [Tools auflisten](/docs/de/api-reference/tools/list) unterstützen jetzt den Abfrageparameter `created_by_user_id` (verwenden Sie `@me` für den aktuellen Nutzer). Die bisherigen Parameter `show_only_owned_agents` und `show_only_owned_documents` sind veraltet.

- **Bedingte Workflow-Ausdrücke**: Dem Ausdrucksschema für Workflows wurde ein neuer AST-Knoten `conditional_operator` hinzugefügt, der Verzweigungslogik in Agent-Workflow-Definitionen ermöglicht.

### Musik

- **Music Marketplace**: Neue Dokumentation zum [Music Marketplace](/docs/de/overview/capabilities/music/marketplace), der Marktplatz für die Lizenzierung KI-generierter Musik, einschließlich Nutzungsarten, Auszahlungen für Creators und Lizenzdetails.

### SDK-Releases

#### Python SDK

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.40.0) - Unterstützung für den Parameter `environment` für ElevenAgents-Gespräche hinzugefügt, wodurch umgebungsspezifische Agent-Verbindungen möglich sind. Fern-Regenerierung zur Anpassung an das neueste API-Schema, einschließlich Umgebungsvariablen, Auth-Verbindungen, Knowledge-Base-Aktualisierung und Guardrail-Trigger-Aktionen.

#### JavaScript SDK

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.40.0) - WebSocket-Ereignistyp `multimodal_message` für ElevenAgents-Echtzeitgespräche hinzugefügt. Fern-Regenerierung zur Anpassung an das neueste API-Schema, einschließlich Umgebungsvariablen, Auth-Verbindungen, Knowledge-Base-Aktualisierung und Guardrail-Trigger-Aktionen.

#### iOS SDK

- [v3.1.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.1) - Unterstützung für den Parameter `environment` für umgebungsspezifische Agent-Verbindungen hinzugefügt. Ein visionOS-Build-Fehler wurde behoben, indem die Plattformanforderung auf v2 erhöht wurde.

#### Pakete

- [@elevenlabs/types@0.6.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.6.1) - WebSocket-Ereignistyp `multimodal_message` für ElevenAgents-Echtzeitgespräche hinzugefügt.
- [@elevenlabs/client@0.15.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.2) - Unterstützung für WebSocket-Ereignisse vom Typ `multimodal_message` hinzugefügt.
- [@elevenlabs/react@0.14.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.3) - Unterstützung für WebSocket-Ereignisse vom Typ `multimodal_message` hinzugefügt.
- [@elevenlabs/convai-widget-core@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.4), [@elevenlabs/convai-widget-core@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.5) - Auf `@elevenlabs/client@0.15.2` aktualisiert.
- [@elevenlabs/convai-widget-embed@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.4), [@elevenlabs/convai-widget-embed@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.5) - Auf `@elevenlabs/client@0.15.2` aktualisiert.

#### Release Candidate für Pakete v1.0.0

Der erste Release Candidate für v1.0.0 der ElevenAgents-Client-SDKs ist jetzt verfügbar. Dies ist ein Major Release mit Breaking Changes, die die API-Oberfläche verbessern, granulare React-Hooks für eine bessere Render-Performance hinzufügen und das React-Native-SDK mit dem React-SDK vereinheitlichen.

So testen Sie den Release Candidate:

```bash
npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next
```

Ein [`elevenlabs:sdk-migration`](https://github.com/elevenlabs/packages/blob/main/.agents/skills/elevenlabs%3Asdk-migration/SKILL.md)-Skill hilft KI-Coding-Assistenten dabei, Ihre Codebase automatisch auf die neuen APIs zu migrieren. Fügen Sie ihn zu Ihrem Claude-Code-, Cursor- oder Windsurf-Projekt hinzu, um Unterstützung bei der geführten Migration zu erhalten.

Wichtige Änderungen in v1.0.0:

- **`@elevenlabs/client`**: `Conversation` ist jetzt ein Namespace-Objekt und Typalias für `TextConversation | VoiceConversation` statt einer Klasse. Die Klassen `Input` und `Output` werden durch die Interfaces `InputController` und `OutputController` ersetzt, mit neuen Komfortmethoden auf der Gesprächsinstanz (`setMicMuted()`, `setVolume()`, `getInputByteFrequencyData()`, `getOutputByteFrequencyData()`). `changeInputDevice()` und `changeOutputDevice()` geben jetzt `void` zurück.
- **`@elevenlabs/react`**: `useConversation` erfordert jetzt einen übergeordneten `ConversationProvider`. Neue granulare Hooks für präzises erneutes Rendern: `useConversationControls()`, `useConversationStatus()`, `useConversationInput()`, `useConversationMode()`, `useConversationFeedback()`. Neuer Hook `useConversationClientTool()` zur dynamischen Registrierung von Client-Tools aus React-Komponenten mit vollständiger Typsicherheit.
- **`@elevenlabs/react-native`**: Vollständige Neufassung der API, die `ElevenLabsProvider` und `useConversation` durch `ConversationProvider` und dieselben granularen Hooks aus `@elevenlabs/react` ersetzt. WebRTC-Polyfills und die native AudioSession-Konfiguration werden beim Import automatisch angewendet.

Vollständige Release Notes und Migrationsanleitungen:

- [@elevenlabs/client@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.0.0-rc.1)
- [@elevenlabs/react@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.0-rc.1)
- [@elevenlabs/react-native@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.0-rc.1)
- [@elevenlabs/types@0.7.0-rc.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.7.0-rc.0)

### API

<Accordion title="API-Änderungen anzeigen">

## Neue Endpunkte

### ElevenAgents

- [Umgebungsvariable erstellen](/docs/de/api-reference/environment-variables/create) - `POST /v1/convai/environment-variables` - Eine neue Umgebungsvariable mit dem Typ String, Secret oder Auth-Verbindung erstellen
- [Umgebungsvariablen auflisten](/docs/de/api-reference/environment-variables/list) - `GET /v1/convai/environment-variables` - Alle Umgebungsvariablen im Workspace auflisten
- [Umgebungsvariable abrufen](/docs/de/api-reference/environment-variables/get) - `GET /v1/convai/environment-variables/{env_var_id}` - Eine bestimmte Umgebungsvariable abrufen
- [Umgebungsvariable aktualisieren](/docs/de/api-reference/environment-variables/update) - `PATCH /v1/convai/environment-variables/{env_var_id}` - Eine Umgebungsvariable aktualisieren, einschließlich des Entfernens von Werten pro Umgebung über `null`
- [Inhalt eines URL-Dokuments aktualisieren](/docs/de/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh` - Inhalte für URL-basierte Knowledge-Base-Dokumente erneut abrufen

### Workspaces

- `POST /v1/workspace/auth-connections` - Eine Workspace-Auth-Verbindung mit Unterstützung für OAuth2, JWT, Basic, Bearer, benutzerdefinierte Header und von Integrationen verwaltete Authentifizierungsmethoden erstellen
- `GET /v1/workspace/auth-connections` - Alle Workspace-Auth-Verbindungen mit Abhängigkeitsinformationen auflisten (Tools, MCP-Server, Integrationsverbindungen)
- `DELETE /v1/workspace/auth-connections/{auth_connection_id}` - Eine Workspace-Auth-Verbindung löschen

### Speech to Text

- `GET /v1/speech-to-text/evaluation/eval-criteria` - Bewertungskriterien auflisten
- `POST /v1/speech-to-text/evaluation/eval-criteria` - Ein Bewertungskriterium erstellen
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Ein bestimmtes Bewertungskriterium abrufen
- `PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Ein Bewertungskriterium aktualisieren
- `DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - Ein Bewertungskriterium löschen
- `POST /v1/speech-to-text/evaluation/evaluations` - Eine Bewertung auslösen
- `GET /v1/speech-to-text/evaluation/evaluations` - Bewertungen auflisten
- `GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id}` - Eine bestimmte Bewertung abrufen
- `GET /v1/speech-to-text/evaluation/human-agents` - Menschliche Agents auflisten
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}` - Einen menschlichen Agent abrufen
- `DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id}` - Einen menschlichen Agent löschen
- `GET /v1/speech-to-text/evaluation/analytics` - Bewertungsanalysen abrufen
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics` - Analysen für ein bestimmtes Kriterium abrufen
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics` - Analysen für einen bestimmten menschlichen Agent abrufen

## Aktualisierte Endpunkte

### ElevenAgents

- [Signierte URL abrufen](/docs/de/api-reference/conversations/get-signed-url), [Gesprächs-Token abrufen](/docs/de/api-reference/conversations/get-webrtc-token)

  - Abfrageparameter `environment` (String, optional) für umgebungsspezifische Auflösung hinzugefügt

- [Agents auflisten](/docs/de/api-reference/agents/list)

  - Abfrageparameter `created_by_user_id` (String, optional, unterstützt `@me`) hinzugefügt
  - `show_only_owned_agents` zugunsten von `created_by_user_id` als veraltet markiert

- [Knowledge-Base-Dokumente auflisten](/docs/de/api-reference/knowledge-base/list)

  - Abfrageparameter `created_by_user_id` (String, optional, unterstützt `@me`) hinzugefügt
  - `show_only_owned_documents` zugunsten von `created_by_user_id` als veraltet markiert

- [Tools auflisten](/docs/de/api-reference/tools/list)

  - Abfrageparameter `created_by_user_id` (String, optional, unterstützt `@me`) hinzugefügt
  - `show_only_owned_documents` zugunsten von `created_by_user_id` als veraltet markiert

- [Knowledge-Base-Chunk abrufen](/docs/de/api-reference/knowledge-base/get-chunk)

  - Abfrageparameter `embedding_model` (String, optional) hinzugefügt, um das Embedding-Modell für den Chunk-Abruf festzulegen

- [Agent erstellen](/docs/de/api-reference/agents/create), [Agent aktualisieren](/docs/de/api-reference/agents/update), [Entwurf erstellen](/docs/de/api-reference/agents/drafts/create)

  - Unterstützung für `guardrail_trigger_action` mit den Schemas `EndCallTriggerAction` und `RetryTriggerAction` hinzugefügt
  - AST-Knoten `conditional_operator` zu Workflow-Ausdrucksdefinitionen hinzugefügt
  - Agent-Schemas unterstützen jetzt `ConvAIEnvVarLocator` und `EnvironmentAuthConnectionLocator` für Verweise auf Umgebungsvariablen in Tool-Konfigurationen

- [Ausgehender SIP-Trunk-Anruf](/docs/de/api-reference/sip-trunk/outbound-call)

  - Request-Schema aktualisiert, um neue umgebungsbezogene Felder aufzunehmen

- [Gespräch simulieren](/docs/de/api-reference/agents/simulate-conversation), [Gesprächs-Stream simulieren](/docs/de/api-reference/agents/simulate-conversation-stream)

  - Feld `simulation_environment` zum Request-Schema hinzugefügt

## Schema-Änderungen

### Neue Schemas

- `ConvAIEnvironmentVariable`, `ConvAIEnvironmentVariableCreate`, `ConvAIEnvironmentVariableUpdate` - Umgebungsvariablenmodelle mit Unterstützung für die Typen String, Secret und Auth-Verbindung
- `ConvAIEnvVarLocator`, `EnvironmentAuthConnectionLocator` - Locator für Verweise auf Umgebungsvariablen in Tool- und MCP-Server-Konfigurationen
- `EndCallTriggerAction`, `RetryTriggerAction` - Guardrail-Trigger-Aktionsschemas für die Verhaltensweisen Anruf beenden und mit Feedback wiederholen
- `ConditionalOperator` - Neuer AST-Knoten für bedingte Ausdrücke in Agent-Workflows
- `AuthConnectionCreateRequest`, `AuthConnectionResponse`, `AuthConnectionDependencies` - Schemas zur Verwaltung von Workspace-Auth-Verbindungen mit Unterstützung für OAuth2, JWT, Basic, Bearer, benutzerdefinierte Header, WhatsApp und von Integrationen verwaltete Authentifizierungsmethoden
- `SpeechToTextEvaluation*` - Sammlung von Schemas für Speech-to-Text-Bewertungskriterien, Bewertungen, menschliche Agents und Analysen

### Geänderte Schemas

- `MCPServerConfig`, `MCPServerConfigOutput` - Unterstützung für `ConvAIEnvVarLocator`-Verweise in der Serverkonfiguration hinzugefügt
- `CustomGuardrailConfig` - Feld `trigger_action` zur Konfiguration des Verhaltens „Anruf beenden“ oder „wiederholen“ hinzugefügt
- `Contributor` - Optionale Felder `bio` (String) und `profile_id` (String) hinzugefügt
- `ASTLLMNode` - Feld `value_schema` hinzugefügt; das Feld `prompt` ist zugunsten von `value_schema` veraltet
- `TelephonyDirection` - Zu einem gemeinsamen Enum umgestaltet, auf das mehrere Gesprächs- und Telefonie-Modelle verweisen

</Accordion>