ElevenAgents

  • 대화 사용자 엔드포인트: 에이전트와 대화한 사용자를 나열하는 대화 사용자 조회 엔드포인트(GET /v1/convai/users)를 추가했습니다. 페이지네이션과 에이전트, 기간 및 기타 기준별 필터링을 지원합니다.
  • 에이전트 버전 관리: 에이전트 조회 엔드포인트의 새 version_id 및 branch_id 쿼리 매개변수를 사용해 버전별 에이전트 구성을 가져올 수 있습니다. 이제 에이전트 업데이트 엔드포인트에서도 브랜치별 업데이트를 위한 branch_id 매개변수를 지원합니다.
  • 문서 검색 도구: RAG(검색 증강 생성)를 위한 새 내장 시스템 도구로 search_documentation을 추가했습니다. MultiSourceConfigJson, SourceConfigJson, SourceRetrievalConfig 스키마를 사용해 다중 소스 검색을 구성할 수 있습니다. MergingStrategy 열거형을 통해 구성 가능한 병합 전략을 지원합니다.
  • MCP 도구 지원: 웹훅, 클라이언트, 시스템 도구와 함께 새 도구 유형으로 mcp를 추가했습니다. 에이전트 도구 정의에서 새 MCPToolConfig 스키마를 사용해 MCP 도구를 구성할 수 있습니다.
  • 콘텐츠 가드레일: GuardrailsV1에 콘텐츠 조정 가드레일을 추가했습니다. 성적 콘텐츠, 폭력, 괴롭힘, 자해, 욕설, 종교/정치 및 의료/법률 콘텐츠 등 다양한 콘텐츠 카테고리에 대해 임계값을 구성할 수 있습니다. 새 ContentGuardrail 및 ContentConfig 스키마를 사용하세요.
  • 표현 모드: 에이전트가 새 v3 대화형 모델을 최대한 활용하도록 자동으로 프롬프트하는 expressive_mode 필드(불리언)를 에이전트 구성 스키마에 추가했습니다.
  • 통화 연결 후 숫자 입력: 이제 전화번호 전송에서 연결 후 DTMF 톤을 전송하는 post_dial_digits를 지원합니다. 정적 값 또는 동적 변수로 구성할 수 있습니다.
  • 에이전트 테스트 유형: 이제 에이전트 테스트는 전용 스키마를 갖춘 세 가지 고유한 테스트 유형을 지원합니다. llm(응답 평가), tool(도구 호출 검증), simulation(전체 대화 시뮬레이션)입니다. 시뮬레이션 테스트에는 simulation_scenario 및 simulation_max_turns 구성 필드가 포함됩니다.

발음 사전

  • API 응답의 규칙: 이제 발음 사전 조회 엔드포인트가 전체 규칙 세부 정보를 포함하는 rules 배열을 반환합니다. 응답은 새 GetPronunciationDictionaryWithRulesResponseModel 스키마를 사용하며, 규칙 유형에는 PronunciationDictionaryAliasRuleResponseModel 및 PronunciationDictionaryPhonemeRuleResponseModel을 사용합니다.

지식 베이스

  • 폴더 삭제: 이제 지식 베이스 문서 삭제 엔드포인트에서 문서뿐 아니라 폴더도 삭제할 수 있습니다. 폴더를 삭제할 때는 force=true를 설정하여 포함된 모든 문서와 하위 폴더를 재귀적으로 삭제할 수 있습니다.

SDK 릴리스

Python SDK

  • v2.36.0 - 대화 사용자 엔드포인트, 에이전트 버전 관리, 문서 검색 도구, MCP 도구 지원, 콘텐츠 가드레일 및 에이전트 테스트 유형을 추가했습니다.

JavaScript SDK

  • v2.36.0 - 요청 매개변수에 따른 유형 추론을 개선하기 위해 speechToText.convert()에 오버로드된 convert 시그니처를 추가했습니다(수동 유형 축소 없이 .text, .transcripts 또는 웹훅 필드에 접근 가능). 또한 대화 사용자 엔드포인트, 에이전트 버전 관리, 문서 검색 도구, MCP 도구 지원, 콘텐츠 가드레일 및 에이전트 테스트 유형을 추가했습니다.

