시작하기Conversations

대화 요약 가져오기

대화의 제목, 생성된 트랜스크립트 요약, 통화 성공 여부 및 대화가 짧은 경우에만 일반 채팅 메시지를 포함한 간략한 요약을 가져옵니다. 응답 크기를 작게 유지하기 위해 도구 호출, 도구 결과 및 컨텍스트 업데이트는 제외됩니다. 핵심 내용만 필요한 경우(예: 에이전트가 여러 대화를 읽는 경우) 전체 대화 엔드포인트 대신 사용하세요. 도구 호출과 컨텍스트 업데이트를 포함한 전체 트랜스크립트가 필요한 경우 GET /v1/convai/conversations/{conversation_id}를 사용하세요.

경로 매개변수

conversation_idstring필수

작업을 수행할 대화의 ID입니다.

헤더

xi-api-keystring선택 사항

쿼리 매개변수

max_messagesinteger선택 사항1-200기본값 40

인라인으로 포함할 최대 채팅 메시지 턴 수입니다. 대화가 이보다 길면 메시지가 생략되고 messages_omitted가 설정됩니다.

응답

성공 응답

conversation_idstring
agent_idstring
statusenum
허용된 값:
message_countinteger

대화 내 일반 채팅 메시지 턴 수입니다.

notestring

전체 트랜스크립트를 가져오는 방법을 에이전트에 안내합니다.

call_summary_titlestring선택 사항

대화의 짧은 생성 제목입니다.

transcript_summarystring선택 사항

생성된 통화의 자연어 요약입니다.

call_successfulenum선택 사항
허용된 값:
messageslist of objects선택 사항

일반 채팅 메시지(역할 및 텍스트만)입니다. message_count가 요청한 max_messages를 초과하지 않는 경우에만 포함됩니다. 그렇지 않으면 null이며 messages_omitted는 true입니다.

messages_omittedboolean선택 사항기본값 false

대화가 너무 길어 채팅 메시지가 생략된 경우 true입니다. 메시지를 확인하려면 전체 전사본을 가져오세요.

오류

422
Conversations Get Summary Request Unprocessable Entity Error