REST Resource: projects.locations.conversations

Ressource: Unterhaltung

Nachricht für eine Unterhaltung.

JSON-Darstellung 
{
  "name": string,
  "agents": [
    string
  ],
  "createTime": string,
  "lastUsedTime": string,
  "labels": {
    string: string,
    ...
  },
  "kmsKey": string,
  "memoryPaused": boolean
}
Felder
name

string

Optional. ID. Der eindeutige Ressourcenname einer Unterhaltung. Format: projects/{project}/locations/{location}/conversations/{conversationId}. {conversationId} ist die Ressourcen-ID. Sie darf maximal 63 Zeichen lang sein und muss dem Format entsprechen, das unter https://google.aip.dev/122#resource-id-segments beschrieben wird.

Beispiel: projects/1234567890/locations/global/conversations/my-conversation.

Es wird empfohlen, dieses Feld bei der Erstellung von Unterhaltungen nicht festzulegen, da es automatisch abgeleitet und mit {parent}/conversations/{conversationId} überschrieben wird.
agents[]

string

Erforderlich. KI-Agent(en) in der Unterhaltung. Derzeit wird nur ein KI-Agent unterstützt. Dieses Feld wird wiederholt, um in Zukunft mehrere KI-Agenten in einer Unterhaltung zu unterstützen. Format: projects/{project}/locations/{location}/dataAgents/{agent}
createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der Erstellung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
lastUsedTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der zuletzt verwendeten Unterhaltung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Optional. Offene und benutzerdefinierte Labels, die vom Client festgelegt werden können, um eine Unterhaltung zu kennzeichnen (z. B. um Unterhaltungen nach bestimmten Oberflächen/Produkten zu filtern).

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
kmsKey

string

Optional. Vom Kunden verwalteter Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK), der zum Verschlüsseln der Konversationsressourcen verwendet werden soll. Die Verschlüsselung erfolgt auf der Titan-Ebene. Wir übergeben den KMS-Schlüssel an Titan.

Format: projects/{projectId}/locations/{location}/keyRings/{key_ring_name}/cryptoKeys/{key_name}.
memoryPaused

boolean

Optional. Gibt an, ob Memory für diese Unterhaltung pausiert ist.

Methoden

create

 Erstellt eine neue Unterhaltung, um den Unterhaltungsverlauf beizubehalten.

delete

 Löscht eine Unterhaltung.

get

 Ruft Details zu einer einzelnen Unterhaltung anhand der Unterhaltungs-ID und des übergeordneten Elements ab.

list

 Listet alle Unterhaltungen für ein bestimmtes übergeordnetes Element auf.