Zur Navigation springen

Konversationszusammenfassung abrufen

Ruft eine kompakte Zusammenfassung einer Unterhaltung ab: ihren Titel, die generierte Transkriptzusammenfassung, ob der Anruf erfolgreich war und — nur bei kurzen Unterhaltungen — die einfachen Chatnachrichten. Tool-Aufrufe, Tool-Ergebnisse und kontextbezogene Aktualisierungen werden ausgelassen, damit die Antwort klein bleibt. Verwenden Sie dies statt des vollständigen Conversation-Endpunkts, wenn Sie nur die Kernaussage benötigen, etwa wenn ein Agent viele Unterhaltungen liest. Verwenden Sie GET /v1/convai/conversations/{conversation_id}, wenn Sie das vollständige Transkript mit Tool-Aufrufen und kontextbezogenen Aktualisierungen benötigen.

Pfadparameter

conversation_idstringErforderlich

Die ID der Unterhaltung, für die Sie die Aktion ausführen.

Header

xi-api-keystringOptional

Abfrageparameter

max_messagesintegerOptional1-200Standardwert ist 40

Maximale Anzahl inline einzubindender Chat-Nachrichtenwechsel. Bei mehr Nachrichtenwechseln werden die Nachrichten ausgelassen und messages_omitted gesetzt.

Antwort

Erfolgreiche Antwort
conversation_idstring
agent_idstring
statusenum
Erlaubte Werte:
message_countinteger

Anzahl der einfachen Chat-Nachrichtenwechsel in der Unterhaltung.

notestring

Anweisung, die dem Agenten erklärt, wie er das vollständige Transkript erhält.

call_summary_titlestringOptional

Kurzer generierter Titel für das Gespräch.

transcript_summarystringOptional

Generierte Zusammenfassung des Anrufs in natürlicher Sprache.

call_successfulenumOptional
Erlaubte Werte:
messageslist of objectsOptional

Die einfachen Chatnachrichten (nur Rolle und Text). Nur enthalten, wenn message_count das angeforderte max_messages nicht überschreitet; andernfalls null und messages_omitted ist true.

messages_omittedbooleanOptionalStandardwert ist false

True, wenn die Chatnachrichten ausgelassen wurden, weil die Unterhaltung zu lang war. Rufen Sie das vollständige Transkript für die Nachrichten ab.

Fehler

422
Conversations Get Summary Request Unprocessable Entity Error