- [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#SCHEMA_REPRESENTATION)
- [ToolResponses](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#ToolResponses)
  - [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#ToolResponses.SCHEMA_REPRESENTATION)
- [Event](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#Event)
  - [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#Event.SCHEMA_REPRESENTATION)
- [SessionInput.RecordingControl](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#SessionInput.RecordingControl)

Input for the session.

| JSON representation |
|---|
| ``` { "willContinue": boolean, "recordingControl": enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#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 (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#ToolResponses`) }, "image": { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/Message#Image`) }, "blob": { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/Message#Blob`) }, "variables": { object }, "event": { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#Event`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `willContinue` | `boolean` Optional. A flag to indicate if the current message is a fragment of a larger input in the bidi streaming session. When set to `true`, the agent defers processing until it receives a subsequent message where `willContinue` is `false`, or until the system detects an endpoint in the audio input. NOTE: This field does not apply to audio and DTMF inputs, as they are always processed automatically based on the endpointing signal. |
| `recordingControl` | ``enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#SessionInput.RecordingControl`)`` Optional. Whether the conversation may be recorded and logged from here on. Use this when the app, rather than the agent, decides what may be kept: for example when the end user has to consent to being recorded before anything about the call can be stored. The value stays in effect until the client sends a different one, so it only needs to be sent when the answer changes. Whatever is in effect when a turn completes decides that turn, both whether its audio reaches the recording bucket and whether its transcript reaches conversation history, BigQuery and Cloud Logging. It covers the agent's side of the turn as well as the end user's. Turns that complete before the client first sends this are recorded according to the app's logging settings, as though the field did not exist. If more than one input in the same request sets it, the last one wins. |
| The type of the input. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `text` | `string` Optional. Text data from the end user. |
| `dtmf` | `string` Optional. DTMF digits from the end user. |
| `audio` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. Audio data from the end user. A base64-encoded string. |
| `toolResponses` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#ToolResponses`)`` Optional. Execution results for the tool calls from the client. |
| `image` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/Message#Image`)`` Optional. Image data from the end user. |
| `blob` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/Message#Blob`)`` Optional. Blob data from the end user. |
| `variables` | ``object (`https://protobuf.dev/reference/protobuf/google.protobuf#struct` format)`` Optional. Contextual variables for the session, keyed by name. Only variables declared in the app will be used by the CES agent. Unrecognized variables will still be sent to the \[Dialogflow agent\]\[Agent.RemoteDialogflowAgent\] as additional session parameters. |
| `event` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/SessionInput#Event`)`` Optional. Event input. |
| End of mutually exclusive fields. ||

## ToolResponses

Execution results for the requested tool calls from the client.

| JSON representation |
|---|
| ``` { "toolResponses": [ { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/Message#ToolResponse`) } ] } ``` |

| Fields ||
|---|---|
| `toolResponses[]` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1/Message#ToolResponse`)`` Optional. The list of tool execution results. |

## Event

Event input.

| JSON representation |
|---|
| ``` { "event": string, "variables": { object } } ``` |

| Fields ||
|---|---|
| `event` | `string` Required. The name of the event. |
| `variables` | ``object (`https://protobuf.dev/reference/protobuf/google.protobuf#struct` format)`` Optional. Additional variables associated with the event. |

## SessionInput.RecordingControl

What the app has decided may be recorded and logged.

This enum is extensible; new values may be added in the future.

| Enums ||
|---|---|
| `RECORDING_CONTROL_UNSPECIFIED` | The app is not controlling recording. The app's logging settings decide, as they do for every session that never sets this field. |
| `RECORDING_ENABLED` | The conversation may be recorded and logged from here on. |
| `RECORDING_DISABLED` | The conversation may not be recorded or logged from here on. |