Changelog

July 27, 2026

ElevenAgents

  • Nadpisywanie gałęzi i środowiska w WhatsAppie: Wychodzące wiadomości WhatsApp i połączenia wychodzące uwzględniają teraz branch_id i environment przekazane w conversation_initiation_client_data. Nadpisania są sprawdzane przed wysłaniem czegokolwiek — nieznana gałąź lub środowisko powodują błąd — i obowiązują przez całą rozmowę, więc odpowiedź klienta jest wznawiana w żądanej gałęzi i środowisku. Przykłady znajdziesz w przewodniku po WhatsAppie.
  • API procedur: Dodaliśmy osiem publicznych operacji dla konkretnych gałęzi do zarządzania procedurami. Możesz tworzyć, wyświetlać, pobierać i usuwać procedury; tworzyć, pobierać lub odrzucać zmiany wersji roboczych; a także kompilować wersje robocze procedur do workflow agenta. Tworzenie procedury przyjmuje name, content, type i trigger. Pusty trigger tworzy podprocedurę, a pominięty lub null trigger jest wyprowadzany z treści procedury.
  • Zadania crawlowania bazy wiedzy: Dodaliśmy API do tworzenia, wyświetlania, sprawdzania i anulowania zadań crawlowania. Żądania utworzenia wymagają url (ciąg znaków) i obsługują głębokość crawlowania, limity stron, wzorce URL, adresy URL map witryn, umieszczenie w folderze, automatyczną synchronizację oraz usuwanie niedostępnych dokumentów.
  • Zbiorcze zarządzanie bazą wiedzy: Dodaliśmy zbiorcze sprawdzanie zależności i zbiorcze usuwanie dla 1–20 unikalnych identyfikatorów dokumentów lub folderów. Sprawdzanie zależności obsługuje paginację i dependent_type; usuwanie zwraca niezależny wynik powodzenia lub niepowodzenia dla każdego ID. Ustawienie force: true usuwa też zależności i rekursywnie usuwa niepuste foldery.
  • Eksport wyników połączeń wsadowych: Dodaliśmy Eksport wyników połączeń wsadowych, aby pobierać odbiorców i wyniki rozmów z zakończonej partii jako CSV.
  • Filtry rozmów i dane analityczne: Lista rozmów i Wyszukiwanie tekstowe w wiadomościach rozmów dodają opcjonalne filtry tablicowe visited_agent_ids i visited_agent_branch_ids, każdy ograniczony do 50 wartości. Żądania listy akceptują też data_collection_ids i evaluation_criteria_ids, aby uwzględniać odpowiednie wyniki w podsumowaniu każdej rozmowy. Podsumowania dodają opcjonalne data_collection_results, evaluation_criteria_results i tag_ids.
  • Konfiguracja analizy przez referencje: Ustawienia platformy agenta dodają opcjonalne pole dopuszczające null analysis_items, typu AgentAnalysisItems, aby dołączać elementy oceny i zbierania danych przez referencję. Wartość null oznacza, że agent nadal używa starszych pól wbudowanych; pusta wartość oznacza zmigrowanego agenta bez dołączonych elementów.
  • Metadane zależności procedur: Referencje procedur dodają trigger (ciąg znaków) oraz tablice referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids i referenced_dynamic_variables.
  • Odpowiedź z tokenem WebRTC: Odpowiedzi Pobierz token WebRTC wymagają teraz conversation_id (ciąg znaków) oprócz token. To niekompatybilna zmiana schematu dla klientów, którzy walidują lub deserializują strukturę odpowiedzi.
  • Wyniki RAG bazy wiedzy: KnowledgeBaseRagToolResultModel dodaje chunks (KnowledgeBaseRagChunkModel[]) dla trybu wyników RAG w wyniku narzędzia.

Studio

  • Status projektu roboczego: ProjectCreationMetaResponseModel.status dodaje draft. Typ tworzenia projektu używa teraz współdzielonego enum ProjectCreationMetaType z tymi samymi istniejącymi wartościami.

Głosy

  • Akcenty głosów: Dodaliśmy GET /v1/voices/accents do wyświetlania akcentów dostępnych we współdzielonej bibliotece głosów. Wyniki można filtrować według language i model_id, a każdy akcent zwraca accent, language, code i czytelną dla człowieka name. Wartość accent można przekazać do parametru zapytania accent w Pobierz współdzielone głosy, aby filtrować współdzielone głosy.

Obszary robocze

  • Raportowanie użycia webhooków: WebhookUsageType dodaje Flows.

Wydania SDK

JavaScript SDK

  • v2.60.0 - Dodano voices.accents.get do wyświetlania akcentów głosów we współdzielonej bibliotece głosów, a także API procedur ElevenAgents, zadań crawlowania bazy wiedzy, zarządzania zbiorczego i konfiguracji analizy przez referencje z najnowszego schematu.

Python SDK

  • v2.60.0 - Dodano API akcentów głosów, procedur ElevenAgents, zadań crawlowania bazy wiedzy i zarządzania zbiorczego z najnowszego schematu. Naprawiono też uruchamianie AsyncConversation, aby nie blokowało, oraz wysyłanie prymitywnych pól multipart list jako powtarzanych pól formularza.

Pakiety

API

Nowe endpointy

