Hoppa till navigering

Ändringslogg

March 23, 2026

ElevenAgents

  • API för miljövariabler: Nya slutpunkter för miljövariabler för hantering av konfiguration på arbetsytenivå som agenter kan referera till vid körning via {{system_env__<label>}}-mallning. Stöder variabeltyperna string, secret och auth-connection med värdeåsidosättningar per miljö. Slutpunkterna omfattar skapa, lista, hämta och uppdatera.

  • Hantering av Auth Connections: Nytt API för auth connections på arbetsytenivå för hantering av autentiseringsuppgifter som används av agentverktyg och integrationer. Stöder flera autentiseringsmetoder, inklusive OAuth2-klientuppgifter, JWT, basic auth, bearer-token, anpassade headers och OAuth2-auktoriseringskodflöden som hanteras av integrationer. Slutpunkterna omfattar åtgärderna skapa, lista och ta bort.

  • Uppdatering av Knowledge Base-URL: Ny uppdateringsslutpunkt (POST /v1/convai/knowledge-base/{documentation_id}/refresh) för att hämta innehåll på nytt och uppdatera Knowledge Base-dokument med URL-källa. Knowledge Base-dokument stöder nu även konfiguration för automatisk synkronisering med fälten enable_auto_sync, auto_remove och auto_sync_info.

  • Försök igen för guardrails med feedback: Anpassade guardrails och innehållsguardrails stöder nu konfigurerbara utlösaråtgärder med alternativen EndCallTriggerAction och RetryTriggerAction. När återförsök är valt genererar agenten sitt svar på nytt med inmatad systemfeedback, i upp till 3 försök. Tillgängliga platshållare omfattar {{trigger_reason}} och {{agent_message}} för kontextbaserad vägledning vid återförsök.

  • Systemvariabel för konversationshistorik: Lade till en ny dynamisk variabel, system__conversation_history, som tillhandahåller en lat utvärderad, JSON-serialiserad konversationshistorik vid körning. Den är användbar för att skicka fullständigt konversationssammanhang till verktyg, webhooks eller överlämningar till underagenter.

  • Innehållstyp för webhook-verktyg: Serververktyg stöder nu en konfigurerbar innehållstyp för parametrar i webhook-brödtexten, så att du kan välja mellan formaten application/json och application/x-www-form-urlencoded. Det URL-kodade formatet är användbart för integration med äldre system, OAuth-token-slutpunkter och betalningshanterare.

  • Utgående WhatsApp-meddelanden: Uppdaterade WhatsApp-integrationen med en ny dialog för utgående meddelanden i dashboarden, så att agenter kan skicka utgående meddelanden utöver samtal via WhatsApp-kanalen.

  • Filter för listning av agenter och resurser: Slutpunkterna lista agenter, lista Knowledge Base-dokument och lista verktyg stöder nu frågeparametern created_by_user_id (använd @me för den aktuella användaren). De tidigare parametrarna show_only_owned_agents och show_only_owned_documents är föråldrade.

  • Villkorsuttryck i workflows: Lade till en ny AST-nod, conditional_operator, i schemat för workflow-uttryck, vilket möjliggör förgreningslogik i definitioner av agent-workflows.

Musik

  • Music Marketplace: Ny dokumentation för Music Marketplace som beskriver marknadsplatsen för licensiering av AI-genererad musik, inklusive användningstyper, ersättning till skapare och licensinformation.

SDK-versioner

Python SDK

  • v2.40.0 - Lade till stöd för parametern environment i ElevenAgents-konversationer, vilket möjliggör agentspecifika anslutningar per miljö. Fern-omgenerering för att matcha det senaste API-schemat, inklusive miljövariabler, auth connections, uppdatering av Knowledge Base och utlösaråtgärder för guardrails.

JavaScript SDK

  • v2.40.0 - Lade till WebSocket-händelsetypen multimodal_message för ElevenAgents-konversationer i realtid. Fern-omgenerering för att matcha det senaste API-schemat, inklusive miljövariabler, auth connections, uppdatering av Knowledge Base och utlösaråtgärder för guardrails.

