SessionInput

会话的输入。

JSON 表示法
{
  "willContinue": boolean,
  "recordingControl": enum (SessionInput.RecordingControl),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "dtmf": string,
  "audio": string,
  "toolResponses": {
    object (ToolResponses)
  },
  "image": {
    object (Image)
  },
  "blob": {
    object (Blob)
  },
  "variables": {
    object
  },
  "event": {
    object (Event)
  }
  // End of mutually exclusive fields.
}
字段
willContinue

boolean

可选。一个标志,用于指示当前消息是否为双向流式传输会话中较大输入的一部分。

如果设置为 true,智能体会推迟处理,直到收到 willContinue 为 false 的后续消息,或者直到系统在音频输入中检测到端点。

注意:此字段不适用于音频和 DTMF 输入,因为它们始终会根据端点信号自动处理。

recordingControl

enum (SessionInput.RecordingControl)

可选。是否可以从此处开始录制和记录对话。

当应用(而非代理)决定可以保留哪些内容时,请使用此选项:例如,在存储与通话相关的任何内容之前,最终用户必须同意录音。

该值会一直有效,直到客户端发送其他值,因此只需在答案发生变化时发送。在对话轮次完成时,系统会根据当时生效的设置来决定该轮次的处理方式,包括其音频是否会进入录音存储桶,以及其转写内容是否会进入对话记录、BigQuery 和 Cloud Logging。它涵盖了代理和最终用户在对话轮次中的表现。

在客户端首次发送此字段之前完成的回合会根据应用的日志记录设置进行记录,就好像该字段不存在一样。

如果同一请求中的多个输入都设置了此字段,则最后一个输入会生效。

输入类型。以下是互斥字段的列表。在响应中,最多只能设置以下字段之一:
text

string

可选。来自最终用户的文本数据。

dtmf

string

可选。最终用户输入的 DTMF 数字。

audio

string (bytes format)

可选。来自最终用户的音频数据。

使用 base64 编码的字符串。

toolResponses

object (ToolResponses)

可选。客户端工具调用的执行结果。

image

object (Image)

可选。来自最终用户的图片数据。

blob

object (Blob)

可选。来自最终用户的 Blob 数据。

variables

object (Struct format)

可选。会话的上下文变量,按名称键控。CES 代理只会使用在应用中声明的变量。

无法识别的变量仍将作为额外的会话参数发送到 [Dialogflow 代理][Agent.RemoteDialogflowAgent]。

event

object (Event)

可选。事件输入。

互斥字段结束。

ToolResponses

客户端请求的工具调用的执行结果。

JSON 表示法
{
  "toolResponses": [
    {
      object (ToolResponse)
    }
  ]
}
字段
toolResponses[]

object (ToolResponse)

可选。工具执行结果列表。

事件

事件输入。

JSON 表示法
{
  "event": string,
  "variables": {
    object
  }
}
字段
event

string

必需。事件的名称。

variables

object (Struct format)

可选。与事件关联的其他变量。

SessionInput.RecordingControl

应用做出的决定可能会被记录和记入日志。

此枚举可扩展;未来可能会添加新值。

枚举
RECORDING_CONTROL_UNSPECIFIED 应用未控制录制。应用的日志记录设置会决定是否记录,就像对从未设置此字段的每个会话一样。
RECORDING_ENABLED 从现在开始,对话可能会被录音和记录。
RECORDING_DISABLED 从现在起,对话可能不会被录制或记录。