REST Resource: projects.locations.conversations

Recurso: Conversation

Es el mensaje de una conversación.

Representación JSON 
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  },
  "kmsKey": string
}
Campos
name

string

Es opcional. Es el identificador. Es el nombre único del recurso de una conversación. Formato: projects/{project}/locations/{location}/conversations/{conversationId} {conversationId} es el ID del recurso y debe tener 63 caracteres o menos, y debe coincidir con el formato que se describe en https://google.aip.dev/122#resource-id-segments.

Ejemplo: projects/1234567890/locations/global/conversations/my-conversation.

Se recomienda omitir la configuración de este campo durante la creación de la conversación, ya que se inferirá automáticamente y se reemplazará por {parent}/conversations/{conversationId}.
agents[]

string

Obligatorio. Agentes en la conversación. Actualmente, solo se admite un agente. Este campo se repite para permitir la compatibilidad futura con varios agentes en una conversación. Formato: projects/{project}/locations/{location}/dataAgents/{agent}
createTime

string (Timestamp format)

Solo salida. Marca de tiempo de creación

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastUsedTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última conversación utilizada.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Es opcional. Son etiquetas abiertas y definidas por el usuario que el cliente puede establecer para etiquetar una conversación (p.ej., para filtrar conversaciones de plataformas o productos específicos).

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
kmsKey

string

Es opcional. Es la clave de encriptación administrada por el cliente (CMEK) que se usará para encriptar los recursos de Conversation. La encriptación se realizará en la capa de Titan, y pasaremos la clave de KMS a Titan.

Formato: projects/{projectId}/locations/{location}/keyRings/{key_ring_name}/cryptoKeys/{key_name}.

Métodos

create

 Crea una conversación nueva para conservar el historial de conversación.

delete

 Borra una conversación.

get

 Obtiene detalles de una sola conversación con el ID de conversación y el elemento superior.

list

 Enumera todas las conversaciones de un elemento superior determinado.