위젯 패키지

  • @elevenlabs/convai-widget-core@0.9.0 - 에이전트 도구 사용 상태 표시 및 장시간 실행되는 도구 호출을 위한 새 상태 배지를 추가했고, 감정 태그 제거 문제와 서명 URL 위젯 임베딩의 평가 및 피드백 제출 문제를 수정했습니다.
  • @elevenlabs/convai-widget-embed@0.9.0 - 에이전트 도구 사용 상태 표시 및 장시간 실행되는 도구 호출을 위한 새 상태 배지를 추가했고, 감정 태그 제거 문제를 수정했습니다.

API

새 엔드포인트

업데이트된 엔드포인트

ElevenAgents

  • 에이전트 조회
    • 특정 에이전트 버전을 가져오기 위한 version_id 쿼리 매개변수(문자열, 선택 사항)를 추가했습니다.
    • 특정 브랜치에서 가져오기 위한 branch_id 쿼리 매개변수(문자열, 선택 사항)를 추가했습니다.
  • 에이전트 업데이트
    • 브랜치별 업데이트를 위한 branch_id 쿼리 매개변수(문자열, 선택 사항)를 추가했습니다.
  • 에이전트 생성
    • 다중 소스 RAG 구성과 함께 시스템 도구에 search_documentation을 추가했습니다.
    • 도구 구분자에 mcp 도구 유형을 추가했습니다.
    • 콘텐츠 조정 가드레일을 위한 content 필드를 GuardrailsV1에 추가했습니다.
    • 에이전트 구성에 expressive_mode 필드(불리언)를 추가했습니다.
  • 에이전트 테스트 생성, 에이전트 테스트 업데이트, 에이전트 테스트 조회
    • type 필드(llm, tool, simulation)를 사용하는 판별된 유니온 스키마로 변경했습니다.
    • 시뮬레이션 테스트용 simulation_scenario 및 simulation_max_turns 필드를 추가했습니다.

발음 사전

  • 발음 사전 조회
    • 응답 스키마를 rules 배열이 있는 GetPronunciationDictionaryWithRulesResponseModel로 변경했습니다.

지식 베이스

스키마 변경 사항

새 스키마

  • GetPronunciationDictionaryWithRulesResponseModel - 내장된 규칙 배열이 있는 응답 모델
  • PronunciationDictionaryAliasRuleResponseModel - string_to_replace 및 alias가 있는 별칭 규칙
  • PronunciationDictionaryPhonemeRuleResponseModel - string_to_replace, phoneme, alphabet이 있는 음소 규칙
  • MultiSourceConfigJson - 다중 소스 RAG 구성
  • SourceConfigJson - RAG용 개별 소스 구성
  • SourceRetrievalConfig - RAG 소스용 검색 구성
  • MergingStrategy - RAG 결과 병합 전략용 열거형
  • MCPToolConfig - MCP 도구 구성
  • ContentGuardrail-Input, ContentGuardrail-Output - 콘텐츠 조정 가드레일 구성
  • ContentConfig - 콘텐츠 카테고리 임계값 구성
  • TestType - llm, tool, simulation 값을 가진 열거형
  • CreateAgentTestResponseModel - 테스트 생성 응답
  • LLMResponseTest*, ToolCallTest*, SimulationTest* - 기존 Create/Get/UpdateUnitTest* 모델을 대체하는 유형별 테스트 스키마

수정된 스키마

  • GuardrailsV1-Input, GuardrailsV1-Output - 콘텐츠 가드레일용 content 필드를 추가했습니다.
  • AgentConfig - expressive_mode 필드(불리언)를 추가했습니다.
  • PhoneNumberTransferConfig - post_dial_digits 필드(문자열 또는 동적 변수)를 추가했습니다.
  • DistributionTerritories - 임의의 지역 문자열을 허용하도록 항목 제약을 완화했습니다.