ElevenAgents

  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Tworzy procedurę i zwraca jej procedure_id (ciąg znaków)
    • Akceptuje opcjonalne name (ciąg znaków, maksymalnie 200 znaków), content (ciąg znaków), type (ProcedureType, domyślnie free_form) i trigger (ciąg znaków dopuszczający null)
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
    • Wyświetla procedury gałęzi z procedure_id, version_id, name, type, trigger i has_draft
    • Nie zawiera treści procedury; pobierz pojedynczą procedurę, aby odczytać jej treść
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Akceptuje opcjonalne version_id (ciąg znaków); w przeciwnym razie zwraca wersję z głowy gałęzi
    • Zwraca name, content, type i trigger
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
    • Usuwa procedurę z roboczego zestawu wersji roboczej gałęzi
  • GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Zwraca aktualną wersję roboczą procedury
  • PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Tworzy lub aktualizuje wersję roboczą
    • Wymaga name (ciąg znaków, maksymalnie 200 znaków), content (ciąg znaków, maksymalnie 50 000 znaków) i type (ProcedureType); akceptuje opcjonalne trigger (ciąg znaków dopuszczający null)
  • DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
    • Odrzuca zmiany w wersji roboczej i resetuje procedurę do zatwierdzonej wersji
  • POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
    • Kompiluje wersje robocze procedur do AgentWorkflowResponseModel
  • Utwórz zadanie crawlowania - POST /v1/convai/knowledge-base/crawl
    • Wymaga url (ciąg znaków)
    • Akceptuje opcjonalne max_depth (liczba całkowita, 1–5, domyślnie 3), max_pages (liczba całkowita, 1–10 000, domyślnie 1000), pattern (ciąg znaków), sitemap_urls (tablica ciągów znaków), parent_folder_id (ciąg znaków), enable_auto_sync (wartość logiczna, domyślnie false) i auto_remove (wartość logiczna, domyślnie false)
  • Wyświetl zadania crawlowania - GET /v1/convai/knowledge-base/crawl
    • Akceptuje opcjonalne include_job_ids (tablica ciągów znaków), page_size (liczba całkowita, 1–100, domyślnie 30) i cursor (ciąg znaków)
  • Pobierz zadanie crawlowania - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
  • Anuluj zadanie crawlowania - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
  • Pobierz zależne agenty dla wielu dokumentów - POST /v1/convai/knowledge-base/dependent-agents
    • Wymaga document_ids (tablica 1–20 unikalnych ciągów znaków)
    • Akceptuje opcjonalne dependent_type (KnowledgeBaseDependentType, domyślnie all), page_size (liczba całkowita, 1–100, domyślnie 30) i cursor (ciąg znaków)
  • Zbiorczo usuń dokumenty z bazy wiedzy - POST /v1/convai/knowledge-base/bulk-delete
    • Wymaga document_ids (tablica 1–20 unikalnych ciągów znaków)
    • Akceptuje opcjonalne force (wartość logiczna, domyślnie false)
    • Zwraca wynik powodzenia lub niepowodzenia dla każdego ID dokumentu
  • Eksportuj wyniki połączeń wsadowych - GET /v1/convai/batch-calling/{batch_id}/export
    • Zwraca odbiorców i wyniki rozmów z zakończonej partii jako CSV

Głosy

  • GET /v1/voices/accents
    • Wyświetla akcenty dostępne we współdzielonej bibliotece głosów
    • Akceptuje opcjonalne parametry zapytania language (ciąg znaków) i model_id (ciąg znaków)
    • Każdy akcent zwraca accent, language, code i name

Zaktualizowane endpointy

ElevenAgents

  • Lista rozmów - GET /v1/convai/conversations
    • Dodano opcjonalne filtry tablic ciągów znaków visited_agent_ids i visited_agent_branch_ids, każdy ograniczony do 50 wartości
    • Dodano opcjonalne tablice ciągów znaków data_collection_ids i evaluation_criteria_ids, aby wybrać wyniki analizy dla każdego podsumowania
    • Podsumowania odpowiedzi dodają opcjonalne pola obiektowe data_collection_results i evaluation_criteria_results oraz tablicę ciągów znaków tag_ids
  • Wyszukiwanie tekstowe w wiadomościach rozmów - GET /v1/convai/conversations/messages/text-search
    • Dodano opcjonalne filtry tablic ciągów znaków visited_agent_ids i visited_agent_branch_ids, każdy ograniczony do 50 wartości
  • Pobierz token WebRTC - GET /v1/convai/conversation/token
    • Odpowiedzi wymagają teraz conversation_id (ciąg znaków)
    • Niekompatybilna zmiana: ścisłe walidatory i deserializery odpowiedzi muszą akceptować nowe wymagane pole

Zmiany schematu

ElevenAgents

  • Ustawienia żądań i odpowiedzi platformy agenta dodają opcjonalne pole dopuszczające null analysis_items, typu AgentAnalysisItems, dla konfiguracji oceny i zbierania danych przez referencje
  • Referencje procedur dodają trigger (ciąg znaków), referenced_tool_ids (tablica ciągów znaków), referenced_kb_ids (tablica ciągów znaków), referenced_procedure_ids (tablica ciągów znaków) i referenced_dynamic_variables (tablica ciągów znaków)
  • KnowledgeBaseRagToolResultModel dodaje chunks (KnowledgeBaseRagChunkModel[])

Studio

  • ProjectCreationMetaResponseModel.status dodaje draft
  • ProjectCreationMetaResponseModel.type odwołuje się teraz do współdzielonego enum ProjectCreationMetaType

Obszary robocze

  • WebhookUsageType dodaje Flows