Changelog

Nowe endpointy

ElevenAgents

• Dodano dziewięć endpointów ticketów oceny rozmów:
  • Utwórz ticket rozmowy - POST /v1/convai/triage-tickets. Żądanie wymaga conversation_id (string) i akceptuje qa_comment (nullable string, 1–10 000 znaków) oraz do 200 komentarzy do tur.
  • Lista ticketów - GET /v1/convai/agents/{agent_id}/triage-tickets, z paginacją kursorową.
  • Utwórz ręczny ticket - POST /v1/convai/agents/{agent_id}/triage-tickets. Żądanie wymaga qa_comment (string, 1–10 000 znaków).
  • Lista użytkowników, którym można przypisać ticket - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. Odpowiedź zawiera członków obszaru roboczego, którzy nie są kontami usługowymi, oraz informację, czy każdy z nich ma dostęp do agenta.
  • Pobierz ticket - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Zaktualizuj ticket - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. Żądanie akceptuje opcjonalne status i nullable assignee_user_id.
  • Usuń ticket - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • Dodaj komentarz - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. Żądanie wymaga comment (string, 1–10 000 znaków).
  • Dodaj komentarz do tury - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. Żądanie wymaga indeksu turn_index od zera (integer) oraz comment (string, 1–10 000 znaków).

Zaktualizowane endpointy

ElevenAgents

• Pobierz podpisany URL - GET /v1/convai/conversation/get-signed-url
  • Dodano opcjonalne debug_events_request (boolean, domyślnie false). Zdarzenia debugowania wymagają dostępu edytora do agenta.
• Pobierz token WebRTC - GET /v1/convai/conversation/token
  • Dodano opcjonalne debug_events_request (boolean, domyślnie false). Starsza ścieżka GET /v1/convai/conversation/get_signed_url akceptuje ten sam parametr.
• Lista rozmów - GET /v1/convai/conversations
  • Dodano opcjonalne triggered_procedure_ids (nullable string array, maksymalnie 50), aby dopasować rozmowy, w których uruchomiono dowolną wskazaną procedurę.
  • Dodano opcjonalne include_invalid_tool_calls (boolean, domyślnie false), aby uwzględniać wywołania narzędzi, które się nie uruchomiły.
  • Dodano opcjonalne sort_direction (asc lub desc, domyślnie desc) dla czasu rozpoczęcia połączenia.
• Wyszukaj tekstowo wiadomości w rozmowach - GET /v1/convai/conversations/messages/text-search
  • Dodano opcjonalne triggered_procedure_ids (nullable string array, maksymalnie 50).
  • Dodano opcjonalne include_invalid_tool_calls (boolean, domyślnie false).
• Pobierz tematy rozmów agenta - GET /v1/convai/agents/{agent_id}/topics
  • Dodano opcjonalne include_evaluation_criteria (boolean, domyślnie true).
  • Dodano frustration do sort_by.
  • Odpowiedzi tematów zyskują nullable success_rate (number), a cała odpowiedź zyskuje aggregated_run_count (integer, domyślnie 0).
  • from_unix_secs jest zaokrąglane w dół do początku dnia UTC. Ograniczony zakres agreguje ukończone dzienne uruchomienia wykrywania; pominięcie obu granic zwraca najnowsze uruchomienie.
• Lista procedur (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) i Pobierz procedurę (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})
  • Dodano opcjonalne nullable agent_version_id (string), aby pobierać procedury z konkretnej wersji agenta.
• Utwórz test i Zaktualizuj test
  • Dodano opcjonalne nullable environment (string) do schematów testów jednostkowych odpowiedzi, symulacji i wywołań narzędzi. Wartość wybiera adresy URL, nagłówki i połączenia autoryzacji dla danego środowiska; domyślnie jest to production.
• Utwórz dokument z URL, Utwórz zadanie crawlowania i Utwórz folder
  • Dodano opcjonalne nullable minimum_frequency_days (integer, 1–180) dla automatycznej synchronizacji. Wartość domyślna to 7, a częstotliwość bardziej restrykcyjnego folderu nadrzędnego ma pierwszeństwo.

Music

• Lista Music Finetunes - GET /v1/music/finetunes
  • Zwiększono maksymalne page_size ze 100 do 150. Wartość domyślna nadal wynosi 50.

Zmiany schematów

ElevenAgents

• Żądania aktualizacji agenta zyskują opcjonalne nullable procedures (object<string, ProcedureVersionRef>). Każda wartość wymaga procedure_id i version_id (stringi). Pusty obiekt usuwa wszystkie procedury.
• Konfiguracja inicjowania rozmowy zyskuje enable_procedure_ids_from_client (boolean, domyślnie false). Dane inicjujące zyskują opcjonalne nullable procedure_ids (string array); pusta tablica wyłącza wszystkie procedury dla agenta rozpoczynającego rozmowę.
• ClientEvent zyskuje context_usage.
• Zastąpienia soft timeout zyskują opcjonalne nullable additional_soft_timeout_messages (string array).
• Stałe wartości w modelach analizy i zastępowania schematu akceptują teraz null.
• Domyślne wartości konfiguracji widgetu dla mic_muting_enabled i transcript_enabled zmieniły się z false na true. Ustaw je jawnie na false, aby zachować wcześniejsze działanie.

Obszar roboczy

• Odpowiedzi Pobierz użytkownika usunęły xi_api_key z UserResponseModel.
• ResourceMetadataResponseModel.role_to_group_ids akceptuje teraz niestandardowe identyfikatory ról jako klucze zamiast ograniczać je do admin, editor, commenter i viewer.
• Odpowiedzi bezpośredniego publikowania zyskują opcjonalne nullable restricted_to_user_email_domains (string array).
• Odpowiedzi oczekującej zmiany subskrypcji dodają go do next_tier.