Przejdź do nawigacji
Dokumentacja APIRozmowy

Pobierz podsumowanie rozmowy

Pobierz skrócone podsumowanie rozmowy: jej tytuł, wygenerowane podsumowanie transkrypcji, informację o powodzeniu połączenia oraz — tylko gdy rozmowa jest krótka — zwykłe wiadomości czatu. Wywołania narzędzi, ich wyniki i aktualizacje kontekstowe są pominięte, aby odpowiedź była niewielka. Użyj tego zamiast pełnego endpointu rozmowy, gdy potrzebujesz tylko ogólnego obrazu (np. agent czyta wiele rozmów); użyj GET /v1/convai/conversations/{conversation_id}, gdy potrzebujesz pełnej transkrypcji z wywołaniami narzędzi i aktualizacjami kontekstowymi.

Parametry ścieżki

conversation_idstringWymagany

ID rozmowy, której dotyczy działanie.

Nagłówki

xi-api-keystringOpcjonalny

Parametry zapytania

max_messagesintegerOpcjonalny1-200Domyślnie 40

Maksymalna liczba tur wiadomości czatu do dołączenia inline. Gdy rozmowa ma ich więcej, wiadomości są pomijane, a ustawiane jest messages_omitted.

Odpowiedź

Pomyślna odpowiedź

conversation_idstring
agent_idstring
statusenum
Dozwolone wartości:
message_countinteger

Liczba zwykłych tur wiadomości czatu w rozmowie.

notestring

Instrukcje dla agenta, jak uzyskać pełną transkrypcję.

call_summary_titlestringOpcjonalny

Krótki wygenerowany tytuł rozmowy.

transcript_summarystringOpcjonalny

Wygenerowane podsumowanie połączenia w języku naturalnym.

call_successfulenumOpcjonalny
Dozwolone wartości:
messageslist of objectsOpcjonalny

Zwykłe wiadomości czatu (tylko rola i tekst). Uwzględniane tylko, gdy message_count nie przekracza żądanego max_messages; w przeciwnym razie null, a messages_omitted ma wartość true.

messages_omittedbooleanOpcjonalnyDomyślnie false

True, gdy wiadomości czatu pominięto, ponieważ rozmowa była zbyt długa. Pobierz pełną transkrypcję, aby uzyskać wiadomości.

Błędy

422
Conversations Get Summary Request Unprocessable Entity Error