REST Resource: projects.locations.conversations

Recurso: conversa

Mensagem para uma conversa.

Representação JSON
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  }
}
Campos
name

string

Opcional. Identificador. O nome do recurso exclusivo de uma conversa. Formato: projects/{project}/locations/{location}/conversations/{conversationId} {conversationId} é o ID do recurso e deve ter 63 carateres ou menos, e corresponder ao formato descrito em https://google.aip.dev/122#resource-id-segments

Exemplo: projects/1234567890/locations/us-central1/conversations/my-conversation.

Recomendamos que ignore a definição deste campo durante a criação da conversa, uma vez que é inferido automaticamente e substituído por {parent}/conversations/{conversationId}.

agents[]

string

Obrigatório. Agentes na conversa. Atualmente, só é suportado um agente. Este campo é repetido para permitir o suporte futuro de vários agentes numa conversa. Formato: projects/{project}/locations/{location}/dataAgents/{agent}

createTime

string (Timestamp format)

Apenas saída. Data/hora de criação.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

lastUsedTime

string (Timestamp format)

Apenas saída. Data/hora da conversa usada mais recentemente.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Opcional. Etiquetas definidas pelo utilizador e de resposta livre que podem ser definidas pelo cliente para etiquetar uma conversa (por exemplo, para filtrar conversas por superfícies/produtos específicos).

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Métodos

create

Cria uma nova conversa para manter o histórico da conversa.

get

Obtém detalhes de uma única conversa através do ID da conversa e do elemento principal.

list

Apresenta todas as conversas de um determinado elemento principal.