ElevenAgentsConversations

获取会话摘要

获取对话的轻量摘要：标题、生成的转录摘要、通话是否成功，以及——仅在对话较短时——纯聊天消息。为保持响应精简，工具调用、工具结果和上下文更新将被省略。仅需了解概要时（例如智能体阅读大量对话），请使用此端点而非完整对话端点；需要包含工具调用和上下文更新的完整转录时，请使用 GET /v1/convai/conversations/{conversation_id}。

路径参数

conversation_idstring必需

要执行操作的对话 ID。

请求头

xi-api-keystring可选

查询参数

max_messagesinteger可选1-200默认为 40

内联包含的最大聊天消息轮数。对话超过此数量时，消息将被省略，并设置 messages_omitted。

响应

成功响应

conversation_idstring
agent_idstring
statusenum
允许的值:
message_countinteger

对话中的普通聊天消息轮次数。

notestring

指导智能体如何获取完整转录文本。

call_summary_titlestring or null可选

为对话生成的简短标题。

transcript_summarystring or null可选

生成的通话自然语言摘要。

call_successfulenum or null可选
允许的值:
messageslist of objects or null可选

纯聊天消息（仅包含角色和文本）。仅当 message_count 不超过请求的 max_messages 时包含；否则为 null，且 messages_omitted 为 true。

messages_omittedboolean可选默认为 false

当对话过长而省略聊天消息时为 True。请获取完整转录以查看消息。

错误

422
Unprocessable Entity Error