- [Resource: Conversation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation)
  - [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.SCHEMA_REPRESENTATION)
- [Conversation.Turn](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.Turn)
  - [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.Turn.SCHEMA_REPRESENTATION)
- [Conversation.ChannelType](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.ChannelType)
- [Conversation.Source](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.Source)
- [Conversation.InputType](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.InputType)
- [Methods](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#METHODS_SUMMARY)

## Resource: Conversation

A conversation represents an interaction between an end user and the CES app.

| JSON representation |
|---|
| ``` { "name": string, "startTime": string, "endTime": string, "turns": [ { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.Turn`) } ], "turnCount": integer, "channelType": enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.ChannelType`), "source": enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.Source`), "inputTypes": [ enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.InputType`) ], "entryAgent": string, "deployment": string, "appVersion": string, "languageCode": string, "messages": [ { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/Message`) } ] } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The unique identifier of the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}` |
| `startTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Timestamp when the conversation was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `endTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Timestamp when the conversation was completed. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `turns[]` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.Turn`)`` Required. The turns in the conversation. |
| `turnCount` | `integer` Output only. The number of turns in the conversation. |
| `channelType (deprecated)` | ``enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.ChannelType`)`` > [!WARNING] > This item is deprecated! DEPRECATED. Please use `https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.FIELDS.input_types` instead. |
| `source` | ``enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.Source`)`` Output only. Indicate the source of the conversation. |
| `inputTypes[]` | ``enum (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations#Conversation.InputType`)`` Output only. The input types of the conversation. |
| `entryAgent` | `string` Output only. The agent that initially handles the conversation. If not specified, the conversation is handled by the root agent. Format: `projects/{project}/locations/{location}/apps/{app}/agents/{agent}` |
| `deployment` | `string` Output only. The deployment of the app used for processing the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}` |
| `appVersion` | `string` Output only. The version of the app used for processing the conversation. Format: `projects/{project}/locations/{location}/apps/{app}/versions/{version}` |
| `languageCode` | `string` Output only. The language code of the conversation. |
| `messages[] (deprecated)` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/Message`)`` > [!WARNING] > This item is deprecated! Deprecated. Use turns instead. |

## Conversation.Turn

All information about a single turn in the conversation.

| JSON representation |
|---|
| ``` { "messages": [ { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/Message`) } ], "rootSpan": { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/Span`) }, "userIntendedText": string } ``` |

| Fields ||
|---|---|
| `messages[]` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/Message`)`` Optional. List of messages in the conversation turn, including user input, agent responses and intermediate events during the processing. |
| `rootSpan` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/Span`)`` Optional. The root span of the action processing. |
| `userIntendedText` | `string` Optional. The intended ground-truth text from the Simulated Caller (Polysynth). Only populated when word error rate metrics are enabled. |

## Conversation.ChannelType

The channel type of the conversation.

| Enums ||
|---|---|
| `CHANNEL_TYPE_UNSPECIFIED` | Unspecified channel type. |
| `TEXT` | The conversation only contains text messages between the end user and the agent. |
| `AUDIO` | The conversation contains audio messages between the end user and the agent. |
| `MULTIMODAL` | The conversation multi-modal messages (e.g. image) between the end user and the agent. |

## Conversation.Source

The source of the conversation.

| Enums ||
|---|---|
| `SOURCE_UNSPECIFIED` | Unspecified source. |
| `LIVE` | The conversation is from the live end user. |
| `SIMULATOR` | The conversation is from the simulator. |
| `EVAL` | The conversation is from the evaluation. |
| `AGENT_TOOL` | The conversation is from an agent tool. Agent tool runs the agent in a separate session, which is persisted for testing and debugging purposes. |

## Conversation.InputType

Type of the input message.

| Enums ||
|---|---|
| `INPUT_TYPE_UNSPECIFIED` | Unspecified input type. |
| `INPUT_TYPE_TEXT` | Text input. |
| `INPUT_TYPE_EVENT` | Event input. |
| `INPUT_TYPE_AUDIO` | Audio input. |
| `INPUT_TYPE_IMAGE` | Image input. |
| `INPUT_TYPE_BLOB` | Blob input. |
| `INPUT_TYPE_TOOL_RESPONSE` | Client function tool response input. |
| `INPUT_TYPE_VARIABLES` | Variables input. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations/batchDelete` | Batch deletes the specified conversations. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations/delete` | Deletes the specified conversation. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations/generateEvaluation` | Creates a golden evaluation from a conversation. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations/get` | Gets details of the specified conversation. |
| ### `https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/projects.locations.apps.conversations/list` | Lists conversations in the given app. |