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

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

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

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

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con 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. Es el nombre del archivo.
mimeType

string

Opcional. 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. Es el contenido del archivo. file puede ser solo uno de los siguientes:
fileContents

string (bytes format)

El contenido del archivo se proporciona intercalado.

Es una cadena codificada en base64.

Cuerpo de la respuesta

Respuesta del método AssistantService.AddContextFile.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

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

string

Es el nombre de la sesión, ya sea el proporcionado o el recién creado.

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 establecerá para todos los tipos de archivo y, finalmente, se quitará.

Es la longitud del archivo medida en tokens.

Permisos de autorización

Se necesita 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 Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • discoveryengine.sessions.addContextFile

Para obtener más información, consulta la documentación de IAM.