변경 로그

May 13, 2026

ElevenAgents

  • SIP 로그: 이제 대화 기록과 전화번호 설정에서 SIP 트렁크 통화의 SIP 시그널링 로그를 확인할 수 있습니다. 로그에는 SIP 통화 ID, 전화번호, 주소, 전송 방식, 메시지 방향, 원시 메시지 및 오류가 포함되어 통화 설정 및 라우팅 문제를 디버깅하는 데 도움이 됩니다.
  • 지식 베이스 문서 업데이트: 문서의 인덱싱된(RAG) 청크를 나열하는 새 API가 추가되었습니다. 문서를 제자리에서 편집할 수도 있습니다. 항목 이름을 변경하고 텍스트 기반 문서의 경우 파일을 다시 업로드하지 않고 본문을 업데이트할 수 있습니다. (파일 기반 문서는 해당하는 경우 기존 파일 교체 흐름을 계속 사용합니다.)
  • SMS 대화 메타데이터: 대화 메타데이터에 SMSConversationInfo, 인증 방식으로 sms, 대화 시작 소스로 twilio_sms를 추가하여 SMS를 지원합니다.
  • 에이전트 구성 업데이트: 배경 음악 구성 스키마, 알림 모니터 구성, 2D 레이아웃 필드, 위젯 파일 업로드 구성과 새 LLM 옵션 gpt-5.4-mini, gpt-5.4-nano, gpt-5.4-mini-2026-03-17, gpt-5.4-nano-2026-03-17이 추가되었습니다.

워크스페이스

  • API 요청 분석: 시간 범위, 필터링, 검색, 정렬 및 제한 설정으로 API 요청을 조회할 수 있는 워크스페이스 분석 엔드포인트가 추가되었습니다.
  • API 키 IP 허용 목록: 서비스 계정 API 키 생성, 수정 및 응답 스키마에 allowed_ips가 추가되었습니다. 생성 요청에서는 IP 주소 또는 CIDR 범위 배열을 지정하거나, 모든 IP를 허용하려면 null을 지정할 수 있습니다. 수정 요청에서는 clear와 no_update도 사용할 수 있습니다.
  • 워크스페이스 권한: 워크스페이스 그룹 권한에 conversational_ai_read와 voice_design이 추가되었습니다.

보이스 디자인

  • 음성 미리보기 마이그레이션: POST /v1/text-to-voice/create-previews가 더 이상 사용되지 않습니다. 미리보기를 생성하려면 음성 디자인을 사용한 후, 음성을 생성할 때 반환된 generated_voice_id를 사용하세요.

보이스 체인저

  • WAV 출력 형식: 음성 변환의 output_format 쿼리 매개변수에 wav_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100, wav_48000이 추가되었습니다.

SDK 릴리스

Python SDK

  • v2.47.0 - 2026년 5월 12일 API 스키마에 맞춰 SDK를 재생성했습니다. 이번 릴리스에서는 RAG 청크 나열, 파일 문서 업데이트, 워크스페이스 API 요청 분석, 서비스 계정 API 키 IP 허용 목록, 전화번호 에이전트 구성 필드, 웹훅 요청 헤더, 음성 메타데이터 모더레이션, 새 LLM 옵션 및 업데이트된 음성 변환 출력 형식에 대한 타입 지원을 추가했습니다.

JavaScript SDK

  • v2.47.0 - 2026년 5월 12일 API 스키마에 맞춰 SDK를 재생성했습니다. 이번 릴리스에서는 RAG 청크 나열, 파일 문서 업데이트, 워크스페이스 API 요청 분석, 서비스 계정 API 키 IP 허용 목록, 전화번호 에이전트 구성 필드, 웹훅 요청 헤더, 음성 메타데이터 모더레이션, 새 LLM 옵션 및 업데이트된 음성 변환 출력 형식에 대한 타입 지원을 추가했습니다.

패키지

API

새 엔드포인트

ElevenAgents

  • 대화의 SIP 메시지 가져오기 - GET /v1/convai/conversations/{conversation_id}/sip-messages
    • 필수 경로 매개변수 conversation_id(문자열)가 추가되었습니다.
    • 선택적 쿼리 매개변수 page_size(정수, 기본값 20) 및 cursor가 추가되었습니다.
    • sip_messages, nullable next_cursor, has_more를 포함하는 GetSIPLogMessagesResponse를 반환합니다.
  • 전화번호의 SIP 메시지 가져오기 - GET /v1/convai/phone-numbers/{phone_number_id}/sip-messages
    • 필수 경로 매개변수 phone_number_id(문자열)가 추가되었습니다.
    • 선택적 쿼리 매개변수 page_size(정수, 기본값 20) 및 cursor가 추가되었습니다.
    • GetSIPLogMessagesResponse를 반환합니다.
  • 문서의 RAG 청크 가져오기 - GET /v1/convai/knowledge-base/{documentation_id}/chunks
    • 필수 경로 매개변수 documentation_id(문자열)가 추가되었습니다.
    • 필수 쿼리 매개변수 embedding_model이 추가되었습니다.
    • 선택적 쿼리 매개변수 page_size(정수, 기본값 30) 및 cursor가 추가되었습니다.
    • chunks 및 nullable next_cursor를 포함하는 KnowledgeBaseDocumentChunksResponseModel을 반환합니다.
  • 문서 파일 업데이트 - PATCH /v1/convai/knowledge-base/{documentation_id}/update-file
    • 필수 경로 매개변수 documentation_id(문자열)가 추가되었습니다.
    • 필수 file(문자열, 바이너리)을 포함하는 멀티파트 양식 본문이 추가되었습니다.
    • 업데이트된 지식 베이스 문서 모델을 반환합니다.

