음악 v2와 대화 평가 재실행 추가
Music v2와 대화 평가 재실행, 워크플로·통화 필터와 여러 세부 옵션이 추가되었습니다.
교안에 영향
기존 안내 글에서 `InteractionBudget`의 `async` 값, `voice_id`를 기준으로 한 Studio 음성 안내, 서비스 계정 API 키 수정 시 본문 필수 안내는 더 이상 맞지 않습니다.
요약
- Music v2를 API에서 사용할 수 있게 되었고, composition-plan과 업로드 요청에서 새 구성 계획 형식을 지원합니다. - ElevenAgents에 Run conversation evaluation, workflow entry_behavior, end_procedure, preserve_client_tts_overrides, 새로운 오류 상태와 관련 필드가 추가되었습니다. - 통화·워크스페이스·스튜디오·STT·Voices 전반에 필터, 시간대, 화자 라이브러리, 프로젝트 음성 참조 등 세부 기능이 확장되었습니다. - SDK와 패키지, iOS SDK도 최신 스키마와 새 내보내기, 라이선스, 데이터 거주 지원에 맞춰 갱신되었습니다.
바뀐 것
새 기능
- Music v2가 ElevenLabs API에서 사용 가능해졌고, Generate music, Stream music, Generate music detailed, Upload music에서 `music_v2`를 사용할 수 있습니다.
- Music v2는 `GenerationChunk`와 `AudioRefChunk` 기반의 청크형 composition plan을 도입했습니다.
- `POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run` 경로의 Run conversation evaluation endpoint가 추가되었습니다.
- Workflow override-agent nodes에 선택적 `entry_behavior`가 추가되었습니다.
- `end_procedure` system tool 설정이 추가되었고, `start_procedure`의 오류 상태에 `already_active`가 추가되었습니다.
- `AgentTransfer`, workflow standalone agent nodes, 성공한 `transfer_to_agent` tool 결과에 선택적 `preserve_client_tts_overrides`가 추가되었습니다.
- Custom guardrail configuration에 선택적 `model`과 `history_message_count`가 추가되었습니다.
- List phone numbers에 `provider`, `agent_id`, `branch_id` 쿼리 파라미터가 추가되었습니다.
- List WhatsApp accounts에 `agent_id` 쿼리 파라미터가 추가되었습니다.
- Get agent conversation topics에 `from_unix_secs`, `to_unix_secs` 쿼리 파라미터가 추가되었습니다.
- Outbound SIP trunk 요청과 응답 모델에 선택적 `enabled_codecs`가 추가되었습니다.
- `LoadableMemoryEntry`와 `LoadMemoryEntryToolErrorStatus` 스키마가 추가되었습니다.
- Agent TTS settings에 선택적 `enable_phoneme_tags`가 추가되었습니다.
- Transfer-to-number 오류 payload에 선택적 `agent_message`가 포함될 수 있습니다.
- Workspace usage-by-product-over-time 요청에 선택적 `time_zone`이 추가되었고 `interval_seconds` 구간 규칙이 명확해졌습니다.
- History list와 detail의 source 필터에 `Flows`가 추가되었습니다.
개선
- 생성 및 업로드 요청에서 v1 또는 v2 plan 형태를 모두 받을 수 있고, `composition-plan` endpoint로 먼저 계획을 만들 수도 있습니다.
- `MusicPrompt`는 `music_v1` 전용으로 남아 있습니다.
- Upload music이 선택적 `with_timestamps`를 받으며, 응답에 `words_timestamps`가 포함될 수 있습니다.
- Agent test attach, run, resubmit 요청 스키마의 최대 첨부 테스트 수가 1000에서 5000으로 늘어났습니다.
- Array JSON schema properties에 선택적 `is_omitted`가 추가되었고, `ConstantSchemaOverride`가 배열 상수 값을 사용할 수 있게 되었습니다.
- Update service account API key에서 요청 본문 필수가 사라지고, `no_update`와 nullable `name`을 포함한 부분 수정이 가능해졌습니다.
- Project models, chapter TTS nodes, voice lists, voice statistics가 `project_voice_ref_id`를 기준 음성 필드로 전환했습니다.
- 기존 `voice_id` 필드는 응답에서 deprecated, 읽기 전용 참조로 남았습니다.
기타
- `InteractionBudget`에서 `async`가 제거되고 `5_minutes`, `10_minutes`, `1_hour`가 추가되었습니다.