iOS SDK

  • v3.1.1 - Lade till stöd för parametern environment för agentspecifika anslutningar per miljö. Åtgärdade ett build-fel i visionOS genom att höja plattformskravet till v2.

Paket

Release Candidate för paket v1.0.0

Den första release candidate-versionen för v1.0.0 av ElevenAgents klient-SDK:er är nu tillgänglig. Detta är en större version med brytande ändringar som förbättrar API-ytan, lägger till detaljerade React-hooks för bättre renderingsprestanda och förenar React Native SDK med React SDK.

Så här testar du release candidate-versionen:

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

En elevenlabs:sdk-migration-skill är tillgänglig för att hjälpa AI-kodningsassistenter att automatiskt migrera din kodbas till de nya API:erna. Lägg till den i ditt Claude Code-, Cursor- eller Windsurf-projekt för att få vägledd migreringshjälp.

Viktiga ändringar i v1.0.0:

  • @elevenlabs/client: Conversation är nu ett namnområdesobjekt och typalias för TextConversation | VoiceConversation i stället för en klass. Klasserna Input och Output ersätts av gränssnitten InputController och OutputController, med nya hjälpmetoder på konversationsinstansen (setMicMuted(), setVolume(), getInputByteFrequencyData(), getOutputByteFrequencyData()). changeInputDevice() och changeOutputDevice() returnerar nu void.
  • @elevenlabs/react: useConversation kräver nu en överordnad ConversationProvider. Nya detaljerade hooks för finkornig omrendering: useConversationControls(), useConversationStatus(), useConversationInput(), useConversationMode(), useConversationFeedback(). Ny hook, useConversationClientTool(), för att dynamiskt registrera klientverktyg från React-komponenter med full typsäkerhet.
  • @elevenlabs/react-native: Fullständig API-omskrivning som ersätter ElevenLabsProvider och useConversation med ConversationProvider och samma detaljerade hooks från @elevenlabs/react. WebRTC-polyfills och inbyggd AudioSession-konfiguration tillämpas automatiskt vid import.

Se fullständiga versionsanteckningar och migreringsguider:

API

Nya slutpunkter

ElevenAgents

  • Skapa miljövariabel - POST /v1/convai/environment-variables - Skapa en ny miljövariabel av typen string, secret eller auth-connection
  • Lista miljövariabler - GET /v1/convai/environment-variables - Lista alla miljövariabler i arbetsytan
  • Hämta miljövariabel - GET /v1/convai/environment-variables/{env_var_id} - Hämta en specifik miljövariabel
  • Uppdatera miljövariabel - PATCH /v1/convai/environment-variables/{env_var_id} - Uppdatera en miljövariabel, inklusive borttagning av värden per miljö via null
  • Uppdatera innehåll i URL-dokument - POST /v1/convai/knowledge-base/{documentation_id}/refresh - Hämta innehåll på nytt för Knowledge Base-dokument med URL-källa

Arbetsytor

  • POST /v1/workspace/auth-connections - Skapa en auth connection för arbetsytan med stöd för OAuth2, JWT, basic, bearer, anpassade headers och autentiseringsmetoder som hanteras av integrationer
  • GET /v1/workspace/auth-connections - Lista alla auth connections för arbetsytan med beroendeinformation (verktyg, MCP-servrar, integrationsanslutningar)
  • DELETE /v1/workspace/auth-connections/{auth_connection_id} - Ta bort en auth connection för arbetsytan

