변경 로그

January 26, 2026

에이전트 플랫폼

  • 에이전트 브랜칭 및 배포: 팀이 브랜치를 생성하고, 분리된 환경에서 에이전트 구성을 반복 개선하며, 준비되면 변경 사항을 병합할 수 있는 완전한 버전 관리 시스템을 에이전트에 추가했습니다. 새 엔드포인트에는 브랜치 생성을 위한 POST /v1/convai/agents/{agent_id}/branches, 병합을 위한 POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge, 배포 생성을 위한 POST /v1/convai/agents/{agent_id}/deployments가 포함됩니다. 새 초안 엔드포인트를 통해 초안을 생성하고 삭제할 수도 있습니다. 자세한 내용은 브랜치 및 배포 문서를 참조하세요.
  • WhatsApp 계정 관리: WhatsApp Business 계정용 PATCH 및 DELETE 엔드포인트를 추가하여 에이전트에서 연결된 WhatsApp 계정을 업데이트하고 제거할 수 있습니다.
  • 대화 에이전트 이름: 이제 대화 가져오기 엔드포인트 응답에 agent_name이 반환되어 어떤 에이전트가 대화를 처리했는지 더 쉽게 식별할 수 있습니다.
  • 오류 유형 추적: 디버깅 및 오류 분류를 개선하기 위해 대화 이벤트 모델에 error_type 필드를 추가했습니다.

지식 베이스

  • 폴더 관리: 지식 베이스 문서를 폴더로 정리하는 기능을 추가했습니다. 새 엔드포인트에는 폴더 생성을 위한 폴더 생성, 개별 문서 이동을 위한 문서 이동, 여러 문서를 한 번에 이동하는 일괄 이동이 포함됩니다.

도구

  • 향상된 도구 목록: 이제 도구 가져오기 엔드포인트에서 search, page_size, types, sort_by, sort_direction, cursor를 포함한 새 쿼리 매개변수로 필터링과 페이지네이션을 지원합니다. 이제 응답에 페이지네이션을 위한 next_cursor 및 has_more 필드가 포함됩니다.

음악

  • 곡 메타데이터 개선: 더 풍부한 오디오 분석 정보를 위해 곡 메타데이터에 bpm 및 time_signature 필드를 추가했습니다.

ElevenCreative Studio

  • 자막 스타일 템플릿: 템플릿별 자막 스타일 사용자 지정을 지원하도록 프로젝트 모델에 caption_style_template_overrides 필드를 추가했습니다.
  • 비디오 더빙 프로젝트 유형: 프로젝트 생성 유형 열거형에 dub_video를 추가했습니다.
  • 게시 메타데이터: 게시 및 프로젝트 메타데이터에 last_updated_from_project_unix 타임스탬프를 추가했습니다.

워크스페이스

  • 시트 유형 관리: 새 SeatType 열거형과 seat_type, workspace_seat_type 필드를 도입하고, 기존 workspace_permission 및 workspace_role 필드는 더 이상 사용하지 않도록 했습니다.
  • 워크스페이스 분석 권한: 세분화된 분석 액세스 제어를 위해 PermissionType 열거형에 workspace_analytics_full_read를 추가했습니다.

SDK 릴리스

Python SDK

  • v2.32.0 - 에이전트 브랜칭, 배포 및 초안 엔드포인트, 지식 베이스 폴더 관리, 필터링 및 페이지네이션이 포함된 향상된 도구 목록, 시트 유형 관리를 추가했습니다.

JavaScript SDK

  • v2.33.0 - 에이전트 브랜칭, 배포 및 초안 엔드포인트, 지식 베이스 폴더 관리, 필터링 및 페이지네이션이 포함된 향상된 도구 목록, 시트 유형 관리를 추가했습니다.

API

