Obtenir le résumé de la conversation

Obtenir un résumé synthétique d'une conversation : son titre, le résumé de transcription généré, si l'appel a réussi et, uniquement lorsque la conversation est courte, les messages de chat simples. Les appels d'outils, leurs résultats et les mises à jour contextuelles sont omis afin de limiter la taille de la réponse. Utilisez ceci plutôt que le point de terminaison de conversation complet lorsque vous avez uniquement besoin de l'essentiel, par exemple pour un agent lisant de nombreuses conversations ; utilisez GET /v1/convai/conversations/{conversation_id} lorsque vous avez besoin de la transcription complète avec les appels d'outils et les mises à jour contextuelles.

Paramètres de chemin

conversation_idstringRequis

L’ID de la conversation sur laquelle vous effectuez l’action.

En-têtes

xi-api-keystringOptionnel

Paramètres de requête

max_messagesintegerOptionnel1-200Par défaut 40

Maximum number of chat message turns to include inline. When the conversation has more than this, the messages are omitted and messages_omitted is set.

Réponse

Réponse réussie

conversation_idstring
agent_idstring
statusenum
Valeurs autorisées:
message_countinteger
Nombre de tours de messages de chat simples dans la conversation.
notestring

Instructions indiquant à l’agent comment obtenir la transcription complète.

call_summary_titlestring or nullOptionnel

Titre court généré pour la conversation.

transcript_summarystring or nullOptionnel

Résumé généré de l’appel en langage naturel.

call_successfulenum or nullOptionnel
Valeurs autorisées:
messageslist of objects or nullOptionnel

Les messages de chat bruts, rôle et texte uniquement. Inclus uniquement lorsque message_count ne dépasse pas max_messages demandé ; sinon, la valeur est null et messages_omitted est true.

messages_omittedbooleanOptionnelPar défaut false

True lorsque les messages de chat ont été omis parce que la conversation était trop longue. Récupérez la transcription complète pour obtenir les messages.

Erreurs

422
Unprocessable Entity Error