워크플로 시작 지점 지정과 분석 LLM 설정 추가
대화 시작 지점 지정, 사후 분석용 LLM 설정, 새 LLM 옵션과 조회·분석 API가 추가되었습니다.
교안에 영향
기존 안내에서 GET /v1/usage/character-stats 사용법을 설명한 내용은 더 이상 맞지 않습니다.
요약
- workflow 시작 시 특정 노드에서 대화를 시작할 수 있는 시작 지점 지정이 추가되었습니다. - post-call analysis에 사용할 기본 LLM을 설정하는 analysis_llm과 항목별 llm 재정의가 추가되었습니다. - gpt-5.4와 xhigh가 새 LLM 옵션으로 추가되었고, workflow 식에서 null 비교가 지원됩니다. - secret 조회, 사용량 분석, 전화번호 선택, 화자 역할 감지, Text to Dialogue 안내와 SDK 수정이 반영되었습니다.
바뀐 것
새 기능
- agent 설정에 사용할 수 있는 LLM 목록에 gpt-5.4가 추가되었습니다.
- LLMReasoningEffort enum에 xhigh가 추가되었습니다.
- workflow 조건식에서 null 비교를 지원하는 ASTNullNode가 추가되었습니다.
- GET /v1/convai/secrets/{secret_id}로 workspace secret 한 개를 ID로 조회할 수 있게 되었습니다.
- POST /v1/workspace/analytics/query/usage-by-product-over-time로 제품별 사용량을 시간에 따라 조회할 수 있게 되었습니다.
개선
- Conversations를 시작할 때 starting_workflow_node_id로 특정 workflow 노드에서 대화를 시작할 수 있게 되었습니다.
- enable_starting_workflow_node_id_from_client 설정으로 클라이언트가 시작 노드를 지정할 수 있게 되었습니다.
- post-call analysis용 analysis_llm 필드가 추가되어 기본 LLM을 지정할 수 있게 되었습니다.
- AnalysisProperty schema의 per-item llm 필드로 개별 데이터 수집 항목의 LLM을 재정의할 수 있게 되었습니다.
- list secrets 엔드포인트에 name prefix로 필터링하는 search 쿼리 파라미터가 추가되었습니다.
- dashboard의 batch calling 폼에 검색 가능한 phone number 선택기가 추가되었습니다.
- convert speech to text가 detect_speaker_roles 파라미터를 지원하며, diarize=true와 함께 쓰면 화자 라벨이 agent와 customer로 반환됩니다.
- text to dialogue 엔드포인트의 inputs[].text 전체 입력에 대해 권장 2,000자 제한 안내가 추가되었습니다.
기타
- ElevenLabs Devs YouTube channel이 새로 열려 튜토리얼, API 안내, 기술 심화 내용을 제공합니다.
- detect_speaker_roles는 use_multi_channel=true와 함께 사용할 수 없고, 추가 10% 수수료가 부과됩니다.
- 더 긴 text to dialogue 요청은 스트리밍 응답이 일찍 종료되거나 검증 오류가 발생할 수 있습니다.
- 기존 GET /v1/usage/character-stats는 새 사용량 분석 엔드포인트로 대체되어 사용 중단되었습니다.
수정
- @elevenlabs/client@1.2.1에서 conversation 시작 준비 상태가 수정되어 onConnect가 연결 완료 후 실행됩니다.
- @elevenlabs/client@1.2.1에서 onConversationCreated가 노출 및 전달되어 onConnect 전에 Conversation 인스턴스를 받을 수 있게 되었습니다.
- @elevenlabs/react@1.1.1에서 conversation 시작 준비 상태가 수정되고 onConversationCreated 콜백이 추가되었습니다.
- @elevenlabs/react-native@1.1.1, @elevenlabs/convai-widget-core@0.11.4, @elevenlabs/convai-widget-embed@0.11.4가 @elevenlabs/client@1.2.1로 업데이트되었습니다.