워크스페이스

  • POST /v1/workspace/analytics/requests
    • 선택적 start_time, end_time, limit(정수, 기본값 100, 최대값 1000), sort, filters, search를 포함하는 요청 본문이 추가되었습니다.
    • columns, column_types, rows, column_units를 포함하는 WorkspaceAnalyticsQueryResponseModel을 반환합니다.

업데이트된 엔드포인트 및 스키마

ElevenAgents

  • 지식 베이스 문서 업데이트 - PATCH /v1/convai/knowledge-base/{documentation_id}
    • JSON 요청 본문 필드 name(선택적 nullable 문자열) 및 content(선택적 nullable 문자열)가 추가되었습니다.
  • 에이전트 생성 - POST /v1/convai/agents/create
    • enable_versioning의 기본값이 false에서 true로 변경되었습니다.
  • 에이전트 업데이트 - PATCH /v1/convai/agents/{agent_id}
    • enable_versioning_if_not_enabled의 기본값이 false에서 true로 변경되었습니다.
  • 전화번호 업데이트 - PATCH /v1/convai/phone-numbers/{phone_number_id}
    • 전화번호 에이전트 구성에 environment 및 branch_id가 추가되었습니다.
    • 이제 store_sip_messages의 기본값은 true입니다.
  • 위젯 가져오기 - GET /v1/convai/agents/{agent_id}/widget
    • 위젯 파일 업로드용 file_input_config가 추가되었습니다.
  • LLM 열거형
    • gpt-5.4-mini, gpt-5.4-nano, gpt-5.4-mini-2026-03-17, gpt-5.4-nano-2026-03-17이 추가되었습니다.
  • AuthorizationMethod 열거형
    • sms가 추가되었습니다.
  • ConversationInitiationSource 열거형
    • twilio_sms가 추가되었습니다.
  • AgentTopicResponseModel
    • 선택적 nullable parent_topic_id, x_2d, y_2d가 추가되었습니다.
  • BackgroundMusicConfig 및 BackgroundMusicConfigWorkflowOverride
    • source_type, source_id, volume, crossfade_loop가 추가되었습니다.
    • BackgroundMusicPresetId 열거형 값 city, elevator1, elevator2, elevator3, elevator4, office1, office2, restaurant, typing이 추가되었습니다.
  • AgentPlatformSettingsResponseModel
    • Monitor 열거형 값 elevated_conversation_failure_rate 및 elevated_tool_failure_rate를 포함하는 alerting이 추가되었습니다.
  • ProcedureCompilerMode 열거형
    • deterministic이 제거되었습니다.

워크스페이스

  • 서비스 계정 API 키 생성 및 수정 스키마
    • 1~100개 항목의 IP 주소 또는 CIDR 범위로 구성된 선택적 배열 allowed_ips가 추가되었습니다.
    • 생성 요청에서는 모든 IP를 허용하기 위해 null을 전달할 수 있습니다.
    • 수정 요청에서는 clear 또는 no_update를 전달할 수 있으며, 기본값은 no_update입니다.
  • WorkspaceApiKeyResponseModel
    • nullable allowed_ips가 추가되었습니다.
  • WorkspaceGroupPermission 열거형
    • conversational_ai_read 및 voice_design이 추가되었습니다.
  • 인증 연결 스키마
    • 사용자 소유 OAuth2 커스텀 앱 연결용 ApiIntegrationOAuth2CustomAppResponse가 추가되었습니다.

보이스 디자인

  • 음성 미리보기 생성 - POST /v1/text-to-voice/create-previews
    • 더 이상 사용되지 않는 것으로 표시되었습니다.
    • 개발자가 음성 디자인을 사용하도록 설명을 업데이트했습니다.

보이스 체인저

  • 음성을 음성으로 변환 - POST /v1/speech-to-speech/{voice_id}
    • output_format 열거형에 wav_8000, wav_16000, wav_22050, wav_24000, wav_32000, wav_44100, wav_48000이 추가되었습니다.
    • PCM 및 WAV 44.1kHz 형식에는 프로 티어 이상이 필요하다는 내용을 설명에 추가했습니다.