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

Sube un archivo de contexto para usarlo como fuente para 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

Parámetros
name

string

Obligatorio. 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 la 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileContents": string
  // End of mutually exclusive fields.
}
Campos
fileName

string

Obligatorio. El nombre del archivo.
mimeType

string

Es 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.
El contenido del archivo. A continuación, se incluye una lista de campos mutuamente excluyentes. Se establecerá, como máximo, uno de los campos en una respuesta:
fileContents

string (bytes format)

Contenido del archivo proporcionado intercalado.

String codificada en base64.
Fin de los campos mutuamente excluyentes.

Cuerpo de la respuesta

Respuesta para el 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,
  "mimeType": string,
  "byteCount": string,
  "fileName": string
}
Campos
session

string

El nombre de la sesión, ya sea la proporcionada o la recién creada.

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

string

El ID del archivo subido.
tokenCount
(deprecated)

string (int64 format)

Obsoleto: Este campo no se establecerá para todos los tipos de archivos y, finalmente, se quitará.

La longitud del archivo medida en tokens.
mimeType

string

Solo salida. El tipo de contenido resuelto del archivo subido. Consulta https://www.iana.org/assignments/media-types/media-types.xhtml.

A diferencia de AddContextFileRequest.mime_type opcional proporcionado por el llamador, este es el tipo de contenido que el servicio resolvió para el archivo.
byteCount

string (int64 format)

Solo salida. El tamaño del archivo subido en bytes.
fileName

string

Solo salida. El nombre resuelto del archivo subido, incluida su extensión.

A diferencia de AddContextFileRequest.file_name proporcionado por el llamador, el servicio agrega la extensión que coincide con el mimeType resuelto cuando el nombre proporcionado por el llamador no tiene ninguno, por lo que los registros de auditoría de uso capturan el tipo de archivo incluso para los archivos generados por IA con nombres genéricos.

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.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.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.