변경 로그

ElevenAgents

• **agent_response_complete WebSocket 이벤트 **: 에이전트의 응답이 완전히 전달되면(모든 LLM 생성, 도구 호출 체인, 오디오 재생이 완료된 후) 정확히 한 번 실행되는 새로운 agent_response_complete 클라이언트 이벤트가 추가되었습니다. 이 이벤트 이후 에이전트는 사용자가 새 입력을 제공하거나 턴 제한 시간이 새 턴을 트리거하는 경우에만 추가 출력을 생성합니다. 클라이언트는 이 이벤트를 통해 메시지 일괄 처리, 웨이크 워드 활성화 또는 턴 후 UI 업데이트를 위한 턴 종료 시점을 안정적으로 감지할 수 있습니다. ClientEvent 열거형에 새로운 AGENT_RESPONSE_COMPLETE 값을 추가하고, 이에 대응하는 AgentResponseCompleteClientEvent 응답 모델을 추가했습니다.

• 도구 호출 전 발화 모드: MCP 서버 구성과 도구별 재정의에 새로운 pre_tool_speech 필드(기본값 auto인 PreToolSpeechMode 열거형)를 추가했습니다. 이제 더 이상 사용되지 않는 force_pre_tool_speech 불리언을 대체합니다. 값은 다음과 같습니다. auto는 최근 도구 지연 시간을 기준으로 도구 호출 전에 에이전트가 말할지 결정하고, force는 항상 에이전트에게 말하도록 요청하며, off는 완전히 비활성화합니다.

• 도구 디스패치가 실행 모드를 준수: 이제 워크플로 도구 디스패치 노드는 중첩된 각 도구의 execution_mode를 올바르게 준수합니다. 디스패치 노드의 도구 중 하나라도 POST_TOOL_SPEECH를 사용하면 워크플로는 디스패치를 실행하기 전에 현재 턴의 오디오가 완전히 노출될 때까지 기다립니다.

• MCP 응답 제한 시간: MCP 서버 구성과 도구별 재정의에 각 MCP 도구 호출이 완료될 때까지 기다리는 최대 시간을 제어하는 response_timeout_secs 필드(정수, 기본값 30, 최솟값 5, 최댓값 120)를 추가했습니다.

• 에이전트 신뢰 컨텍스트: 에이전트 플랫폼 설정에 trust_context 필드(기본값 unknown인 AgentTrustContext 열거형: unknown | low | high)를 추가했습니다. low는 출력 검토와 제한된 도구 액세스가 필요한 신뢰할 수 없는 외부 참여자를 지원하는 에이전트용이고, high는 전체 도구 액세스가 적합한 소유자를 지원하는 에이전트용이며, unknown은 이 기능 이전에 생성된 에이전트를 위한 값입니다.

• 소스 출처 표시 토글: 대화 구성에 source_attribution 불리언(기본값 false)을 추가했습니다. 활성화되어 있고 지식 베이스 콘텐츠가 있으면 LLM은 사용한 소스를 보고하도록 지시받습니다.

• 테스트 공유 모드 필터: 이제 테스트 목록 엔드포인트는 현재 사용자가 생성하지 않았으며 현재 사용자와 공유된 테스트와 폴더만 필터링하는 sharing_mode 쿼리 매개변수(기본값 all, all | shared_with_me)를 지원합니다.

• 도구 아이콘 및 실행 메타데이터: Tool 스키마에 icons(Icon 배열) 및 execution(ToolExecution) 필드를 추가했습니다. Icon에는 UI 표시에 사용할 src, mimeType, sizes가 포함되며, ToolExecution.taskSupport(forbidden | optional | required)는 도구가 작업에 참여하는 방식을 선언합니다.

• 프로시저 컴파일러 기본값: ProcedureCompilerMode 기본값이 deterministic에서 append로 변경되었으며, llm 값은 제거되었습니다. deterministic를 명시적으로 설정한 기존 에이전트는 영향을 받지 않습니다.

• RAG 및 지식 베이스 출처 메타데이터: ConversationHistoryTranscriptCommonModel 및 ConversationHistoryTranscriptResponseModel에 used_static_kb_document_ids(문자열 배열)를, RagRetrievalInfo에 used_chunk_ids를 추가하여 각 트랜스크립트 턴에 기여한 지식 베이스 문서와 RAG 청크를 정확히 표시합니다.

• 동적 변수 리팩터링: 이제 dynamic_variables 및 dynamic_variable_placeholders는 중첩 값과 목록 값을 더 폭넓게 지원하는 통합 DynamicVariableValueType-Input / DynamicVariableValueType-Output 스키마(기존 DynamicVariableContainerValueType-* 스키마 대체)를 참조합니다. DynamicVariableAssignment에는 값을 문자열로 강제 변환하는 대신 형식이 지정된 값을 유지하는 preserve_native_type 필드가 추가되었습니다.

