Method: projects.locations.collections.engines.sessions.addContextFile

Lädt eine Kontextdatei hoch, die als Quelle für die Assist-Aufrufe in der Sitzung verwendet werden soll.

HTTP-Anfrage

POST https://discoveryengine.googleapis.com/v1/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}:addContextFile

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname der Sitzung. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

Wenn - als Sitzungs-ID angegeben wird, wird eine neue Sitzung mit einer automatisch generierten ID erstellt.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "fileName": string,
  "mimeType": string,

  // Union field file can be only one of the following:
  "fileContents": string
  // End of list of possible types for union field file.
}
Felder
fileName

string

Erforderlich. Der Name der Datei.
mimeType

string

Optional. Der Inhaltstyp der Datei. Weitere Informationen finden Sie unter https://www.iana.org/assignments/media-types/media-types.xhtml.

Dieses Feld ist erforderlich, wenn der Inhaltstyp nicht in der Datenquelle angegeben ist.
Union-Feld file. Der Inhalt der Datei. Für file ist nur einer der folgenden Werte zulässig:
fileContents

string (bytes format)

Der Dateiinhalt wird inline bereitgestellt.

Ein base64-codierter String.

Antworttext

Antwort für die Methode AssistantService.AddContextFile.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "session": string,
  "fileId": string,
  "tokenCount": string
}
Felder
session

string

Der Name der Sitzung, entweder der angegebene oder der neu erstellte.

Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}
fileId

string

Die ID der hochgeladenen Datei.
tokenCount
(deprecated)

string (int64 format)

Verworfen: Dieses Feld wird nicht für alle Dateitypen festgelegt und wird demnächst entfernt.

Die Länge der Datei in Tokens.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • discoveryengine.sessions.addContextFile

Weitere Informationen finden Sie in der IAM-Dokumentation.