에이전트 관리와 안전성 기능 확장
대화 사용자 조회, 에이전트 버전 관리, 검색 도구, MCP 도구, 콘텐츠 가드레일과 테스트 유형이 추가됐습니다.
교안에 영향
예전 안내 글에서 Get pronunciation dictionary 응답에 rules가 없다고 적은 부분은 틀려졌습니다.
요약
- Get conversation users endpoint가 추가되어 에이전트와 대화한 사용자를 조회할 수 있게 됐습니다. - Get agent와 Update agent에 버전별·브랜치별 설정과 업데이트를 위한 파라미터가 추가됐습니다. - search_documentation 시스템 도구, mcp 도구 유형, 콘텐츠 가드레일, expressive_mode, post_dial_digits, 에이전트 테스트 유형이 추가됐습니다. - Get pronunciation dictionary 응답에 rules 배열이 포함되고, 지식 베이스 문서 삭제에서 폴더 삭제가 지원됩니다.
바뀐 것
새 기능
- Get conversation users endpoint( GET /v1/convai/users )가 추가되어 에이전트와 대화한 사용자를 조회할 수 있게 됐습니다.
- Get agent endpoint에 version_id와 branch_id 쿼리 매개변수가 추가되어 버전별 에이전트 설정을 가져올 수 있게 됐습니다.
- Update agent endpoint가 branch_id를 받아 브랜치별 업데이트를 지원합니다.
- search_documentation이 RAG용 새 기본 시스템 도구로 추가됐습니다.
- MultiSourceConfigJson, SourceConfigJson, SourceRetrievalConfig 스키마로 다중 소스 검색 구성을 지원합니다.
- MergingStrategy 열거형으로 검색 결과 병합 전략을 설정할 수 있게 됐습니다.
- mcp가 webhook, client, system과 함께 새로운 도구 유형으로 추가됐습니다.
- MCPToolConfig 스키마로 에이전트 도구 정의에서 MCP 도구를 구성할 수 있게 됐습니다.
- GuardrailsV1에 성적, 폭력, 괴롭힘, 자해, 욕설, 종교/정치, 의료/법률 항목의 콘텐츠 조정 가드레일이 추가됐습니다.
- ContentGuardrail과 ContentConfig 스키마가 추가됐습니다.
- 에이전트 구성 스키마에 expressive_mode 불리언 필드가 추가됐습니다.
- 전화번호 전송에서 연결 후 DTMF 톤을 보내는 post_dial_digits를 지원합니다.
- 에이전트 테스트가 llm, tool, simulation의 세 가지 테스트 유형과 전용 스키마를 지원합니다.
- simulation 테스트에 simulation_scenario와 simulation_max_turns 구성 필드가 추가됐습니다.
- Delete knowledge base document endpoint에서 문서뿐 아니라 폴더 삭제도 지원합니다.
개선
- Get pronunciation dictionary endpoint 응답에 규칙 전체 정보를 담은 rules 배열이 추가됐습니다.
- GetPronunciationDictionaryWithRulesResponseModel과 PronunciationDictionaryAliasRuleResponseModel, PronunciationDictionaryPhonemeRuleResponseModel 스키마가 추가됐습니다.
- 폴더 삭제 시 force=true로 포함된 문서와 하위 폴더를 재귀 삭제할 수 있게 됐습니다.
기타
- Python SDK v2.36.0이 대화 사용자 조회, 에이전트 버전 관리, search_documentation 도구, MCP 도구 지원, 콘텐츠 가드레일, 에이전트 테스트 유형 추가를 반영했습니다.
- JavaScript SDK v2.36.0이 speechToText.convert()의 오버로드 시그니처 추가와 함께 대화 사용자 조회, 에이전트 버전 관리, search_documentation 도구, MCP 도구 지원, 콘텐츠 가드레일, 에이전트 테스트 유형 추가를 반영했습니다.
- @elevenlabs/convai-widget-core@0.9.0에 에이전트 도구 사용 상태 표시와 장시간 도구 호출용 새 상태 배지가 추가됐고, emotion 태그 제거와 signed-url 위젯 임베딩의 평점·피드백 제출 문제가 수정됐습니다.
- @elevenlabs/convai-widget-embed@0.9.0에 에이전트 도구 사용 상태 표시와 장시간 도구 호출용 새 상태 배지가 추가됐고, emotion 태그 제거가 수정됐습니다.