Skip to navigation

ElevenAgents

  • API voor omgevingsvariabelen: Nieuwe endpoints voor omgevingsvariabelen voor het beheren van configuratie op workspaceniveau waar agents tijdens runtime via {{system_env__<label>}}-templating naar kunnen verwijzen. Ondersteunt variabeletypen string, secret en auth-connection, met overschrijvingen van waarden per omgeving. Endpoints omvatten maken, weergeven, ophalen en bijwerken.

  • Beheer van auth connections: Nieuwe API voor auth connections op workspaceniveau voor het beheren van authenticatiegegevens die worden gebruikt door agenttools en integraties. Ondersteunt meerdere authenticatiemethoden, waaronder OAuth2-clientcredentials, JWT, basic auth, bearer tokens, aangepaste headers en door integraties beheerde OAuth2-autorisatiecodestromen. Endpoints omvatten bewerkingen voor maken, weergeven en verwijderen.

  • Vernieuwen van URL’s in de kennisbank: Nieuw refresh-endpoint (POST /v1/convai/knowledge-base/{documentation_id}/refresh) om content opnieuw op te halen en bij te werken voor kennisbankdocumenten met een URL als bron. Kennisbankdocumenten ondersteunen nu ook configuratie voor automatisch synchroniseren met de velden enable_auto_sync, auto_remove en auto_sync_info.

  • Guardrail opnieuw proberen met feedback: Aangepaste contentguardrails ondersteunen nu configureerbare trigger actions met de opties EndCallTriggerAction en RetryTriggerAction. Bij instelling op opnieuw proberen genereert de agent de respons opnieuw met geïnjecteerde systeemfeedback, tot maximaal 3 pogingen. Beschikbare placeholders zijn onder meer {{trigger_reason}} en {{agent_message}} voor contextuele aanwijzingen voor opnieuw proberen.

  • Systeemvariabele voor gespreksgeschiedenis: Een nieuwe dynamische variabele system__conversation_history toegevoegd die tijdens runtime een lui geëvalueerde, als JSON geserialiseerde gespreksgeschiedenis biedt. Dit is handig om de volledige gesprekscontext door te geven aan tools, webhooks of overdrachten aan subagents.

  • Contenttype voor webhooktools: Servertools ondersteunen nu een configureerbaar contenttype voor bodyparameters van webhooks, zodat je kunt kiezen tussen de formaten application/json en application/x-www-form-urlencoded. Het URL-gecodeerde formaat is handig voor integratie met legacysystemen, OAuth-tokenendpoints en betalingsverwerkers.

  • Uitgaande WhatsApp-berichten: De WhatsApp-integratie is bijgewerkt met een nieuw dialoogvenster voor uitgaande berichten in het dashboard, waarmee agents naast gesprekken ook uitgaande berichten via het WhatsApp-kanaal kunnen versturen.

  • Filters voor lijsten met agents en resources: De endpoints agents weergeven, kennisbankdocumenten weergeven en tools weergeven ondersteunen nu een queryparameter created_by_user_id (gebruik @me voor de huidige gebruiker). De eerdere parameters show_only_owned_agents en show_only_owned_documents zijn verouderd.

  • Voorwaardelijke expressies voor workflows: Een nieuw conditional_operator-AST-knooppunt toegevoegd aan het expressieschema voor workflows, waarmee vertakkingslogica binnen workflowdefinities voor agents mogelijk wordt.

Muziek

  • Music Marketplace: Nieuwe documentatie over de Music Marketplace, de marketplace voor het licenseren van door AI gegenereerde muziek, met gebruikstypen, uitbetalingen aan creators en licentiedetails.

SDK-releases

Python SDK

  • v2.40.0 - Ondersteuning toegevoegd voor de parameter environment voor ElevenAgents-gesprekken, waarmee agentspecifieke verbindingen per omgeving mogelijk zijn. Fern opnieuw gegenereerd om overeen te komen met het nieuwste API-schema, inclusief omgevingsvariabelen, auth connections, het vernieuwen van de kennisbank en guardrail trigger actions.

JavaScript SDK

  • v2.40.0 - WebSocket-eventtype multimodal_message toegevoegd voor realtimegesprekken met ElevenAgents. Fern opnieuw gegenereerd om overeen te komen met het nieuwste API-schema, inclusief omgevingsvariabelen, auth connections, het vernieuwen van de kennisbank en guardrail trigger actions.

