REST Resource: projects.locations.conversations

Recurso: Conversation

Mensaje para 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 de recurso único 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 descrito 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. Agente(s) 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. 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 productos o plataformas específicos).

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

kmsKey

string

Es opcional. 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. 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 conversaciones.

delete

Borra una conversación.

get

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

list

Enumera todas las conversaciones de un elemento superior determinado.