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,
    ...
  }
}
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 sobrescribirá con {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 en plataformas o productos específicos).

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

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 con el ID de conversación y el elemento superior.

list

Enumera todas las conversaciones de un elemento superior determinado.