대화 메시지 텍스트 검색

GET

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

GET

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

curl -G https://api.elevenlabs.io/v1/convai/conversations/messages/text-search \
     -d agent_id=agent_id \
     -d branch_id=branch_id \
     -d call_duration_max_secs=1 \
     -d call_duration_min_secs=1 \
     -d call_start_after_unix=1 \
     -d call_start_before_unix=1 \
     -d call_successful=success \
     -d conversation_initiation_source=unknown \
     -d conversation_product_type=agents \
     -d cursor=cursor \
     -d data_collection_params=data_collection_params \
     -d dynamic_variable_params=dynamic_variable_params \
     -d evaluation_params=evaluation_params \
     -d exclude_statuses=initiated \
     -d has_feedback_comment=true \
     -d include_invalid_tool_calls=true \
     -d main_languages=main_languages \
     -d page_size=1 \
     -d rating_max=1 \
     -d rating_min=1 \
     -d sort_by=search_score \
     -d summary_mode=exclude \
     -d termination_reasons=termination_reasons \
     -d text_only=true \
     --data-urlencode "text_query=refund policy" \
     -d tool_names=tool_names \
     -d tool_names_errored=tool_names_errored \
     -d tool_names_successful=tool_names_successful \
     -d topic_ids=topic_ids \
     -d triggered_procedure_ids=triggered_procedure_ids \
     -d user_id=user_id \
     -d version_id=version_id \
     -d visited_agent_branch_ids=visited_agent_branch_ids \
     -d visited_agent_ids=visited_agent_ids

{
  "results": [
    {
      "conversation_id": "conversation_id",
      "agent_id": "agent_id",
      "transcript_index": 1,
      "chunk_text": "chunk_text",
      "score": 1.1,
      "conversation_start_time_unix_secs": 1,
      "agent_name": "agent_name",
      "chunk_highlights": [
        {
          "value": "value",
          "is_hit": true
        }
      ]
    }
  ],
  "has_more": true,
  "meta": {
    "total": 1,
    "page": 1,
    "page_size": 1
  },
  "next_cursor": "next_cursor"
}

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

쿼리 매개변수

text_querystring필수

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

agent_idstring선택 사항

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

visited_agent_idsstring선택 사항

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

visited_agent_branch_idsstring선택 사항

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

triggered_procedure_idsstring선택 사항

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

call_successfulenum선택 사항

성공 평가 결과

허용된 값:

call_start_before_unixinteger선택 사항

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

call_start_after_unixinteger선택 사항

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

call_duration_min_secsinteger선택 사항

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

call_duration_max_secsinteger선택 사항

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

rating_maxinteger선택 사항1-5

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

rating_mininteger선택 사항1-5

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

has_feedback_commentboolean선택 사항

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

user_idstring선택 사항

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

evaluation_paramsstring선택 사항

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

data_collection_paramsstring선택 사항

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

dynamic_variable_paramsstring선택 사항

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

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

tool_namesstring선택 사항

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

tool_names_successfulstring선택 사항

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

tool_names_erroredstring선택 사항

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

include_invalid_tool_callsboolean선택 사항기본값 false

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

main_languagesstring선택 사항

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

exclude_statusesenum선택 사항

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

허용된 값:

termination_reasonsstring선택 사항

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

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

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

summary_modeenum선택 사항기본값 exclude

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

허용된 값:

conversation_initiation_sourceenum선택 사항기본값 unknown

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

text_onlyboolean선택 사항

conversation_product_typeenum선택 사항

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

허용된 값:

branch_idstring선택 사항

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

version_idstring선택 사항

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

topic_idsstring선택 사항

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

sort_byenum선택 사항

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

허용된 값:

cursorstring선택 사항

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

응답

성공 응답

resultslist of objects

has_moreboolean

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

metaobject선택 사항

next_cursorstring선택 사항

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

오류

422

Messages Text Search Request Unprocessable Entity Error

헤더

쿼리 매개변수

응답

오류