REST Resource: projects.locations.conversations

Recurso: Conversation

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 de recurso exclusivo de uma conversa. Formato: projects/{project}/locations/{location}/conversations/{conversationId} {conversationId} é o ID do recurso. Ele pode ter até 63 caracteres e precisa seguir o formato descrito em https://google.aip.dev/122#resource-id-segments (link em inglês).

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

Recomendamos pular a definição desse campo durante a criação da conversa, porque ele será inferido automaticamente e substituído por {parent}/conversations/{conversationId}.

agents[]

string

Obrigatório. Agente(s) na conversa. No momento, apenas um agente é aceito. Esse campo é repetido para permitir o suporte futuro de vários agentes em uma conversa. Formato: projects/{project}/locations/{location}/dataAgents/{agent}

createTime

string (Timestamp format)

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

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. 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. Carimbo de data/hora da última conversa usada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. 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. Rótulos abertos e definidos pelo usuário que podem ser definidos pelo cliente para marcar uma conversa (por exemplo, para filtrar conversas em plataformas/produtos específicos).

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

Métodos

create

Cria uma conversa para manter o histórico.

get

Busca os detalhes de uma única conversa usando o ID da conversa e o pai.

list

Lista todas as conversas de um determinado pai.