Vai alla navigazione
ElevenAgentsConversazioni

Recupera riepilogo della conversazione

Ottieni un riepilogo leggero di una conversazione: il titolo, il riepilogo generato della trascrizione, se la chiamata è andata a buon fine e, solo quando la conversazione è breve, i semplici messaggi della chat. Le chiamate agli strumenti, i risultati degli strumenti e gli aggiornamenti contestuali vengono omessi per mantenere piccola la risposta. Usalo invece dell’endpoint della conversazione completa quando ti serve solo il succo (ad esempio, per un agente che legge molte conversazioni); usa GET /v1/convai/conversations/{conversation_id} quando ti serve la trascrizione completa con le chiamate agli strumenti e gli aggiornamenti contestuali.

Parametri di percorso

conversation_idstringObbligatorio
L'ID della conversazione su cui stai eseguendo l'azione.

Header

xi-api-keystringOpzionale

Parametri di query

max_messagesintegerOpzionale1-200Predefinito a 40

Numero massimo di turni di messaggi chat da includere inline. Quando la conversazione ne contiene di più, i messaggi vengono omessi e viene impostato messages_omitted.

Risposta

Risposta riuscita
conversation_idstring
agent_idstring
statusenum
Valori consentiti:
message_countinteger
Numero di turni di messaggi di chat semplice nella conversazione.
notestring
Indicazioni che spiegano all'agente come ottenere la trascrizione completa.
call_summary_titlestring or nullOpzionale
Breve titolo generato per la conversazione.
transcript_summarystring or nullOpzionale
Riepilogo della chiamata generato in linguaggio naturale.
call_successfulenum or nullOpzionale
Valori consentiti:
messageslist of objects or nullOpzionale

I messaggi di chat semplici, contenenti solo ruolo e testo. Inclusi solo quando message_count non supera max_messages richiesto; altrimenti sono null e messages_omitted è true.

messages_omittedbooleanOpzionalePredefinito a false

True quando i messaggi della chat sono stati omessi perché la conversazione era troppo lunga. Recupera la trascrizione completa per visualizzare i messaggi.

Errori

422
Unprocessable Entity Error