ElevenAgentsConversations

Obtener resumen de la conversación

Obtén un resumen ligero de una conversación: su título, el resumen generado de la transcripción, si la llamada tuvo éxito y, solo cuando la conversación es breve, los mensajes de chat sin formato. Se omiten las llamadas a herramientas, los resultados de herramientas y las actualizaciones contextuales para que la respuesta sea reducida. Usa esta ruta de API en lugar de la de conversación completa cuando solo necesites lo esencial (por ejemplo, para que un agente lea muchas conversaciones); usa GET /v1/convai/conversations/{conversation_id} cuando necesites la transcripción completa con llamadas a herramientas y actualizaciones contextuales.

Parámetros de ruta

conversation_idstringRequerido

El ID de la conversación sobre la que estás realizando la acción.

Encabezados

xi-api-keystringOpcional

Parámetros de consulta

max_messagesintegerOpcional1-200Valor predeterminado: 40

Número máximo de turnos de mensajes de chat que se incluirán en línea. Cuando la conversación supera este número, se omiten los mensajes y se establece messages_omitted.

Respuesta

Respuesta correcta.
conversation_idstring
agent_idstring
statusenum
Valores permitidos:
message_countinteger

Número de turnos de mensajes de chat sin formato en la conversación.

notestring

Instrucciones que indican al agente cómo obtener la transcripción completa.

call_summary_titlestring or nullOpcional

Título breve generado para la conversación.

transcript_summarystring or nullOpcional
Resumen generado de la llamada en lenguaje natural.
call_successfulenum or nullOpcional
Valores permitidos:
messageslist of objects or nullOpcional

Los mensajes de chat sin formato (solo rol y texto). Solo se incluyen cuando message_count no supera el valor solicitado de max_messages; de lo contrario, es null y messages_omitted es true.

messages_omittedbooleanOpcionalValor predeterminado: false

True cuando se omitieron los mensajes de chat porque la conversación era demasiado larga. Obtén la transcripción completa para consultar los mensajes.

Errores

422
Unprocessable Entity Error