변경 로그

September 14, 2026

ElevenAgents

  • 통화 대기열 및 대기 오디오: 동시 처리 한도에 도달한 에이전트를 위한 통화 대기열을 추가했습니다. 대기 중인 발신자는 대기 오디오를 듣고, 입장하거나 시간 초과될 때까지 queue_status 이벤트를 수신합니다. 새 API 메서드로 사용자 지정 대기 오디오를 업로드하거나 삭제할 수 있습니다.
  • 테스트 버전 메타데이터: 이제 에이전트 테스트 결과에서 테스트를 실행한 에이전트 버전과 초안 변경 사항 포함 여부를 확인할 수 있습니다. 호출 요약에는 부분 재제출이 서로 다른 버전에서 실행된 경우도 표시됩니다.
  • 모델 및 계정 메타데이터: 이제 에이전트 LLM 구성에서 gemini-3.8-flash를 지원합니다. WhatsApp 계정 응답에서 해당 계정이 Cloud API를 사용하는지, 공존 가입 플로를 사용하는지 확인할 수 있습니다.

음악

  • Music v2.5 API 지원: 이제 음악 엔드포인트와 SDK에서 music_v2_5를 지원합니다. 작곡 계획 생성 청크는 최대 6,132자를 지원하며, 각 줄 최대 200자의 줄을 최대 30개까지 포함할 수 있습니다.

SDK 릴리스

JavaScript SDK

  • v2.68.0 - 에이전트 대기 오디오를 업로드하고 삭제하는 메서드를 추가했습니다. 통화 대기열, 프로시저 참조, 초안 브랜치 생성, RAG 쿼리 제한, 테스트 버전 메타데이터, gemini-3.8-flash, music_v2_5를 위한 타입을 재생성했습니다.

Python SDK

  • v2.68.0 - 에이전트 대기 오디오를 업로드하고 삭제하는 동기 및 비동기 메서드를 추가했습니다. 통화 대기열, 프로시저, 초안 브랜치 생성, RAG 쿼리 제한, 테스트 버전 메타데이터, gemini-3.8-flash, music_v2_5를 위한 타입을 재생성했습니다. 이제 compose_detailed 래퍼에서 생성된 모든 음악 모델 ID와 프롬프트 기반 및 청크 기반 작곡 계획을 모두 지원합니다.

iOS SDK

  • v3.3.1 - 에이전트 메시지를 event_id 대신 response_id로 조정하여 도구 호출 주변의 여러 응답을 보존하고, 스트리밍된 부분이나 수정 사항이 잘못된 메시지에 연결되지 않도록 했습니다.

ElevenLabs CLI

  • v1.3.0 - 생성된 API 명령에 선택적 --intent 메타데이터를 추가했습니다. CLI에서 지원하지 않는 워크플로를 신고할 수 있도록 elevenlabs feedback missing-capability를 추가했습니다.

패키지

  • @elevenlabs/convai-widget-core@0.18.2 및 @elevenlabs/convai-widget-embed@0.18.2 - 도구 및 프로시저 호출 후 중복되는 에이전트 답변을 수정했습니다. 스트리밍된 텍스트 답변은 Markdown 형식을 유지하며, 음성 대화에서는 발화되지 않은 스트리밍 채팅 부분이 더 이상 렌더링되지 않습니다. 임베드 패키지는 user_activity 이벤트도 초당 한 번으로 제한하고 세션이 종료되면 이 제한을 해제합니다.

API

새 엔드포인트

ElevenAgents

  • 에이전트 대기 오디오 업로드 - POST /v1/convai/agents/{agent_id}/hold-audio
    • 필수 hold_audio_file(바이너리)을 multipart 양식 데이터로 받습니다. 파일은 최대 40MB 및 180초 길이의 MP3 또는 WAV여야 합니다.
    • 필수 agent_id(문자열) 및 hold_audio(AgentHoldAudioConfig)를 반환합니다. 대기 오디오 객체에는 audio_path, audio_url, original_filename(문자열), duration_secs(숫자), size_bytes(정수)가 필요합니다.
  • 에이전트 대기 오디오 삭제 - DELETE /v1/convai/agents/{agent_id}/hold-audio
    • 사용자 지정 클립을 제거하여 대기 중인 발신자가 기본 대기음을 듣도록 합니다.
    • 필수 agent_id(문자열)를 반환합니다.

