REST Resource: projects.locations.conversations

Ressource : Conversation

Message pour une conversation.

Représentation JSON
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  }
}
Champs
name

string

Facultatif. Identifiant. Nom de ressource unique d'une conversation. Format : projects/{project}/locations/{location}/conversations/{conversationId} {conversationId} correspond à l'ID de ressource. Il doit contenir 63 caractères au maximum et respecter le format décrit sur la page https://google.aip.dev/122#resource-id-segments.

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

Il est recommandé de ne pas définir ce champ lors de la création de la conversation, car il sera déduit automatiquement et remplacé par {parent}/conversations/{conversationId}.

agents[]

string

Obligatoire. Agent(s) dans la conversation. Pour le moment, un seul agent est accepté. Ce champ est affiché plusieurs fois afin de permettre, à terme, la prise en charge de plusieurs agents dans une même conversation. Format : projects/{project}/locations/{location}/dataAgents/{agent}

createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de création.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

lastUsedTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière conversation utilisée.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "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)

Facultatif. Étiquettes ouvertes et définies par l'utilisateur que le client peut définir pour taguer une conversation (par exemple, pour filtrer les conversations pour des surfaces/produits spécifiques).

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Méthodes

create

Crée une conversation pour conserver l'historique des conversations.

get

Récupère les informations d'une seule conversation à l'aide de l'ID de conversation et du parent.

list

Liste toutes les conversations d'un parent donné.