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,
    ...
  }
}
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/us-central1/conversations/my-conversation.

Es wird empfohlen, dieses Feld beim Erstellen der Unterhaltung nicht festzulegen, da es automatisch abgeleitet und mit {parent}/conversations/{conversationId} überschrieben wird.

agents[]

string

Pflichtangabe. 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" }.

Methoden

create

Erstellt eine neue Unterhaltung, um den Unterhaltungsverlauf beizubehalten.

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.