ElevenAgents
-
환경 변수 API: 에이전트가 런타임에
{{system_env__<label>}}템플릿을 통해 참조할 수 있는 워크스페이스 수준 구성을 관리하는 새로운 환경 변수 엔드포인트입니다. 환경별 값 재정의를 지원하며, 문자열, 시크릿, 인증 연결 변수 유형을 지원합니다. 엔드포인트에는 생성, 목록, 조회, 업데이트가 포함됩니다. -
인증 연결 관리: 에이전트 도구와 통합에 사용되는 인증 자격 증명을 관리하는 새로운 워크스페이스 수준 인증 연결 API입니다. OAuth2 클라이언트 자격 증명, JWT, 기본 인증, 베어러 토큰, 사용자 지정 헤더, 통합 관리형 OAuth2 인증 코드 흐름 등 다양한 인증 방식을 지원합니다. 생성, 목록 조회, 삭제 작업을 제공합니다.
-
지식 베이스 URL 새로고침: URL 기반 지식 베이스 문서의 콘텐츠를 다시 가져오고 업데이트하는 새로운 새로고침 엔드포인트(
POST /v1/convai/knowledge-base/{documentation_id}/refresh)입니다. 이제 지식 베이스 문서는enable_auto_sync,auto_remove,auto_sync_info필드를 통한 자동 동기화 구성도 지원합니다. -
피드백을 통한 가드레일 재시도: 이제 사용자 지정 및 콘텐츠 가드레일에서
EndCallTriggerAction및RetryTriggerAction옵션을 사용해 구성 가능한 트리거 작업을 지원합니다. 재시도로 설정하면 에이전트는 시스템 피드백을 주입하여 최대 3회까지 응답을 다시 생성합니다. 상황별 재시도 안내를 위해{{trigger_reason}}및{{agent_message}}플레이스홀더를 사용할 수 있습니다. -
대화 기록 시스템 변수: 런타임에 지연 평가되는 JSON 직렬화 대화 기록을 제공하는 새로운
system__conversation_history동적 변수가 추가되었습니다. 전체 대화 컨텍스트를 도구, 웹훅 또는 하위 에이전트 인계에 전달할 때 유용합니다. -
웹훅 도구 콘텐츠 유형: 이제 서버 도구에서 웹훅 본문 매개변수에 구성 가능한 콘텐츠 유형을 지원하여
application/json및application/x-www-form-urlencoded형식 중 선택할 수 있습니다. URL 인코딩 형식은 레거시 시스템, OAuth 토큰 엔드포인트, 결제 처리업체와 통합할 때 유용합니다. -
WhatsApp 발신 메시지: 대시보드에 새로운 발신 메시지 대화 상자가 추가되어, 에이전트가 WhatsApp 채널을 통해 통화뿐 아니라 발신 메시지도 보낼 수 있도록 WhatsApp 통합이 업데이트되었습니다.
-
에이전트 및 리소스 목록 필터: 이제 에이전트 목록, 지식 베이스 문서 목록, 도구 목록 엔드포인트에서
created_by_user_id쿼리 매개변수(현재 사용자는@me사용)를 지원합니다. 기존show_only_owned_agents및show_only_owned_documents매개변수는 더 이상 사용되지 않습니다. -
워크플로 조건식: 워크플로 표현식 스키마에 새로운
conditional_operatorAST 노드가 추가되어 에이전트 워크플로 정의 내 분기 로직을 사용할 수 있습니다.
음악
- 음악 마켓플레이스: 사용 유형, 크리에이터 지급금, 라이선스 세부 정보를 포함해 AI 생성 음악 라이선싱을 위한 마켓플레이스를 다루는 새로운 음악 마켓플레이스 문서가 추가되었습니다.
SDK 릴리스
Python SDK
- v2.40.0 - ElevenAgents 대화에
environment매개변수 지원이 추가되어 환경별 에이전트 연결을 사용할 수 있습니다. 환경 변수, 인증 연결, 지식 베이스 새로고침, 가드레일 트리거 작업을 포함한 최신 API 스키마에 맞춰 Fern을 재생성했습니다.
JavaScript SDK
- v2.40.0 - ElevenAgents 실시간 대화를 위한
multimodal_messageWebSocket 이벤트 유형이 추가되었습니다. 환경 변수, 인증 연결, 지식 베이스 새로고침, 가드레일 트리거 작업을 포함한 최신 API 스키마에 맞춰 Fern을 재생성했습니다.
iOS SDK
- v3.1.1 - 환경별 에이전트 연결을 위한
environment매개변수 지원이 추가되었습니다. 플랫폼 요구 사항을 v2로 높여 visionOS 빌드 오류를 수정했습니다.
패키지
- @elevenlabs/types@0.6.1 - ElevenAgents 실시간 대화를 위한
multimodal_messageWebSocket 이벤트 유형이 추가되었습니다. - @elevenlabs/client@0.15.2 -
multimodal_messageWebSocket 이벤트 지원이 추가되었습니다. - @elevenlabs/react@0.14.3 -
multimodal_messageWebSocket 이벤트 지원이 추가되었습니다. - @elevenlabs/convai-widget-core@0.10.4, @elevenlabs/convai-widget-core@0.10.5 -
@elevenlabs/client@0.15.2로 업데이트되었습니다. - @elevenlabs/convai-widget-embed@0.10.4, @elevenlabs/convai-widget-embed@0.10.5 -
@elevenlabs/client@0.15.2로 업데이트되었습니다.
패키지 v1.0.0 릴리스 후보
ElevenAgents 클라이언트 SDK v1.0.0의 첫 번째 릴리스 후보를 이제 사용할 수 있습니다. 이 메이저 릴리스에는 API 표면을 개선하고, 더 나은 렌더링 성능을 위한 세분화된 React 훅을 추가하며, React Native SDK를 React SDK와 통합하는 주요 변경 사항이 포함됩니다.
릴리스 후보를 사용해 보려면 다음을 실행하세요.
AI 코딩 어시스턴트가 코드베이스를 새 API로 자동 마이그레이션할 수 있도록 돕는 elevenlabs:sdk-migration 스킬을 사용할 수 있습니다. 안내형 마이그레이션 지원을 받으려면 Claude Code, Cursor 또는 Windsurf 프로젝트에 추가하세요.
v1.0.0의 주요 변경 사항:
@elevenlabs/client: 이제Conversation은 클래스 대신 네임스페이스 객체이자TextConversation | VoiceConversation의 타입 별칭입니다.Input및Output클래스는InputController및OutputController인터페이스로 대체되었으며, 대화 인스턴스에 새로운 편의 메서드(setMicMuted(),setVolume(),getInputByteFrequencyData(),getOutputByteFrequencyData())가 추가되었습니다. 이제changeInputDevice()및changeOutputDevice()는void를 반환합니다.@elevenlabs/react: 이제useConversation에는 상위ConversationProvider가 필요합니다. 세밀한 리렌더링을 위한 새로운 세분화 훅은useConversationControls(),useConversationStatus(),useConversationInput(),useConversationMode(),useConversationFeedback()입니다. 완전한 타입 안전성을 갖추고 React 컴포넌트에서 클라이언트 도구를 동적으로 등록할 수 있는 새로운useConversationClientTool()훅도 추가되었습니다.@elevenlabs/react-native:ElevenLabsProvider및useConversation을ConversationProvider와@elevenlabs/react의 동일한 세분화 훅으로 대체하는 전체 API 재작성입니다. WebRTC 폴리필과 네이티브 AudioSession 구성은 가져올 때 자동으로 적용됩니다.
전체 릴리스 노트와 마이그레이션 가이드 보기:
- @elevenlabs/client@1.0.0-rc.1
- @elevenlabs/react@1.0.0-rc.1
- @elevenlabs/react-native@1.0.0-rc.1
- @elevenlabs/types@0.7.0-rc.0
API
API 변경 사항 보기
새 엔드포인트
ElevenAgents
- 환경 변수 생성 -
POST /v1/convai/environment-variables- 문자열, 시크릿 또는 인증 연결 유형의 새 환경 변수를 생성합니다. - 환경 변수 목록 -
GET /v1/convai/environment-variables- 워크스페이스의 모든 환경 변수를 나열합니다. - 환경 변수 조회 -
GET /v1/convai/environment-variables/{env_var_id}- 특정 환경 변수를 조회합니다. - 환경 변수 업데이트 -
PATCH /v1/convai/environment-variables/{env_var_id}-null을 통한 환경별 값 제거를 포함해 환경 변수를 업데이트합니다. - URL 문서 콘텐츠 새로고침 -
POST /v1/convai/knowledge-base/{documentation_id}/refresh- URL 기반 지식 베이스 문서의 콘텐츠를 다시 가져옵니다.
워크스페이스
POST /v1/workspace/auth-connections- OAuth2, JWT, 기본 인증, 베어러, 사용자 지정 헤더 및 통합 관리형 인증 방식을 지원하는 워크스페이스 인증 연결을 생성합니다.GET /v1/workspace/auth-connections- 종속성 정보(도구, MCP 서버, 통합 연결)와 함께 모든 워크스페이스 인증 연결을 나열합니다.DELETE /v1/workspace/auth-connections/{auth_connection_id}- 워크스페이스 인증 연결을 삭제합니다.
음성-텍스트 변환
GET /v1/speech-to-text/evaluation/eval-criteria- 평가 기준을 나열합니다.POST /v1/speech-to-text/evaluation/eval-criteria- 평가 기준을 생성합니다.GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}- 특정 평가 기준을 조회합니다.PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}- 평가 기준을 업데이트합니다.DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}- 평가 기준을 삭제합니다.POST /v1/speech-to-text/evaluation/evaluations- 평가를 실행합니다.GET /v1/speech-to-text/evaluation/evaluations- 평가를 나열합니다.GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id}- 특정 평가를 조회합니다.GET /v1/speech-to-text/evaluation/human-agents- 사람 에이전트를 나열합니다.GET /v1/speech-to-text/evaluation/human-agents/{agent_id}- 사람 에이전트를 조회합니다.DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id}- 사람 에이전트를 삭제합니다.GET /v1/speech-to-text/evaluation/analytics- 평가 분석을 조회합니다.GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics- 특정 기준의 분석을 조회합니다.GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics- 특정 사람 에이전트의 분석을 조회합니다.
업데이트된 엔드포인트
ElevenAgents
-
- 환경별 확인을 위한
environment쿼리 매개변수(문자열, 선택 사항)가 추가되었습니다.
- 환경별 확인을 위한
-
created_by_user_id쿼리 매개변수(문자열, 선택 사항,@me지원)가 추가되었습니다.created_by_user_id를 위해show_only_owned_agents는 더 이상 사용되지 않습니다.
-
created_by_user_id쿼리 매개변수(문자열, 선택 사항,@me지원)가 추가되었습니다.created_by_user_id를 위해show_only_owned_documents는 더 이상 사용되지 않습니다.
-
created_by_user_id쿼리 매개변수(문자열, 선택 사항,@me지원)가 추가되었습니다.created_by_user_id를 위해show_only_owned_documents는 더 이상 사용되지 않습니다.
-
- 청크 검색에 사용할 임베딩 모델을 지정하는
embedding_model쿼리 매개변수(문자열, 선택 사항)가 추가되었습니다.
- 청크 검색에 사용할 임베딩 모델을 지정하는
-
EndCallTriggerAction및RetryTriggerAction스키마를 포함한guardrail_trigger_action지원이 추가되었습니다.- 워크플로 표현식 정의에
conditional_operatorAST 노드가 추가되었습니다. - 이제 에이전트 스키마에서 도구 구성의 환경 변수를 참조하는
ConvAIEnvVarLocator및EnvironmentAuthConnectionLocator를 지원합니다.
-
- 새 환경 관련 필드를 수용하도록 요청 스키마가 업데이트되었습니다.
-
- 요청 스키마에
simulation_environment필드가 추가되었습니다.
- 요청 스키마에
스키마 변경 사항
새 스키마
ConvAIEnvironmentVariable,ConvAIEnvironmentVariableCreate,ConvAIEnvironmentVariableUpdate- 문자열, 시크릿 및 인증 연결 유형을 지원하는 환경 변수 모델ConvAIEnvVarLocator,EnvironmentAuthConnectionLocator- 도구 및 MCP 서버 구성에서 환경 변수를 참조하기 위한 로케이터EndCallTriggerAction,RetryTriggerAction- 통화 종료 및 피드백을 통한 재시도 동작을 위한 가드레일 트리거 작업 스키마ConditionalOperator- 에이전트 워크플로의 조건식용 새 AST 노드AuthConnectionCreateRequest,AuthConnectionResponse,AuthConnectionDependencies- OAuth2, JWT, 기본 인증, 베어러, 사용자 지정 헤더, WhatsApp 및 통합 관리형 인증 방식을 지원하는 워크스페이스 인증 연결 관리 스키마SpeechToTextEvaluation*- 음성-텍스트 변환 평가 기준, 평가, 사람 에이전트 및 분석을 위한 스키마 모음
수정된 스키마
MCPServerConfig,MCPServerConfigOutput- 서버 구성에서ConvAIEnvVarLocator참조 지원이 추가되었습니다.CustomGuardrailConfig- 통화 종료 또는 재시도 동작을 구성하는trigger_action필드가 추가되었습니다.Contributor- 선택 사항인bio(문자열) 및profile_id(문자열) 필드가 추가되었습니다.ASTLLMNode-value_schema필드가 추가되었으며,prompt필드는value_schema를 위해 더 이상 사용되지 않습니다.TelephonyDirection- 여러 대화 및 전화 통신 모델에서 참조하는 공유 열거형으로 리팩터링되었습니다.