Music Finetunes와 에이전트·워크스페이스 기능 확장
Music Finetunes 관리, 에이전트 조회·설정, 워크스페이스 알림과 사용량 기능이 추가됐다.
교안에 영향
기존 안내에서 Twilio 녹음은 저장 위치, webhook 설정은 webhook_id 기준, 서비스 계정 문자 한도 해제는 character_limit: "clear", Speech to Text 단일 사용 인증은 새 token 방식으로 써야 한다.
요약
- Music Finetunes API와 모든 music generation SDK 메서드에 finetune_id 지원이 추가됐다. - 대화 참조 해결, 지식 베이스 조회, 음성 설정, 도구 파라미터, 가드레일, Twilio 녹음, 위젯 문구, 검색 필터, LLM 옵션, WhatsApp 입력 표시 등 ElevenAgents 기능이 확장됐다. - Speech to Text에 단일 사용 토큰 인증이 추가되고, @elevenlabs/client의 Realtime 오류 처리와 마이크 정리가 개선됐다. - pronunciation dictionary의 archived 포함 여부, 워크스페이스 웹훅 이벤트, 사용량 차원, 서비스 계정 한도 해제, 알림 웹훅 참조 방식이 변경됐다. - JavaScript SDK, Python SDK, Android SDK, CLI가 최신 API와 동작 변경을 반영했다.
바뀐 것
새 기능
- Music Finetunes API가 추가되어 업로드한 오디오로 Finetune을 만들고, 목록 조회·학습 상태 확인·메타데이터와 공개 범위 수정·삭제를 할 수 있다.
- GET /v1/convai/conversations/resolve 가 추가되어 Slack 메시지 URL 또는 Zendesk 티켓 URL을 conversation 으로 해석할 수 있다.
- POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query 가 추가되어 에이전트 지식 베이스에 대한 읽기 전용 RAG 조회를 할 수 있다.
- Convert speech to text 에 선택적 token 인증이 추가됐다.
개선
- 모든 music generation SDK 메서드가 finetune_id 를 노출한다.
- Knowledge base file, text, URL 응답에 선택적 content_format 이 추가됐다.
- TTS override schemas 에 선택적 client-overridable model_id 가 추가됐고 enable_phoneme_tags 의 기본값이 false 에서 true 로 바뀌었다.
- 기본 cascade_timeout_seconds 가 8초에서 4초로 바뀌었다.
- Object tool parameters 가 dynamic_variable, constant_value, is_omitted 를 사용할 수 있게 됐고, constant schema overrides 가 임의의 배열과 객체를 받을 수 있게 됐다.
- Custom guardrails 에 선택적 evaluate_full_response_only 가 추가돼 전체 비-TTS 응답을 한 번만 평가할 수 있다.
- Telephony call configuration 에 선택적 twilio_call_recording_enabled 가 추가됐다.
- Widget text configuration 에 파일 첨부, 제거, 업로드 실패, 지원하지 않는 형식, 용량 초과, 파일 개수 제한, 입력 표시 관련 문구가 추가됐다.
- Knowledge base file 응답에 선택적 auto_sync_info 와 refresh_status 가 추가됐고, folder 응답에 required document_count 가 추가됐다.
- Text search conversation messages 에 선택적 exclude_statuses 와 termination_reasons 쿼리 파라미터가 추가됐다.
- Agent LLM configuration 에 gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna 가 추가됐고 LLMReasoningEffort 에 max 가 추가됐다.
- WhatsApp account 요청과 응답 스키마에 선택적 enable_typing_indicator 가 추가됐다.
- List pronunciation dictionaries 에 선택적 include_archived 가 추가됐다.
- Update workspace webhook 요청에 events 가 추가되어 voice_library_removal_notice, speech_to_text, agent_qa 를 구독할 수 있고, 응답에서 구독 이벤트 목록을 반환할 수 있다.
- Get workspace usage 의 group_by 값에 surface 와 actor 가 추가됐다.
- Update service account API key 가 character_limit: "clear" 로 월간 문자 한도를 해제할 수 있게 됐다.
- Alerting webhook notifier 스키마가 url, method, headers 대신 required webhook_id 로 workspace webhook 을 식별하도록 바뀌었다.
기타
- @elevenlabs/client 가 RealtimeEvents.ERROR 로 마이크 설정 오류와 잘못된 서버 오류를 보고하고, 설정 실패와 연결 종료 뒤 마이크 자원을 해제하며, 소켓 종료 후 늦게 도착한 마이크 프레임을 버리도록 개선됐다.
- JavaScript SDK v2.59.0 이 Music Finetunes, conversation reference resolution, archived pronunciation dictionary filtering, single-use Speech to Text tokens 를 지원한다.
- Python SDK v2.59.0 이 Music Finetunes, conversation reference resolution, signed post-call webhook 설정을 지원한다.
- @elevenlabs/client@1.15.1 이 Scribe Realtime 오류 전달과 마이크 정리를 개선했다.