변경 로그

새 엔드포인트

ElevenAgents

• 대화 분류 티켓 엔드포인트 9개를 추가했습니다.
  • 대화 티켓 생성 - POST /v1/convai/triage-tickets. 요청에는 conversation_id(문자열)가 필요하며, qa_comment(nullable 문자열, 1~10,000자) 및 최대 200개의 턴 댓글을 허용합니다.
  • 티켓 나열 - GET /v1/convai/agents/{agent_id}/triage-tickets, 커서 페이지네이션을 지원합니다.
  • 수동 티켓 생성 - POST /v1/convai/agents/{agent_id}/triage-tickets. 요청에는 qa_comment(문자열, 1~10,000자)가 필요합니다.
  • 할당 가능한 사용자 나열 - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users. 응답은 서비스 계정이 아닌 워크스페이스 멤버와 각 멤버의 에이전트 액세스 여부를 나열합니다.
  • 티켓 가져오기 - GET /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • 티켓 업데이트 - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}. 요청은 선택 사항인 status와 nullable assignee_user_id를 허용합니다.
  • 티켓 삭제 - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}.
  • 댓글 추가 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments. 요청에는 comment(문자열, 1~10,000자)가 필요합니다.
  • 턴 댓글 추가 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments. 요청에는 0부터 시작하는 turn_index(정수)와 comment(문자열, 1~10,000자)가 필요합니다.

업데이트된 엔드포인트

ElevenAgents

• 서명된 URL 가져오기 - GET /v1/convai/conversation/get-signed-url
  • 선택 사항인 debug_events_request(불리언, 기본값 false)를 추가했습니다. 디버그 이벤트에는 에이전트 편집자 액세스가 필요합니다.
• WebRTC 토큰 가져오기 - GET /v1/convai/conversation/token
  • 선택 사항인 debug_events_request(불리언, 기본값 false)를 추가했습니다. 레거시 GET /v1/convai/conversation/get_signed_url 경로도 동일한 파라미터를 허용합니다.
• 대화 나열 - GET /v1/convai/conversations
  • 지정된 절차 중 하나가 실행된 대화를 일치시키기 위한 선택 사항인 triggered_procedure_ids(nullable 문자열 배열, 최대 50개)를 추가했습니다.
  • 실행되지 않은 도구 호출을 포함하기 위한 선택 사항인 include_invalid_tool_calls(불리언, 기본값 false)를 추가했습니다.
  • 통화 시작 시간에 대한 선택 사항인 sort_direction(asc 또는 desc, 기본값 desc)을 추가했습니다.
• 대화 메시지 텍스트 검색 - GET /v1/convai/conversations/messages/text-search
  • 선택 사항인 triggered_procedure_ids(nullable 문자열 배열, 최대 50개)를 추가했습니다.
  • 선택 사항인 include_invalid_tool_calls(불리언, 기본값 false)를 추가했습니다.
• 에이전트 대화 주제 가져오기 - GET /v1/convai/agents/{agent_id}/topics
  • 선택 사항인 include_evaluation_criteria(불리언, 기본값 true)를 추가했습니다.
  • sort_by에 frustration을 추가했습니다.
  • 주제 응답에 nullable success_rate(숫자)를 추가하고, 전체 응답에는 aggregated_run_count(정수, 기본값 0)를 추가했습니다.
  • from_unix_secs는 UTC 날짜 시작 시점으로 내림 처리됩니다. 범위가 지정되면 완료된 일별 탐색 실행을 집계하며, 두 경계를 모두 생략하면 최신 실행을 반환합니다.
• 절차 나열 (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) 및 절차 가져오기 (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})
  • 특정 에이전트 버전에서 절차를 가져오기 위한 선택 사항 nullable agent_version_id(문자열)를 추가했습니다.
• 테스트 생성 및 테스트 업데이트
  • 응답, 시뮬레이션 및 도구 호출 단위 테스트 스키마에 선택 사항 nullable environment(문자열)를 추가했습니다. 이 값은 환경별 URL, 헤더 및 인증 연결을 선택하며, 기본값은 production입니다.
• URL 문서 생성, 크롤 작업 생성 및 폴더 생성
  • 자동 동기화를 위한 선택 사항 nullable minimum_frequency_days(정수, 1~180)를 추가했습니다. 기본값은 7이며, 더 엄격한 상위 폴더 빈도가 우선합니다.

음악

• 음악 Finetune 나열 - GET /v1/music/finetunes
  • 최대 page_size를 100에서 150으로 늘렸습니다. 기본값은 50으로 유지됩니다.

스키마 변경 사항

ElevenAgents

• 에이전트 업데이트 요청에 선택 사항 nullable procedures(object<string, ProcedureVersionRef>)를 추가했습니다. 각 값에는 procedure_id와 version_id(문자열)가 필요합니다. 빈 객체는 모든 절차를 제거합니다.
• 대화 시작 구성에 enable_procedure_ids_from_client(불리언, 기본값 false)를 추가했습니다. 시작 데이터에 선택 사항 nullable procedure_ids(문자열 배열)를 추가했으며, 빈 배열은 시작 에이전트의 모든 절차를 비활성화합니다.
• ClientEvent에 context_usage를 추가했습니다.
• 소프트 타임아웃 재정의에 선택 사항 nullable additional_soft_timeout_messages(문자열 배열)를 추가했습니다.
• 분석 및 스키마 재정의 모델의 상수 값이 이제 null을 허용합니다.
• mic_muting_enabled 및 transcript_enabled의 위젯 구성 기본값이 false에서 true로 변경되었습니다. 이전 동작을 유지하려면 명시적으로 false로 설정하세요.

워크스페이스

• 사용자 가져오기 응답에서 UserResponseModel의 xi_api_key를 제거했습니다.
• 이제 ResourceMetadataResponseModel.role_to_group_ids는 키를 admin, editor, commenter, viewer로 제한하지 않고 사용자 지정 역할 ID를 키로 허용합니다.
• 직접 게시 응답에 선택 사항 nullable restricted_to_user_email_domains(문자열 배열)를 추가했습니다.
• 보류 중인 구독 전환 응답의 next_tier에 go를 추가했습니다.