ElevenAgentsConversations

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_titlestring or nullOptional

Kurzer generierter Titel für das Gespräch.

transcript_summarystring or nullOptional

Generierte Zusammenfassung des Anrufs in natürlicher Sprache.

call_successfulenum or nullOptional
Erlaubte Werte:
messageslist of objects or nullOptional

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
Unprocessable Entity Error