Changelog

March 23, 2026

ElevenAgents

  • API zmiennych środowiskowych: Nowe endpointy zmiennych środowiskowych do zarządzania konfiguracją na poziomie workspace, do której agenci mogą odwoływać się w czasie działania za pomocą szablonów {{system_env__<label>}}. Obsługują zmienne typu string, secret i auth-connection z nadpisywaniem wartości dla poszczególnych środowisk. Dostępne endpointy: create, list, get i update.

  • Zarządzanie połączeniami auth: Nowe API połączeń auth na poziomie workspace do zarządzania danymi uwierzytelniającymi używanymi przez narzędzia i integracje agentów. Obsługuje wiele metod uwierzytelniania, w tym dane klienta OAuth2, JWT, basic auth, tokeny bearer, własne nagłówki oraz przepływy OAuth2 authorization code zarządzane przez integracje. Endpointy obejmują operacje tworzenia, listowania i usuwania.

  • Odświeżanie adresów URL w bazie wiedzy: Nowy endpoint refresh (POST /v1/convai/knowledge-base/{documentation_id}/refresh) do ponownego pobierania i aktualizacji treści dokumentów bazy wiedzy ze źródeł URL. Dokumenty bazy wiedzy obsługują teraz także konfigurację automatycznej synchronizacji z polami enable_auto_sync, auto_remove i auto_sync_info.

  • Ponowienie guardraila z informacją zwrotną: Własne guardraile i guardraile treści obsługują teraz konfigurowalne działania wyzwalające z opcjami EndCallTriggerAction i RetryTriggerAction. Przy ustawieniu ponowienia agent generuje odpowiedź ponownie, z dodaną systemową informacją zwrotną, maksymalnie 3 razy. Dostępne placeholdery to {{trigger_reason}} i {{agent_message}}, które pomagają przy ponowieniu w odpowiednim kontekście.

  • Zmienna systemowa historii rozmowy: Dodaliśmy nową dynamiczną zmienną system__conversation_history, która w czasie działania udostępnia leniwie obliczaną historię rozmowy serializowaną do JSON. Przydaje się do przekazywania pełnego kontekstu rozmowy do narzędzi, webhooków lub przy przekazywaniu jej subagentom.

  • Typ treści narzędzia webhook: Narzędzia serwerowe obsługują teraz konfigurowalny typ treści dla parametrów body webhooka, dzięki czemu możesz wybrać format application/json albo application/x-www-form-urlencoded. Format URL-encoded przydaje się przy integracji ze starszymi systemami, endpointami tokenów OAuth i operatorami płatności.

  • Wiadomości wychodzące WhatsApp: Zaktualizowaliśmy integrację WhatsApp o nowe okno wiadomości wychodzącej w dashboardzie, dzięki któremu agenci mogą wysyłać wiadomości wychodzące, a nie tylko wykonywać połączenia przez kanał WhatsApp.

  • Filtry list agentów i zasobów: Endpointy list agents, list knowledge base documents i list tools obsługują teraz parametr zapytania created_by_user_id (dla bieżącego użytkownika użyj @me). Poprzednie parametry show_only_owned_agents i show_only_owned_documents są przestarzałe.

  • Wyrażenia warunkowe workflow: Dodaliśmy nowy węzeł AST conditional_operator do schematu wyrażeń workflow, umożliwiający logikę rozgałęzień w definicjach workflow agentów.

Muzyka

  • Music Marketplace: Nowa dokumentacja Music Marketplace opisuje marketplace do licencjonowania muzyki generowanej przez AI, w tym typy wykorzystania, wypłaty dla twórców i szczegóły licencji.

Wydania SDK

Python SDK

  • v2.40.0 - Dodano obsługę parametru environment dla rozmów ElevenAgents, umożliwiając połączenia agentów zależne od środowiska. Regeneracja Fern zgodna z najnowszym schematem API, obejmującym zmienne środowiskowe, połączenia auth, odświeżanie bazy wiedzy i działania wyzwalające guardraili.

