변경 로그

새 엔드포인트

ElevenAgents

• POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
  • 프로시저를 생성하고 procedure_id(문자열)를 반환합니다.
  • 선택적 name(문자열, 최대 200자), content(문자열), type(ProcedureType, 기본값 free_form), trigger(nullable 문자열)를 받습니다.
• GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
  • procedure_id, version_id, name, type, trigger, has_draft와 함께 브랜치 프로시저를 나열합니다.
  • 프로시저 콘텐츠는 제외됩니다. 콘텐츠를 읽으려면 개별 프로시저를 조회하세요.
• GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
  • 선택적 version_id(문자열)를 받으며, 그렇지 않으면 브랜치 헤드의 버전을 반환합니다.
  • name, content, type, trigger를 반환합니다.
• DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
  • 브랜치의 초안 작업 세트에서 프로시저를 제거합니다.
• GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
  • 현재 프로시저 초안을 반환합니다.
• PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
  • 초안을 생성하거나 업데이트합니다.
  • name(문자열, 최대 200자), content(문자열, 최대 50,000자), type(ProcedureType)이 필요하며, 선택적 trigger(nullable 문자열)를 받습니다.
• DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
  • 초안 변경 사항을 폐기하고 프로시저를 커밋된 버전으로 재설정합니다.
• POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
  • 프로시저 초안을 AgentWorkflowResponseModel로 컴파일합니다.
• 크롤 작업 생성 - POST /v1/convai/knowledge-base/crawl
  • url(문자열)이 필요합니다.
  • 선택적 max_depth(정수, 15, 기본값 3), max_pages(정수, 110,000, 기본값 1000), pattern(문자열), sitemap_urls(문자열 배열), parent_folder_id(문자열), enable_auto_sync(불리언, 기본값 false), auto_remove(불리언, 기본값 false)를 받습니다.
• 크롤 작업 목록 - GET /v1/convai/knowledge-base/crawl
  • 선택적 include_job_ids(문자열 배열), page_size(정수, 1~100, 기본값 30), cursor(문자열)를 받습니다.
• 크롤 작업 가져오기 - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
• 크롤 작업 취소 - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
• 여러 문서의 종속 에이전트 가져오기 - POST /v1/convai/knowledge-base/dependent-agents
  • document_ids(고유 문자열 1~20개 배열)가 필요합니다.
  • 선택적 dependent_type(KnowledgeBaseDependentType, 기본값 all), page_size(정수, 1~100, 기본값 30), cursor(문자열)를 받습니다.
• 지식 베이스 문서 대량 삭제 - POST /v1/convai/knowledge-base/bulk-delete
  • document_ids(고유 문자열 1~20개 배열)가 필요합니다.
  • 선택적 force(불리언, 기본값 false)를 받습니다.
  • 각 문서 ID에 대한 성공 또는 실패 결과를 반환합니다.
• 일괄 통화 결과 내보내기 - GET /v1/convai/batch-calling/{batch_id}/export
  • 완료된 일괄 작업의 수신자와 대화 결과를 CSV로 반환합니다.

Voices

• GET /v1/voices/accents
  • 공유 보이스 라이브러리에서 사용할 수 있는 억양을 나열합니다.
  • 선택적 language(문자열) 및 model_id(문자열) 쿼리 매개변수를 받습니다.
  • 각 억양은 accent, language, code, name을 반환합니다.

업데이트된 엔드포인트

ElevenAgents

• 대화 목록 - GET /v1/convai/conversations
  • 각각 최대 50개 값으로 제한되는 선택적 visited_agent_ids 및 visited_agent_branch_ids 문자열 배열 필터를 추가했습니다.
  • 각 요약의 분석 결과를 선택하기 위한 선택적 data_collection_ids 및 evaluation_criteria_ids 문자열 배열을 추가했습니다.
  • 응답 요약에 선택적 객체 필드 data_collection_results, evaluation_criteria_results와 문자열 배열 tag_ids를 추가했습니다.
• 대화 메시지 텍스트 검색 - GET /v1/convai/conversations/messages/text-search
  • 각각 최대 50개 값으로 제한되는 선택적 visited_agent_ids 및 visited_agent_branch_ids 문자열 배열 필터를 추가했습니다.
• WebRTC 토큰 가져오기 - GET /v1/convai/conversation/token
  • 이제 응답에 conversation_id(문자열)가 필요합니다.
  • 호환성 깨짐: 엄격한 응답 검증기와 역직렬화기는 새 필수 필드를 허용해야 합니다.

스키마 변경 사항

ElevenAgents

• 에이전트 플랫폼 요청 및 응답 설정에 참조 평가 및 데이터 수집 구성을 위한 AgentAnalysisItems 타입의 선택적 nullable analysis_items 필드를 추가했습니다.
• 프로시저 참조에 trigger(문자열), referenced_tool_ids(문자열 배열), referenced_kb_ids(문자열 배열), referenced_procedure_ids(문자열 배열), referenced_dynamic_variables(문자열 배열)를 추가했습니다.
• KnowledgeBaseRagToolResultModel에 chunks(KnowledgeBaseRagChunkModel[])를 추가했습니다.

Studio

• ProjectCreationMetaResponseModel.status에 draft를 추가했습니다.
• 이제 ProjectCreationMetaResponseModel.type이 공유 ProjectCreationMetaType enum을 참조합니다.

Workspaces

• WebhookUsageType에 Flows를 추가했습니다.