ElevenAgents

  • 새 위젯 구성 옵션: 이제 에이전트 대시보드에서 ElevenAgents 대화 위젯을 위한 여러 새 설정을 사용할 수 있습니다.

    • 접을 수 있는 위젯 (widget.dismissible): 사용자가 대화 중 위젯을 최소화하거나 닫을 수 있도록 합니다.
    • 작업 표시기 (widget.show_agent_status): 에이전트가 도구를 활발히 사용할 때 시각적 표시기를 보여주며, 작업 중, 완료, 오류 상태를 구분합니다. 이 설정을 활성화하면 에이전트의 클라이언트 이벤트에 agent_tool_request 및 agent_tool_response가 자동으로 추가됩니다.
    • 대화 ID 표시 (widget.show_conversation_id): 통화가 끝난 후 사용자에게 대화 ID를 표시합니다. 신규 및 기존 에이전트 모두 기본값은 true입니다.
    • 오디오 태그 표시 여부 (widget.strip_audio_tags): 대화 기록에서 오디오 태그를 숨깁니다. 신규 및 기존 에이전트 모두 기본값은 true입니다.
    • 구문 강조 테마 (widget.syntax_highlight_theme): 기록 내 코드 블록 강조 표시를 구성합니다. null(자동), light, dark를 사용할 수 있습니다.
  • 폴더 인식 에이전트 테스트: 이제 에이전트 테스트 목록 엔드포인트에서 테스트를 폴더로 구성할 수 있습니다. 필터링된 목록을 위해 parent_folder_id, include_folders, sort_mode 쿼리 매개변수를 추가했습니다. 테스트 생성 및 업데이트 엔드포인트는 테스트를 폴더에 할당하기 위한 parent_folder_id를 지원하며, 테스트 요약에는 이제 엔터티 유형, 상위 폴더 경로, 하위 항목 수가 포함됩니다.

  • **워크플로 say 노드 **: 에이전트 워크플로에 새 say 노드 유형(WorkflowSayNodeModel)을 추가했습니다. 이 노드는 conversation_config, additional_prompt, 도구 및 지식 베이스 재정의를 지원합니다. 노드의 메시지 페이로드는 두 가지 변형이 있는 판별된 유니온을 사용합니다. literal(text를 통한 정적 텍스트) 및 prompt(prompt를 통한 LLM 생성)입니다.

  • SMB 도구 구성: 필수 판별 params 객체를 포함하는 SMBToolConfig 스키마를 공식화했습니다. 지원되는 작업 유형은 create, list, search, update, delete이며, 각각 클라이언트, 직원, 서비스, 제품, 자산을 포함한 SMB 엔터티 카테고리에 적용할 수 있습니다.

  • 에이전트 요약 언어: 대화 후 요약에 사용할 언어를 지정할 수 있도록 에이전트 구성에 summary_language 필드를 추가했습니다.

  • Twilio 통화 녹음: 발신 통화 녹음을 활성화할 수 있도록 Twilio 발신 통화 요청 본문에 선택적 call_recording_enabled 필드를 추가했습니다.

  • WhatsApp 메시징 플래그: 특정 전화번호에 대해 메시징을 활성화할지 제어할 수 있도록 WhatsApp 계정 모델 및 업데이트 요청에 enable_messaging 플래그를 추가했습니다.

발음 사전

  • 모든 규칙 한 번에 설정: 새 규칙 설정 엔드포인트(POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules)는 개별 규칙을 점진적으로 추가하거나 제거하는 방식 대신, 한 번의 호출로 발음 사전의 기존 규칙을 모두 대체합니다.

  • 규칙 일치 옵션: 규칙이 텍스트와 일치하는 방식을 더 정밀하게 제어할 수 있도록 발음 사전 규칙 정의에 case_sensitive(불리언) 및 word_boundaries(불리언) 필드를 추가했습니다.

음악

  • 오디오 업로드: 새 음악 업로드 엔드포인트(POST /v1/music/upload)는 오디오 파일이 포함된 multipart/form-data 요청을 받습니다. 선택적으로 업로드한 오디오에서 작곡 계획을 추출하고 song_id가 포함된 MusicUploadResponse를 반환합니다.

  • 음성학적 이름 지원: 음악 생성, 상세 음악 생성, 음악 스트리밍 엔드포인트에 use_phonetic_names 매개변수를 추가했습니다.

  • 응답의 노래 ID: 이제 음악 생성 응답에 song_id 필드가 표시되어, 이후 API 호출에서 생성된 노래를 더 쉽게 참조할 수 있습니다.

오디오 네이티브

  • URL에서 프로젝트 콘텐츠 업데이트: 새 콘텐츠 업데이트 엔드포인트(POST /v1/audio-native/content)를 사용하면 URL을 제공하여 AudioNative 프로젝트를 업데이트할 수 있습니다. 엔드포인트는 URL에서 콘텐츠를 추출하고 변환 및 자동 게시 대기열에 추가합니다.

음성

  • 음성 북마크: 음성을 쉽게 찾을 수 있도록 음성 업데이트 요청에 bookmarked 필드를, 음성 응답 객체에 is_bookmarked를 추가하여 사용자가 음성을 북마크할 수 있게 했습니다.

SDK 릴리스

JavaScript SDK

  • v2.37.0 - 음악 생성 응답에서 song_id를 표시하도록 지원을 추가했습니다. Fern 재생성으로 최신 API 스키마 변경 사항을 포함하도록 업데이트했습니다.

