대화 메시지 텍스트 검색

GET

/v1/convai/conversations/messages/text-search

전문 검색 및 퍼지 검색으로 대화 트랜스크립트 메시지를 검색합니다.

쿼리 매개변수

text_querystring필수

전체 텍스트 및 퍼지 매칭용 검색 쿼리 텍스트

agent_idstring or null선택 사항

동일한 기본 리소스로 확인되는 에이전트 ID(agent_…) 또는 음성 엔진 외부 ID(seng_)입니다.

visited_agent_idslist of strings or null선택 사항

이 에이전트 중 하나라도 참여한 대화를 필터링합니다. 값은 50개를 초과할 수 없습니다.

visited_agent_branch_idslist of strings or null선택 사항

이 에이전트 브랜치 중 하나라도 참여한 대화를 필터링합니다. 값은 50개를 초과할 수 없습니다.

triggered_procedure_idslist of strings or null선택 사항

이 절차 중 하나라도 트리거된 대화를 필터링합니다. 값은 50개를 초과할 수 없습니다.

call_successfulenum or null선택 사항

성공 평가 결과

허용된 값:

call_start_before_unixinteger or null선택 사항

이 시작일까지의 대화를 필터링하는 Unix 타임스탬프(초)입니다.

call_start_after_unixinteger or null선택 사항

이 시작일 이후의 대화를 필터링하는 Unix 타임스탬프(초)입니다.

call_duration_min_secsinteger or null선택 사항

최소 통화 시간(초)입니다.

call_duration_max_secsinteger or null선택 사항

최대 통화 시간(초)입니다.

rating_maxinteger or null선택 사항1-5

최대 종합 평점(1~5)입니다.

rating_mininteger or null선택 사항1-5

최소 전체 평점(1~5)입니다.

has_feedback_commentboolean or null선택 사항

사용자 피드백 댓글이 있는 대화를 필터링합니다.

user_idstring or null선택 사항

대화를 시작한 사용자의 ID로 대화를 필터링합니다.

evaluation_paramslist of strings or null선택 사항

평가 필터입니다. 반복 파라미터입니다. 형식: criteria_id:result. result는 success|failure|unknown 중 하나입니다. 예: eval=value_framing:success

data_collection_paramslist of strings or null선택 사항

데이터 수집 필터입니다. 반복 매개변수입니다. 형식은 id:op:value이며, op는 eq|neq|gt|gte|lt|lte|in 중 하나입니다. in의 경우 값은 파이프(|)로 구분합니다. 빈 값은 해당 필드가 수집되지 않은 대화와 일치하며(id:eq:), 빈 값을 사용한 neq는 수집된 대화와 일치합니다(id:neq:). eq는 정확히 일치함을 의미합니다. gt|gte|lt|lte에는 숫자 값이 필요합니다.

dynamic_variable_paramslist of strings or null선택 사항

동적 변수 필터입니다. 반복 매개변수입니다. 형식: name:op:value. 여기서 op는 eq|neq|gt|gte|lt|lte|in 중 하나입니다. in의 경우 값은 파이프(|)로 구분합니다. 빈 값은 변수가 설정되지 않은 대화와 일치하며(name:eq:), 빈 값을 사용하는 neq는 변수가 설정된 대화와 일치합니다(name:neq:). eq는 정확한 동등 비교입니다. gt|gte|lt|lte에는 숫자 값이 필요합니다. ':'를 포함하는 이름은 표현할 수 없습니다.

tool_nameslist of strings or null선택 사항

통화 중 사용된 도구 이름으로 대화를 필터링합니다.

tool_names_successfullist of strings or null선택 사항

성공한 호출이 있었던 도구 이름으로 대화를 필터링합니다.

tool_names_erroredlist of strings or null선택 사항

오류가 발생한 호출이 있었던 도구 이름으로 대화를 필터링합니다.

include_invalid_tool_callsboolean선택 사항기본값 false

실행되지 않은 도구 호출도 일치시킵니다.

main_languageslist of strings or null선택 사항

감지된 기본 언어(언어 코드)로 대화를 필터링합니다.

exclude_statuseslist of enums or null선택 사항

지정된 상태의 대화를 제외합니다. 목록 보기에서 진행 중 / 처리 중인 대화를 숨기는 데 유용합니다.

허용된 값:

termination_reasonslist of strings or null선택 사항

저장된 termination_reason(metadata.termination_reason)으로 대화를 필터링합니다. 여러 값 중 하나와 일치시키려면 매개변수를 반복하세요.

page_sizeinteger선택 사항1-50기본값 20

페이지당 결과 수입니다. 최대 50개입니다.

summary_modeenum선택 사항기본값 exclude

응답에 기록 요약을 포함할지 여부입니다.

허용된 값:

conversation_initiation_sourceenum or null선택 사항기본값 unknown

대화 시작에 가능한 소스를 나타내는 열거형입니다.

text_onlyboolean or null선택 사항

conversation_product_typeenum or null선택 사항

결과를 단일 대화 제품 화면으로 제한합니다.

허용된 값:

branch_idstring or null선택 사항

브랜치 ID로 대화를 필터링합니다.

version_idstring or null선택 사항

버전 ID로 대화를 필터링합니다.

topic_idslist of strings or null선택 사항

주제 탐색 중 할당된 주제 ID로 대화를 필터링합니다.

sort_byenum선택 사항

검색 결과의 정렬 순서입니다. 'search_score'는 검색 점수순, 'created_at'은 대화 시작 시간순으로 정렬합니다.

허용된 값:

cursorstring or null선택 사항

다음 페이지를 가져오는 데 사용됩니다. 응답에서 커서가 반환됩니다.

응답

성공 응답

resultslist of objects

has_moreboolean

사용 가능한 결과가 더 있는지 여부

metaobject선택 사항

next_cursorstring or null선택 사항

다음 결과 페이지를 위한 커서

오류

422

Unprocessable Entity Error

헤더

쿼리 매개변수

응답

오류