JavaScript SDK

  • v2.40.0 - Dodano typ zdarzenia WebSocket multimodal_message dla rozmów ElevenAgents w czasie rzeczywistym. Regeneracja Fern zgodna z najnowszym schematem API, obejmującym zmienne środowiskowe, połączenia auth, odświeżanie bazy wiedzy i działania wyzwalające guardraili.

iOS SDK

  • v3.1.1 - Dodano obsługę parametru environment dla połączeń agentów zależnych od środowiska. Naprawiono błąd kompilacji visionOS, podnosząc wymaganie platformy do v2.

Pakiety

Pakiety v1.0.0 Release Candidate

Dostępna jest już pierwsza wersja release candidate v1.0.0 klienckich SDK ElevenAgents. To duże wydanie z niekompatybilnymi zmianami, które ulepszają API, dodają szczegółowe hooki React dla lepszej wydajności renderowania oraz ujednolicają SDK React Native z SDK React.

Aby wypróbować release candidate:

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

Dostępny jest skill elevenlabs:sdk-migration, który pomaga asystentom AI do kodowania automatycznie migrować bazę kodu do nowych API. Dodaj go do projektu Claude Code, Cursor lub Windsurf, aby uzyskać pomoc przy migracji.

Najważniejsze zmiany w v1.0.0:

  • @elevenlabs/client: Conversation jest teraz obiektem przestrzeni nazw i aliasem typu dla TextConversation | VoiceConversation, a nie klasą. Klasy Input i Output zostały zastąpione interfejsami InputController i OutputController, z nowymi wygodnymi metodami na instancji rozmowy (setMicMuted(), setVolume(), getInputByteFrequencyData(), getOutputByteFrequencyData()). Metody changeInputDevice() i changeOutputDevice() zwracają teraz void.
  • @elevenlabs/react: useConversation wymaga teraz nadrzędnego ConversationProvider. Nowe szczegółowe hooki do precyzyjnego ponownego renderowania: useConversationControls(), useConversationStatus(), useConversationInput(), useConversationMode(), useConversationFeedback(). Nowy hook useConversationClientTool() umożliwia dynamiczne rejestrowanie narzędzi klienckich z komponentów React z pełnym bezpieczeństwem typów.
  • @elevenlabs/react-native: Pełne przepisanie API, które zastępuje ElevenLabsProvider i useConversation przez ConversationProvider oraz te same szczegółowe hooki z @elevenlabs/react. Polyfille WebRTC i natywna konfiguracja AudioSession są stosowane automatycznie przy imporcie.

Pełne informacje o wydaniu i przewodniki migracji:

API

Nowe endpointy

ElevenAgents

Workspace

  • POST /v1/workspace/auth-connections - Utwórz połączenie auth workspace z obsługą metod OAuth2, JWT, basic, bearer, własnych nagłówków i metod auth zarządzanych przez integracje
  • GET /v1/workspace/auth-connections - Wyświetl wszystkie połączenia auth workspace z informacjami o zależnościach (narzędzia, serwery MCP, połączenia integracji)
  • DELETE /v1/workspace/auth-connections/{auth_connection_id} - Usuń połączenie auth workspace

Speech to Text

  • GET /v1/speech-to-text/evaluation/eval-criteria - Wyświetl kryteria oceny
  • POST /v1/speech-to-text/evaluation/eval-criteria - Utwórz kryterium oceny
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Pobierz konkretne kryterium oceny
  • PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Zaktualizuj kryterium oceny
  • DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id} - Usuń kryterium oceny
  • POST /v1/speech-to-text/evaluation/evaluations - Uruchom ocenę
  • GET /v1/speech-to-text/evaluation/evaluations - Wyświetl oceny
  • GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id} - Pobierz konkretną ocenę
  • GET /v1/speech-to-text/evaluation/human-agents - Wyświetl agentów ludzkich
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id} - Pobierz agenta ludzkiego
  • DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id} - Usuń agenta ludzkiego
  • GET /v1/speech-to-text/evaluation/analytics - Pobierz analitykę ocen
  • GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics - Pobierz analitykę konkretnego kryterium
  • GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics - Pobierz analitykę konkretnego agenta ludzkiego

