Procedure API와 지식 기반 관리 확장
Procedure API, 지식 기반 크롤링·대량 관리, 음성 악센트 조회가 추가되고 일부 응답 스키마가 바뀌었습니다.
교안에 영향
Get WebRTC token 응답 스키마가 바뀌어 옛 안내처럼 token만 기대하는 예시는 맞지 않으며, existing clients의 검증/역직렬화가 실패할 수 있습니다.
요약
- Procedure API가 추가되어 procedure 생성·조회·삭제와 draft 변경 관리, workflow 컴파일을 지원합니다. - Knowledge base crawl jobs와 bulk knowledge base management API가 추가되어 크롤링 작업 생성·조회·취소와 대량 검사·삭제를 할 수 있습니다. - voices에 악센트 조회 API가 추가되고, batch call 결과 내보내기와 대화 필터·분석 데이터 항목이 확장됐습니다. - WebRTC token 응답과 분석 설정, procedure 참조 메타데이터, webhook usage reporting이 변경됐고 일부 SDK와 패키지가 갱신됐습니다.
바뀐 것
새 기능
- Procedure APIs에 procedure를 관리하는 공개 branch-scoped 작업 8개를 추가했습니다.
- procedure는 name, content, type, trigger로 생성할 수 있으며, 빈 trigger는 sub-procedure를 만들고 누락되거나 null인 trigger는 procedure content에서 추론됩니다.
- Knowledge base crawl jobs를 생성·조회·검사·취소하는 API를 추가했습니다.
- bulk dependency checks와 bulk deletion이 1~20개의 고유한 document 또는 folder ID에 대해 지원됩니다.
- Export batch call results로 terminal batch의 recipients와 conversation results를 CSV로 내려받을 수 있습니다.
- KnowledgeBaseRagToolResultModel에 RAG-result-in-tool-result 모드를 위한 chunks가 추가됐습니다.
- GET /v1/voices/accents로 shared voice library에서 악센트를 조회할 수 있습니다.
개선
- Outbound WhatsApp 메시지와 outbound calls가 conversation_initiation_client_data로 전달된 branch_id와 environment를 따르도록 했으며, 잘못된 값은 전송 전에 오류로 거부되고 대화 전체에 유지됩니다.
- dependency check는 pagination과 dependent_type을 지원하고, deletion은 각 ID별로 독립적인 성공 또는 실패를 반환합니다.
- force: true를 설정하면 의존성을 함께 제거하고 비어 있지 않은 folder도 재귀적으로 삭제합니다.
- List conversations와 Text search conversation messages에 visited_agent_ids와 visited_agent_branch_ids 배열 필터가 추가됐습니다.
- List 요청에서 data_collection_ids와 evaluation_criteria_ids를 받아 각 conversation summary에 해당 결과를 포함할 수 있습니다.
- conversation summary에 data_collection_results, evaluation_criteria_results, tag_ids가 추가됐습니다.
- Agent platform settings에 선택적 nullable analysis_items 필드가 추가되어 evaluation 및 data-collection 항목을 참조로 연결할 수 있습니다.
- procedure references에 trigger와 referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids, referenced_dynamic_variables 배열이 추가됐습니다.
- ProjectCreationMetaResponseModel.status에 draft가 추가됐고, project creation type은 공유 ProjectCreationMetaType enum을 사용합니다.
- accent 조회 결과는 language와 model_id로 필터할 수 있고, 각 항목은 accent, language, code, 사람이 읽는 이름을 반환합니다.
- Get shared voices의 accent 쿼리 파라미터에 accent 값을 넣어 shared voices를 필터할 수 있습니다.
- WebhookUsageType에 Flows가 추가됐습니다.
기타
- JavaScript SDK v2.60.0에 voices.accents.get과 최신 schema의 ElevenAgents procedure, knowledge base crawl job, bulk management API, referenced analysis configuration이 추가됐습니다.
- Python SDK v2.60.0에 voices accents와 ElevenAgents procedure, knowledge base crawl job, bulk management API가 추가됐고 AsyncConversation startup 지연과 multipart 반복 필드 전송이 수정됐습니다.
- @elevenlabs/client@1.15.2에서 WebRTC transport의 onAudioAlignment를 수정했고, @elevenlabs/react@1.10.2, @elevenlabs/react-native@1.2.16, @elevenlabs/convai-widget-core@0.14.12, @elevenlabs/convai-widget-embed@0.14.12는 해당 수정이 포함된 의존성으로 갱신됐습니다.
수정
- Get WebRTC token 응답에 token 외에 conversation_id가 반드시 포함되도록 바뀌어 응답 스키마가 변경됐습니다.