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

Sube un archivo de contexto para usarlo como fuente de las llamadas de asistencia en la sesión.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Nombre de recurso de la sesión. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

Si se especifica - como ID de sesión, se crea una sesión con un ID generado automáticamente.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

Representación 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.
}
Campos
fileName

string

Obligatorio. El nombre del archivo.
mimeType

string

Opcional. El tipo de contenido del archivo. Consulta https://www.iana.org/assignments/media-types/media-types.xhtml.

Este campo es obligatorio cuando la fuente de datos no proporciona el tipo de contenido.
Campo de unión file. El contenido del archivo. file solo puede ser una de estas dos opciones:
fileContents

string (bytes format)

El contenido del archivo se proporciona de forma insertada.

Cadena codificada en base64.

Cuerpo de la respuesta

Respuesta del método AssistantService.AddContextFile.

Si la solicitud se realiza correctamente, el cuerpo de la respuesta proporciona datos con la siguiente estructura:

Representación JSON 
{
  "session": string,
  "fileId": string,
  "tokenCount": string
}
Campos
session

string

Nombre de la sesión, ya sea el proporcionado o el que se acaba de crear.

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

string

ID del archivo subido.
tokenCount
(deprecated)

string (int64 format)

Obsoleto: este campo no se definirá para todos los tipos de archivo y, con el tiempo, se eliminará.

La longitud del archivo medida en tokens.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta el Authentication Overview.

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso name:

  • discoveryengine.sessions.addContextFile

Para obtener más información, consulta la documentación de gestión de identidades y accesos.