대화 주제 검색과 지식 검색 추가
대화 주제 탐색, 지식 기반 콘텐츠 검색, 브랜치 병합 유연화가 추가되고 음성·SDK·패키지가 함께 개선됐다.
교안에 영향
이전 안내에서 merge branch는 main 브랜치에만 병합된다고 설명했다면 이제는 맞지 않다.
요약
- conversation topics 엔드포인트와 list conversations의 topic_ids 필터가 추가됐다. - search knowledge base 엔드포인트가 추가되어 문서 내용 검색, 하이라이트 스니펫, 커서 기반 페이지네이션을 지원한다. - merge branch가 main 브랜치 외 대상도 허용하며, force와 브랜치 계보 응답 필드가 추가됐다. - get secret dependencies와 list secrets의 dependency_limit, 대기 의존성 표시가 추가됐고, gemini-3.1-pro-preview가 지원된다. - voices의 voice_type에 non-community가 추가됐고, SDK와 패키지 전반의 버그가 수정됐다.
바뀐 것
새 기능
- conversation topics 엔드포인트(GET /v1/convai/agents/{agent_id}/topics)가 추가되어 에이전트의 최신 주제 탐지 결과를 반환한다.
- list conversations 엔드포인트가 topic_ids 쿼리 매개변수를 지원해 발견된 주제로 대화를 필터링할 수 있다.
- search knowledge base 엔드포인트(GET /v1/convai/knowledge-base/search)가 추가되어 지식 기반 문서 내용을 퍼지 검색할 수 있다.
- 검색 결과에 SearchHighlightSegment 객체를 포함한 하이라이트 스니펫과 커서 기반 페이지네이션이 지원된다.
- search knowledge base에서 types 매개변수로 문서 유형을 필터링할 수 있다.
- merge branch 엔드포인트에 선택적 force boolean 매개변수가 추가되어 true일 때 시간표 기반 충돌 해결을 덮어쓴다.
- get secret dependencies 엔드포인트(GET /v1/convai/secrets/{secret_id}/dependencies/{resource_type})가 추가되어 resource_type별 의존성 조회를 페이지네이션으로 제공한다.
- 에이전트 설정용 LLM 목록에 gemini-3.1-pro-preview가 추가됐다.
- voices의 list voices 엔드포인트가 voice_type 값 non-community를 지원해 개인 및 작업공간 음성만 보여준다.
개선
- merge branch 엔드포인트가 더 이상 main 브랜치로만 제한되지 않고 어떤 브랜치도 병합 대상으로 사용할 수 있다.
- 브랜치 메타데이터 응답에 parent_branch_id와 merged_from_version_id가 포함되어 계보 추적이 쉬워졌다.
- list secrets 엔드포인트가 dependency_limit 쿼리 매개변수를 지원하고, agents_has_more, tools_has_more, phone_numbers_has_more 플래그로 추가 의존성 존재 여부를 알린다.
기타
- Python SDK v2.43.0이 April 13, 2026 API schema에 맞춰 재생성되었다.
- JavaScript SDK v2.43.0이 April 13, 2026 API schema에 맞춰 재생성되었다.
- @elevenlabs/react-native@1.1.0이 @elevenlabs/client@1.2.0과 @elevenlabs/react@1.1.0으로 업데이트되었다.
수정
- Swift SDK v3.1.3에서 소프트웨어 음소거 VAD의 배경 소음 감지를 줄여 마이크 음소거 중 오탐지를 방지했다.
- @elevenlabs/client@1.2.0에서 React Native의 getInputVolume()과 getOutputVolume()이 0을 반환하던 문제를 수정했다.
- @elevenlabs/client@1.2.0에서 getInputByteFrequencyData()와 getOutputByteFrequencyData()가 사람 음성 대역에 맞는 데이터를 반환하도록 개선됐다.
- 웹에서 getInputVolume()과 getOutputVolume()도 사람 음성 대역을 기준으로 계산되도록 바뀌었다.
- @elevenlabs/react@1.1.0에서 ConversationProvider의 startSession 오류가 onError로 전달되지 않고 숨겨지던 문제가 수정됐다.
- @elevenlabs/convai-widget-core@0.11.3에서 음성 모드의 transcript 메시지 순서가 수정됐다.