Zaktualizowane endpointy

ElevenAgents

  • Pobierz podpisany URL, Pobierz token rozmowy

    • Dodano parametr zapytania environment (string, opcjonalny) do rozwiązywania zależnego od środowiska

  • Wyświetl agentów

    • Dodano parametr zapytania created_by_user_id (string, opcjonalny, obsługuje @me)
    • Parametr show_only_owned_agents jest przestarzały na rzecz created_by_user_id

  • Wyświetl dokumenty bazy wiedzy

    • Dodano parametr zapytania created_by_user_id (string, opcjonalny, obsługuje @me)
    • Parametr show_only_owned_documents jest przestarzały na rzecz created_by_user_id

  • Wyświetl narzędzia

    • Dodano parametr zapytania created_by_user_id (string, opcjonalny, obsługuje @me)
    • Parametr show_only_owned_documents jest przestarzały na rzecz created_by_user_id

  • Pobierz fragment bazy wiedzy

    • Dodano parametr zapytania embedding_model (string, opcjonalny), aby określić model embeddingów do pobierania fragmentów

  • Utwórz agenta, Zaktualizuj agenta, Utwórz wersję roboczą

    • Dodano obsługę guardrail_trigger_action ze schematami EndCallTriggerAction i RetryTriggerAction
    • Dodano węzeł AST conditional_operator do definicji wyrażeń workflow
    • Schematy agentów obsługują teraz ConvAIEnvVarLocator i EnvironmentAuthConnectionLocator do odwoływania się do zmiennych środowiskowych w konfiguracjach narzędzi

  • Wychodzące połączenie SIP trunk

    • Zaktualizowano schemat żądania, aby uwzględnić nowe pola związane ze środowiskiem

  • Symuluj rozmowę, Strumień symulacji rozmowy

    • Dodano pole simulation_environment do schematu żądania

Zmiany schematów

Nowe schematy

  • ConvAIEnvironmentVariable, ConvAIEnvironmentVariableCreate, ConvAIEnvironmentVariableUpdate - Modele zmiennych środowiskowych obsługujące typy string, secret i auth-connection
  • ConvAIEnvVarLocator, EnvironmentAuthConnectionLocator - Lokatory do odwoływania się do zmiennych środowiskowych w konfiguracjach narzędzi i serwerów MCP
  • EndCallTriggerAction, RetryTriggerAction - Schematy działań wyzwalających guardraili dla zachowań zakończenia połączenia i ponowienia z informacją zwrotną
  • ConditionalOperator - Nowy węzeł AST dla wyrażeń warunkowych w workflow agentów
  • AuthConnectionCreateRequest, AuthConnectionResponse, AuthConnectionDependencies - Schematy zarządzania połączeniami auth workspace z obsługą OAuth2, JWT, basic, bearer, własnych nagłówków, WhatsApp i metod auth zarządzanych przez integracje
  • SpeechToTextEvaluation* - Zestaw schematów dla kryteriów oceny zamiany mowy na tekst, ocen, agentów ludzkich i analityki

Zmienione schematy

  • MCPServerConfig, MCPServerConfigOutput - Dodano obsługę odwołań ConvAIEnvVarLocator w konfiguracji serwera
  • CustomGuardrailConfig - Dodano pole trigger_action do konfiguracji zachowania zakończenia połączenia lub ponowienia
  • Contributor - Dodano opcjonalne pola bio (string) i profile_id (string)
  • ASTLLMNode - Dodano pole value_schema; pole prompt jest przestarzałe na rzecz value_schema
  • TelephonyDirection - Zrefaktoryzowano do wspólnego enumu, do którego odwołuje się wiele modeli rozmów i telefonii