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

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. Son los agentes que participan 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 estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. 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 estará normalizado a Z y usará 0, 3, 6 o 9 dígitos fraccionarios. 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)

Opcional. Son etiquetas abiertas y definidas por el usuario que el cliente puede establecer para etiquetar una conversación (p.ej., para filtrar conversaciones por 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.

get

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

list

Enumera todas las conversaciones de un elemento superior determinado.