iOS SDK

  • v3.1.1 - Ondersteuning toegevoegd voor de parameter environment voor agentspecifieke verbindingen per omgeving. Een visionOS-buildfout opgelost door de platformvereiste te verhogen naar v2.

Packages

Release candidate voor Packages v1.0.0

De eerste release candidate voor v1.0.0 van de ElevenAgents-client-SDK’s is nu beschikbaar. Dit is een grote release met breaking changes die het API-oppervlak verbeteren, gedetailleerde React hooks toevoegen voor betere renderprestaties en de React Native SDK verenigen met de React SDK.

De release candidate uitproberen:

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

Er is een skill elevenlabs:sdk-migration beschikbaar om AI-coding assistants te helpen je codebase automatisch naar de nieuwe API’s te migreren. Voeg deze toe aan je Claude Code-, Cursor- of Windsurf-project voor begeleiding bij de migratie.

Belangrijke wijzigingen in v1.0.0:

  • @elevenlabs/client: Conversation is nu een namespaceobject en typealias voor TextConversation | VoiceConversation in plaats van een klasse. De klassen Input en Output zijn vervangen door de interfaces InputController en OutputController, met nieuwe handige methoden op de gespreksinstantie (setMicMuted(), setVolume(), getInputByteFrequencyData(), getOutputByteFrequencyData()). changeInputDevice() en changeOutputDevice() retourneren nu void.
  • @elevenlabs/react: useConversation vereist nu een bovenliggende ConversationProvider. Nieuwe gedetailleerde hooks voor nauwkeurig opnieuw renderen: useConversationControls(), useConversationStatus(), useConversationInput(), useConversationMode(), useConversationFeedback(). Nieuwe hook useConversationClientTool() voor het dynamisch registreren van clienttools vanuit React-componenten met volledige typeveiligheid.
  • @elevenlabs/react-native: Volledige herschrijving van de API waarbij ElevenLabsProvider en useConversation zijn vervangen door ConversationProvider en dezelfde gedetailleerde hooks uit @elevenlabs/react. WebRTC-polyfills en native AudioSession-configuratie worden automatisch toegepast bij importeren.

Bekijk de volledige releasenotes en migratiehandleidingen:

API

Nieuwe endpoints

ElevenAgents

  • Omgevingsvariabele maken - POST /v1/convai/environment-variables - Maak een nieuwe omgevingsvariabele met het type string, secret of auth-connection
  • Omgevingsvariabelen weergeven - GET /v1/convai/environment-variables - Geef alle omgevingsvariabelen in de workspace weer
  • Omgevingsvariabele ophalen - GET /v1/convai/environment-variables/{env_var_id} - Haal een specifieke omgevingsvariabele op
  • Omgevingsvariabele bijwerken - PATCH /v1/convai/environment-variables/{env_var_id} - Werk een omgevingsvariabele bij, inclusief het verwijderen van waarden per omgeving via null
  • Content van URL-document vernieuwen - POST /v1/convai/knowledge-base/{documentation_id}/refresh - Haal content opnieuw op voor kennisbankdocumenten met een URL als bron

Workspaces

  • POST /v1/workspace/auth-connections - Maak een workspace-auth connection met ondersteuning voor OAuth2-, JWT-, basic-, bearer-, aangepaste header- en door integraties beheerde authenticatiemethoden
  • GET /v1/workspace/auth-connections - Geef alle workspace-auth connections weer met informatie over afhankelijkheden (tools, MCP-servers, integratieverbindingen)
  • DELETE /v1/workspace/auth-connections/{auth_connection_id} - Verwijder een workspace-auth connection

