Data retention and deletion

This document describes the data retention and deletion behavior for Conversational Analytics API data agent resources and conversation resources.

When a data agent or a conversation resource is deleted, whether manually or automatically, it enters a soft-deletion period before Google Cloud permanently deletes it. For this service, the soft-deletion period does not allow for user-initiated recovery of the deleted resource. Deleting the Google Cloud project that contains the agent also initiates the deletion of all Conversational Analytics API resources within that project.

For a general overview of data deletion on Google Cloud and details about project deletion timelines, see Data deletion on Google Cloud.

Data agents

Conversational Analytics API stores the following information for data agent resources:

  • The full resource name, including project ID, location, and agent ID
  • The data agent's description
  • The data agent's context, including the system description and the data source that the agent uses

Data agents are retained until you request deletion by using the projects.locations.dataAgents.delete method or the projects.locations.dataAgents.deleteSync method, or until the Google Cloud project that contains the agent is deleted.

When a data agent is deleted, it immediately enters a 30-day soft-deletion period. During this period, the data agent is unavailable for use, but the stored information for the agent is retained. Soft-deleted agents cannot be recovered. After 30 days, Google Cloud permanently deletes the data agent.

To view soft-deleted agents, use the projects.locations.dataAgents.list method with show_deleted set to true.

Conversations

Conversational Analytics API stores the following information for conversation resources:

  • Messages in the conversation, including user prompts and agent responses
  • Topic titles, which can be derived from message content
  • Related metadata, such as timestamps

Conversations are retained until you request deletion by using the projects.locations.conversations.delete method, until they are automatically deleted after 180 days of inactivity, or until the Google Cloud project that contains the agent is deleted.

When a conversation is deleted, it immediately enters a 30-day soft-deletion period, during which it is unavailable and cannot be viewed or recovered. After 30 days, Google Cloud begins to permanently delete the conversation. This process is completed within 63 days of the conversation entering the soft-deleted state.

What's next