Python SDK

  • v2.37.0 - 새 음악 생성 매개변수 및 음악 생성 응답의 song_id 표시를 지원하도록 추가했습니다. Fern 재생성으로 최신 API 스키마 변경 사항을 포함하도록 업데이트했습니다.

패키지

  • @elevenlabs/convai-widget-core@0.10.0 - 기록 및 스트리밍 콜백 전체에 event_id를 전달했습니다. 도구 상태 추적을 Map 기반 방식에서 display-transcript 유틸리티를 사용하는 인라인 기록 항목 방식으로 리팩터링했습니다. 연결 해제 메시지에서 대화 ID의 표시 여부를 제어하는 show-conversation-id 구성 옵션(불리언, 기본값 true)을 추가했습니다.
  • @elevenlabs/convai-widget-embed@0.10.0 - 기록 및 스트리밍 콜백 전체에 event_id를 전달했습니다. 도구 상태 추적을 인라인 기록 항목 방식으로 리팩터링했습니다.
  • @elevenlabs/types@0.6.0 - 기록 및 스트리밍 콜백 전체에 event_id를 전달했습니다.

API

새 엔드포인트

  • 발음 사전 규칙 설정 - POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules - 한 번의 호출로 발음 사전의 모든 규칙 교체
  • 음악 업로드 - POST /v1/music/upload - 오디오 파일을 업로드하여 노래를 생성하거나 참조하며, 선택적으로 작곡 계획 추출
  • URL에서 오디오 네이티브 콘텐츠 업데이트 - POST /v1/audio-native/content - 제공된 URL에서 콘텐츠를 추출하고 변환 대기열에 추가하여 AudioNative 프로젝트 업데이트

업데이트된 엔드포인트

ElevenAgents

  • 에이전트 테스트 목록

    • 폴더별로 테스트를 필터링하는 parent_folder_id 쿼리 매개변수(문자열, 선택 사항) 추가
    • 결과에 폴더 객체를 포함하는 include_folders 쿼리 매개변수(불리언, 선택 사항) 추가
    • 결과 정렬을 제어하는 sort_mode 쿼리 매개변수(문자열, 선택 사항) 추가
    • 이제 응답에 폴더 메타데이터 포함: UnitTestSummaryResponseModel의 엔터티 유형, 상위 경로, 하위 항목 수
  • 에이전트 테스트 생성, 에이전트 테스트 업데이트

    • 테스트를 폴더에 할당하기 위한 parent_folder_id 필드(문자열, 선택 사항) 추가
  • 에이전트 생성, 에이전트 업데이트, 에이전트 가져오기

    • 대화 후 요약 언어를 위한 에이전트 구성에 summary_language 필드(문자열, 선택 사항) 추가
    • widget.dismissible(불리언) 추가 - 사용자가 위젯을 접거나 닫을 수 있도록 허용
    • widget.show_agent_status(불리언) 추가 - 위젯에 도구 사용 상태 표시기 표시
    • widget.show_conversation_id(불리언) 추가 - 통화 종료 후 대화 ID 표시, 기본값은 true
    • widget.strip_audio_tags(불리언) 추가 - 기록에서 오디오 태그 숨김, 기본값은 true
    • widget.syntax_highlight_theme(문자열, null 허용) 추가 - 코드 블록 강조 테마(null, light, dark)
    • conversation_config, additional_prompt, 도구/지식 베이스 재정의를 포함하는 WorkflowSayNodeModel 스키마의 새 워크플로 노드 유형 say 추가. 메시지 페이로드는 literal 및 prompt 판별 변형 지원
  • Twilio 발신 통화

    • 발신 Twilio 통화 녹음을 활성화하는 call_recording_enabled 필드(불리언, 선택 사항) 추가
  • WhatsApp 계정 업데이트

    • 계정의 메시징을 활성화하거나 비활성화하는 enable_messaging 필드(불리언, 선택 사항) 추가
  • 웹훅 업데이트

    • 웹훅 페이로드 스키마를 맞춤 설정하는 schema_overrides 필드(객체, 선택 사항) 추가

발음 사전

음악

음성

스키마 변경 사항

새 스키마

  • WorkflowSayNodeModel - 대화 구성, 프롬프트, 도구 재정의를 포함하는 에이전트 say 작업용 워크플로 노드
  • WorkflowSayNodeMessageLiteral - say 노드용 리터럴(정적 텍스트) 메시지 페이로드
  • WorkflowSayNodeMessagePrompt - say 노드용 프롬프트 기반(LLM 생성) 메시지 페이로드
  • MusicUploadResponse - song_id를 포함하는 음악 업로드용 응답 모델
  • SMBToolConfigCreateClientParams, SMBToolConfigListClientsParams, SMBToolConfigSearchClientsParams, SMBToolConfigUpdateClientParams, SMBToolConfigDeleteClientParams - SMB 도구 작업을 위한 판별된 매개변수 유형

수정된 스키마

  • AgentConfig - summary_language 필드 추가
  • WidgetConfigV2 - dismissible, show_agent_status, show_conversation_id, strip_audio_tags, syntax_highlight_theme 필드 추가
  • SMBToolConfig - 이제 params 필드가 필수이며 판별된 유니온 사용
  • PronunciationDictionaryRule - case_sensitive 및 word_boundaries 필드 추가
  • CustomGuardrailConfig - 이제 model 필드는 기본값이 있는 선택 사항
  • UnitTestSummaryResponseModel - 폴더 메타데이터 필드 추가: 엔터티 유형, 상위 경로, 하위 항목 수