Speech to Text

  • GET /v1/speech-to-text/evaluation/eval-criteria - Lista utvärderingskriterier
  • POST /v1/speech-to-text/evaluation/eval-criteria - Skapa ett utvärderingskriterium
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Hämta ett specifikt utvärderingskriterium
  • PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Uppdatera ett utvärderingskriterium
  • DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Ta bort ett utvärderingskriterium
  • POST /v1/speech-to-text/evaluation/evaluations - Starta en utvärdering
  • GET /v1/speech-to-text/evaluation/evaluations - Lista utvärderingar
  • GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id} - Hämta en specifik utvärdering
  • GET /v1/speech-to-text/evaluation/human-agents - Lista mänskliga agenter
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id} - Hämta en mänsklig agent
  • DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id} - Ta bort en mänsklig agent
  • GET /v1/speech-to-text/evaluation/analytics - Hämta utvärderingsanalys
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics - Hämta analys för ett specifikt kriterium
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics - Hämta analys för en specifik mänsklig agent

Uppdaterade slutpunkter

ElevenAgents

  • Hämta signerad URL, Hämta konversationstoken

    • Lade till frågeparametern environment (string, valfri) för upplösning per miljö

  • Lista agenter

    • Lade till frågeparametern created_by_user_id (string, valfri, stöder @me)
    • Markerade show_only_owned_agents som föråldrad till förmån för created_by_user_id

  • Lista Knowledge Base-dokument

    • Lade till frågeparametern created_by_user_id (string, valfri, stöder @me)
    • Markerade show_only_owned_documents som föråldrad till förmån för created_by_user_id

  • Lista verktyg

    • Lade till frågeparametern created_by_user_id (string, valfri, stöder @me)
    • Markerade show_only_owned_documents som föråldrad till förmån för created_by_user_id

  • Hämta Knowledge Base-segment

    • Lade till frågeparametern embedding_model (string, valfri) för att ange embedding-modellen för hämtning av segment

  • Skapa agent, Uppdatera agent, Skapa utkast

    • Lade till stöd för guardrail_trigger_action med schemana EndCallTriggerAction och RetryTriggerAction
    • Lade till AST-noden conditional_operator i definitioner av workflow-uttryck
    • Agentscheman stöder nu ConvAIEnvVarLocator och EnvironmentAuthConnectionLocator för att referera till miljövariabler i verktygskonfigurationer

  • Utgående samtal via SIP-trunk

    • Requestschema uppdaterat för att hantera nya miljörelaterade fält

  • Simulera konversation, Simulera konversationsström

    • Lade till fältet simulation_environment i requestschemat

Schemaändringar

Nya scheman

  • ConvAIEnvironmentVariable, ConvAIEnvironmentVariableCreate, ConvAIEnvironmentVariableUpdate - Modeller för miljövariabler som stöder typerna string, secret och auth-connection
  • ConvAIEnvVarLocator, EnvironmentAuthConnectionLocator - Lokaliserare för att referera till miljövariabler i verktygs- och MCP-serverkonfigurationer
  • EndCallTriggerAction, RetryTriggerAction - Scheman för utlösaråtgärder för guardrails vid avsluta-samtal- och försök-igen-med-feedback-beteenden
  • ConditionalOperator - Ny AST-nod för villkorsuttryck i agent-workflows
  • AuthConnectionCreateRequest, AuthConnectionResponse, AuthConnectionDependencies - Scheman för hantering av auth connections för arbetsytor med stöd för OAuth2, JWT, basic, bearer, anpassade headers, WhatsApp och autentiseringsmetoder som hanteras av integrationer
  • SpeechToTextEvaluation* - Samling av scheman för utvärderingskriterier, utvärderingar, mänskliga agenter och analys för speech-to-text

Ändrade scheman

  • MCPServerConfig, MCPServerConfigOutput - Lade till stöd för ConvAIEnvVarLocator-referenser i serverkonfiguration
  • CustomGuardrailConfig - Lade till fältet trigger_action för att konfigurera beteende för avsluta samtal eller försök igen
  • Contributor - Lade till de valfria fälten bio (string) och profile_id (string)
  • ASTLLMNode - Lade till fältet value_schema; fältet prompt är föråldrat till förmån för value_schema
  • TelephonyDirection - Omstrukturerad till en delad enum som refereras av flera modeller för konversation och telefoni