오디오 분리

• 히스토리 엔드포인트: 오디오 분리 히스토리를 제공하는 두 개의 새 엔드포인트가 추가되었습니다.
  • 오디오 분리 히스토리 목록 (GET /v1/audio-isolation/history)는 모든 오디오 분리 생성 항목의 페이지네이션 목록을 반환합니다. page_size, page, search 쿼리 매개변수를 지원합니다.
  • 오디오 분리 히스토리 항목 삭제 (DELETE /v1/audio-isolation/history/{history_item_id})는 특정 항목과 연결된 미디어 파일을 삭제합니다.

음성 텍스트 변환

• 실시간 키워드 및 원문 모드: 이제 Scribe 실시간 WebSocket은 모델이 특정 용어를 더 우선하도록 하는 keyterms 매개변수(문자열 배열, 항목 최대 50개, 각 항목 최대 20자)와 트랜스크립트에서 군더더기 말, 잘못 시작한 발화, 비유창성을 제거하는 no_verbatim 불리언을 지원합니다. 두 매개변수는 모두 session_started 이벤트에서 다시 반환됩니다. JavaScript SDK, Python SDK, @elevenlabs/client 브라우저/Node 클라이언트 SDK에서 사용할 수 있습니다.

SDK 릴리스

Python SDK

• v2.45.0 - 오디오 분리 히스토리 엔드포인트, 도구 실행, MCP pre_tool_speech 및 response_timeout_secs, agent_response_complete 클라이언트 이벤트를 포함하는 2026년 4월 27일 API 스키마용 Fern 재생성입니다. README의 노트북 설치 안내도 수정했습니다.
• v2.44.0 - trust_context 필드, pre_tool_speech 모드, 에셋 트랜스크립션 지원, MCP 응답 제한 시간 구성을 포함하는 2026년 4월 21일 API 스키마용 Fern 재생성입니다.

JavaScript SDK

• v2.45.0 - Scribe 실시간 클라이언트에 keyterms(문자열 배열, 키워드 최대 50개, 각 최대 20자) 및 noVerbatim(불리언) 옵션을 추가했습니다. keyterms는 트랜스크립션을 우선 처리하도록 WebSocket URL의 반복 쿼리 매개변수로 전송되며, noVerbatim은 군더더기 말과 비유창성을 제거합니다. 두 필드는 session_started 에코를 위한 형식 지정 Config 인터페이스에도 추가되었습니다. 또한 2026년 4월 27일 Fern 재생성을 포함합니다(#376).
• v2.44.0 - trust_context 필드, pre_tool_speech 모드, MCP 응답 제한 시간 구성을 포함하는 2026년 4월 21일 API 스키마용 Fern 재생성입니다.

Swift SDK

• v3.1.4 - 에이전트 연결이 끊긴 후(무음 제한 시간 또는 end_call 도구) 로컬 마이크가 계속 게시되던 문제를 수정했습니다. 이제 onAgentDisconnected는 LiveKit 룸 연결을 해제하고 대화 상태를 정리하며, onDisconnect는 .agent 사유와 함께 실행됩니다. ConnectionManaging.onAgentDisconnected는 이제 async입니다. 사용되지 않는 ConversationConnectionManager 래퍼를 제거했습니다.

패키지

• @elevenlabs/client@1.3.1 - 에이전트 도구 호출 사운드가 사용자 음성으로 해석되어 도구 실행 중 에이전트를 중단시키던 문제를 수정했습니다.
• @elevenlabs/client@1.3.0 - 대화 파일 업로드 엔드포인트 지원을 추가하여 클라이언트가 클라이언트 SDK에서 진행 중인 대화에 파일을 직접 첨부할 수 있습니다.
• @elevenlabs/react@1.2.1, @elevenlabs/react@1.2.0 - 도구 호출 사운드 수정 및 대화 파일 업로드 지원이 포함된 @elevenlabs/client@1.3.1 / @elevenlabs/client@1.3.0으로 업데이트했습니다.
• @elevenlabs/react-native@1.1.3, @elevenlabs/react-native@1.1.2 - 동일한 수정 사항을 위해 최신 @elevenlabs/client로 업데이트했습니다.
• @elevenlabs/convai-widget-core@0.11.6, @elevenlabs/convai-widget-embed@0.11.6 - 도구 호출 사운드 수정을 위해 @elevenlabs/client@1.3.1로 업데이트했습니다.
• @elevenlabs/convai-widget-core@0.11.5, @elevenlabs/convai-widget-embed@0.11.5 - 대화 파일 업로드 지원을 위해 @elevenlabs/client@1.3.0으로 업데이트했습니다.

API