업데이트된 엔드포인트

ElevenAgents

  • 에이전트 생성, 에이전트 가져오기 및 에이전트 업데이트
    • enabled(불리언, 기본값 false) 및 wait_timeout_seconds(정수, 1–1,800, 기본값 180)가 포함된 선택적 platform_settings.queueing_config(AgentQueueingConfig)를 추가했습니다.
    • 대기열 구성 응답에는 읽기 전용의 nullable hold_audio(AgentHoldAudioConfig)가 포함됩니다. 에이전트 응답에는 선택적 default_hold_audio_url(문자열)도 포함됩니다.
  • 대화 가져오기 - GET /v1/convai/conversations/{conversation_id}
    • 메타데이터에 선택적 nullable queue_wait_secs(숫자)를 추가했습니다. 대기열 시간은 call_duration_secs 및 청구 시간에서 제외됩니다.
  • 에이전트 브랜치 생성 - POST /v1/convai/agents/{agent_id}/branches
    • 선택적 include_draft(불리언, 기본값 false)를 추가했습니다. true인 경우 브랜치 팁에서 생성된 브랜치에 호출자의 초안 프로시저 세트가 포함됩니다.
  • 프로시저 나열 및 프로시저 생성, 가져오기, 초안 엔드포인트
    • 목록 항목에 선택적 referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids, referenced_dynamic_variables(문자열 배열)를 추가했습니다.
    • 에이전트 및 병합 미리보기 응답에 프로시저 ID를 키로 하는 맵인 선택적 procedures를 추가했습니다.
  • 테스트 호출 나열 - GET /v1/convai/test-invocations
    • 이름으로 테스트와 폴더를 필터링하는 선택적 nullable search(문자열)를 추가했습니다.
  • 에이전트에서 테스트 실행 및 테스트 호출 가져오기
    • 테스트 스위트 호출 및 단위 테스트 실행 응답에 선택적 nullable version_id(문자열)와 선택적 ran_against_draft(불리언, 기본값 false)를 추가했습니다.
    • 호출 요약에도 선택적 runs_diverged_from_version(불리언, 기본값 false)를 추가했습니다.
  • POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
    • 요청 본문에 쿼리별 재정의 값으로 선택적 nullable max_documents_length(정수, 1–50,000) 및 max_retrieved_rag_chunks_count(정수, 1–20)를 추가했습니다.
  • WhatsApp 계정 가져오기 - GET /v1/convai/whatsapp-accounts/{phone_number_id}
    • 선택적 account_type(WhatsAppAccountType, 기본값 cloud_api)을 추가했습니다. 값은 cloud_api 및 coexistence입니다.
  • 예상 LLM 사용량 계산 - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
    • LLMUsageCalculatorLLMResponseModel에 필수 price_per_message(숫자)를 추가했습니다.

음악

  • MusicModelID에 POST /v1/music/video-to-music, POST /v1/music/plan, 음악 작곡, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream, POST /v1/music/upload, POST /v1/music/finetunes용 music_v2_5를 추가했습니다.
  • GenerationChunk.text의 maxLength를 POST /v1/music/plan, POST /v1/music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream, POST /v1/music/upload에 대해 6,000자에서 6,132자로 늘렸습니다. 섹션 이름은 1~100자를 포함할 수 있고, 청크에는 한 줄당 200자씩 최대 30줄을 포함할 수 있습니다.

스키마 변경 사항

ElevenAgents

  • 실시간 서버 이벤트에 queue_status를 추가했습니다. 필수 queue_status_event.status는 waiting, admitted, timed_out를 지원하며, timed_out은 WebSocket 종료 코드 4300보다 먼저 발생합니다. 대기 오디오는 계속 일반 audio 이벤트로 전달됩니다.
  • LLM 열거형에 대화 시작 재정의를 포함하여 gemini-3.8-flash를 추가했습니다.
  • 대화 시스템 도구 결과 유니온에 start_procedure_success, start_procedure_error, end_procedure_success, end_procedure_error를 추가했습니다.
  • FeaturesUsageCommonModel에 선택적 freeform_procedure 및 structured_procedure 기능 상태를 추가했습니다.