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

Carica un file di contesto da utilizzare come origine per le chiamate di assistenza all'interno della sessione.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome della risorsa della sessione. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

Se - viene specificato come ID sessione, viene creata una nuova sessione con un ID generato automaticamente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "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.
}
Campi
fileName

string

Obbligatorio. Nome del file.
mimeType

string

Facoltativo. Il tipo di contenuti del file, vedi https://www.iana.org/assignments/media-types/media-types.xhtml.

Questo campo è obbligatorio quando l'origine dati non fornisce il tipo di contenuti.
Campo unione file. I contenuti del file. file può essere solo uno dei seguenti tipi:
fileContents

string (bytes format)

Contenuti del file forniti in linea.

Una stringa con codifica in base64.

Corpo della risposta

Risposta per il metodo AssistantService.AddContextFile.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "session": string,
  "fileId": string,
  "tokenCount": string,
  "mimeType": string,
  "byteCount": string,
  "fileName": string
}
Campi
session

string

Il nome della sessione, quello fornito o quello appena creato.

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

string

L'ID del file caricato.
tokenCount
(deprecated)

string (int64 format)

Ritirato: questo campo non verrà impostato per tutti i tipi di file e verrà rimosso.

La lunghezza del file misurata in token.
mimeType

string

Solo output. Il tipo di contenuti risolto del file caricato, vedi https://www.iana.org/assignments/media-types/media-types.xhtml.

A differenza di AddContextFileRequest.mime_type facoltativo fornito dal chiamante, questo è il tipo di contenuti che il servizio ha effettivamente risolto per il file.
byteCount

string (int64 format)

Solo output. Le dimensioni del file caricato in byte.
fileName

string

Solo output. Il nome risolto del file caricato, inclusa l'estensione del file.

A differenza di AddContextFileRequest.file_name fornito dal chiamante, il servizio aggiunge l'estensione che corrisponde a mimeType risolto quando il nome fornito dal chiamante non ne ha, in modo che i log di audit sull'utilizzo acquisiscano il tipo di file anche per i file generati dall'AI con nomi generici.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • discoveryengine.sessions.addContextFile

Per saperne di più, consulta la documentazione di IAM.