새 엔드포인트

  • 에이전트 브랜치 목록 - GET /v1/convai/agents/{agent_id}/branches - 에이전트의 모든 브랜치 나열
  • 에이전트 브랜치 생성 - POST /v1/convai/agents/{agent_id}/branches - 에이전트의 새 브랜치 생성
  • 에이전트 브랜치 가져오기 - GET /v1/convai/agents/{agent_id}/branches/{branch_id} - 특정 브랜치 가져오기
  • 에이전트 브랜치 업데이트 - PATCH /v1/convai/agents/{agent_id}/branches/{branch_id} - 브랜치 구성 업데이트
  • 에이전트 브랜치 병합 - POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge - 브랜치를 대상 브랜치로 병합
  • 배포 생성 - POST /v1/convai/agents/{agent_id}/deployments - 에이전트 배포 생성 또는 업데이트
  • 초안 생성 - POST /v1/convai/agents/{agent_id}/drafts - 에이전트 초안 생성
  • 초안 삭제 - DELETE /v1/convai/agents/{agent_id}/drafts - 에이전트 초안 삭제
  • 폴더 생성 - POST /v1/convai/knowledge-base/folder - 문서 그룹화를 위한 폴더 생성
  • 문서 이동 - POST /v1/convai/knowledge-base/{document_id}/move - 문서를 폴더로 이동
  • 일괄 이동 - POST /v1/convai/knowledge-base/bulk-move - 여러 문서를 폴더로 이동

업데이트된 엔드포인트

에이전트 플랫폼

  • 도구 가져오기
    • 이름 접두사로 도구를 필터링하는 search 쿼리 매개변수(문자열, 선택 사항)를 추가했습니다.
    • page_size 쿼리 매개변수(정수, 선택 사항, 최대 100, 기본값 30)를 추가했습니다.
    • show_only_owned_documents 쿼리 매개변수(부울, 선택 사항, 기본값 false)를 추가했습니다.
    • 도구 유형별 필터링을 위한 types 쿼리 매개변수(배열, 선택 사항)를 추가했습니다.
    • 결과 정렬을 위한 sort_by 쿼리 매개변수(열거형, 선택 사항)를 추가했습니다.
    • 정렬 순서를 위한 sort_direction 쿼리 매개변수(열거형, 선택 사항)를 추가했습니다.
    • 페이지네이션을 위한 cursor 쿼리 매개변수(문자열, 선택 사항)를 추가했습니다.
    • 이제 응답에 next_cursor(문자열) 및 has_more(부울, 필수) 필드가 포함됩니다.
  • 에이전트 생성
    • 브랜칭 지원으로 요청 스키마가 업데이트되었습니다.
  • 대화 가져오기
    • 응답 모델에 agent_name(문자열, 선택 사항)을 추가했습니다.
  • 에이전트 초안 생성
    • tags 필드를 선택 사항으로 변경하고 필수 필드에서 제거했습니다.

발음 사전

  • 규칙 추가
    • 중복된 string_to_replace 값을 가진 규칙은 대체된다는 점을 명확히 하도록 설명을 업데이트했습니다.

워크스페이스

ElevenCreative Studio

스키마 변경 사항

새 스키마

  • AgentBranch, AgentBranchInput, AgentBranchOutput - 에이전트용 브랜치 구성
  • AgentDeployment, AgentDeploymentInput - 에이전트용 배포 구성
  • AgentVersion - 에이전트 버전 정보
  • BranchProtectionStatus - 브랜치 보호 설정
  • SeatType - 워크스페이스 시트 유형을 위한 열거형
  • ToolSortBy - 도구 정렬 옵션을 위한 열거형
  • ToolTypeFilter - 유형별 도구 필터링을 위한 열거형
  • CaptionStyleModel - 자막 스타일 구성

수정된 스키마

  • ToolsResponseModel - 페이지네이션을 위한 next_cursor 및 has_more 필드를 추가했습니다.
  • SongMetadata - bpm(숫자) 및 time_signature(문자열) 필드를 추가했습니다.
  • GetConversationResponseModel - agent_name 필드를 추가했습니다.
  • PermissionType - workspace_analytics_full_read 열거형 값을 추가했습니다.
  • ProjectCreationType - dub_video 열거형 값을 추가했습니다.
  • 여러 이벤트 모델 - 오류 분류를 위한 error_type 필드를 추가했습니다.