Speech to Text

  • GET /v1/speech-to-text/evaluation/eval-criteria - Geef evaluatiecriteria weer
  • POST /v1/speech-to-text/evaluation/eval-criteria - Maak een evaluatiecriterium
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Haal een specifiek evaluatiecriterium op
  • PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Werk een evaluatiecriterium bij
  • DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Verwijder een evaluatiecriterium
  • POST /v1/speech-to-text/evaluation/evaluations - Start een evaluatie
  • GET /v1/speech-to-text/evaluation/evaluations - Geef evaluaties weer
  • GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id} - Haal een specifieke evaluatie op
  • GET /v1/speech-to-text/evaluation/human-agents - Geef menselijke agents weer
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id} - Haal een menselijke agent op
  • DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id} - Verwijder een menselijke agent
  • GET /v1/speech-to-text/evaluation/analytics - Haal evaluatieanalyses op
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics - Haal analyses voor een specifiek criterium op
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics - Haal analyses voor een specifieke menselijke agent op

Bijgewerkte endpoints

ElevenAgents

  • Ondertekende URL ophalen, Gesprekstoken ophalen

    • Queryparameter environment toegevoegd (string, optioneel) voor omgevingsspecifieke resolutie
  • Agents weergeven

    • Queryparameter created_by_user_id toegevoegd (string, optioneel, ondersteunt @me)
    • show_only_owned_agents is verouderd ten gunste van created_by_user_id
  • Kennisbankdocumenten weergeven

    • Queryparameter created_by_user_id toegevoegd (string, optioneel, ondersteunt @me)
    • show_only_owned_documents is verouderd ten gunste van created_by_user_id
  • Tools weergeven

    • Queryparameter created_by_user_id toegevoegd (string, optioneel, ondersteunt @me)
    • show_only_owned_documents is verouderd ten gunste van created_by_user_id
  • Kennisbankchunk ophalen

    • Queryparameter embedding_model toegevoegd (string, optioneel) om het embeddingmodel voor het ophalen van chunks op te geven
  • Agent maken, Agent bijwerken, Concept maken

    • Ondersteuning voor guardrail_trigger_action toegevoegd met de schema’s EndCallTriggerAction en RetryTriggerAction
    • AST-knooppunt conditional_operator toegevoegd aan definities van workflowexpressies
    • Agentschema’s ondersteunen nu ConvAIEnvVarLocator en EnvironmentAuthConnectionLocator voor het verwijzen naar omgevingsvariabelen in toolconfiguraties
  • Uitgaand gesprek via SIP-trunk

    • Requestschema bijgewerkt voor nieuwe omgevingsgerelateerde velden
  • Gesprek simuleren, Gespreksstream simuleren

    • Veld simulation_environment toegevoegd aan het requestschema

Schemawijzigingen

Nieuwe schema’s

  • ConvAIEnvironmentVariable, ConvAIEnvironmentVariableCreate, ConvAIEnvironmentVariableUpdate - Modellen voor omgevingsvariabelen met ondersteuning voor de typen string, secret en auth-connection
  • ConvAIEnvVarLocator, EnvironmentAuthConnectionLocator - Locators voor het verwijzen naar omgevingsvariabelen in configuraties voor tools en MCP-servers
  • EndCallTriggerAction, RetryTriggerAction - Schema’s voor guardrail trigger actions voor gedrag bij gesprekken beëindigen en opnieuw proberen met feedback
  • ConditionalOperator - Nieuw AST-knooppunt voor voorwaardelijke expressies in agentworkflows
  • AuthConnectionCreateRequest, AuthConnectionResponse, AuthConnectionDependencies - Beheerschema’s voor workspace-auth connections met ondersteuning voor OAuth2-, JWT-, basic-, bearer-, aangepaste header-, WhatsApp- en door integraties beheerde authenticatiemethoden
  • SpeechToTextEvaluation* - Reeks schema’s voor Speech to Text-evaluatiecriteria, evaluaties, menselijke agents en analyses

Gewijzigde schema’s

  • MCPServerConfig, MCPServerConfigOutput - Ondersteuning toegevoegd voor ConvAIEnvVarLocator-referenties in serverconfiguratie
  • CustomGuardrailConfig - Veld trigger_action toegevoegd voor het configureren van gedrag bij gesprekken beëindigen of opnieuw proberen
  • Contributor - Optionele velden bio (string) en profile_id (string) toegevoegd
  • ASTLLMNode - Veld value_schema toegevoegd; veld prompt is verouderd ten gunste van value_schema
  • TelephonyDirection - Herwerkt tot een gedeelde enum waarnaar wordt verwezen door meerdere modellen voor gesprekken en telefonie