Saltar al contenido principal
POST
CSharp (SDK)

Autorizaciones

Authorization
string
header
requerido

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

vector_store_id
string
requerido

El ID del almacén de vectores para el cual crear un lote de archivos.

Cuerpo

application/json

Cuerpo de la solicitud para crear un lote de archivo de almacenamiento de vectores.

file_ids
string[]

Una lista de IDs de archivo que el almacén vectorial debe usar. Si se proporcionan attributes o chunking_strategy en el nivel raíz, se aplicarán a todos los archivos del lote. Mutuamente excluyente con 'files'. Como máximo 500 por lote.

Maximum array length: 500
files
object[]

Una lista de objetos que cada uno incluye un file_id más atributos opcionales o chunking_strategy. Use esto cuando necesite anular los metadatos de archivos específicos. Las entradas sin sus propios atributos o chunking_strategy recurren a los valores a nivel de la solicitud. Mutuamente excluyente con 'file_ids'. Como máximo 500 por lote.

Maximum array length: 500
attributes
object

Atributos predeterminados para todo el lote, aplicados a cada archivo que no tenga los suyos propios (los atributos de una entrada de «files» los anulan).

chunking_strategy
object

Estrategia de segmentación predeterminada para todo el lote, aplicada a todos los archivos que no tengan la suya propia (la estrategia de segmentación de una entrada de «files» la anula).

skip_duplicates
boolean
predeterminado:false

Cuando un archivo tiene el mismo contenido (SHA-256) que un archivo que el almacén ya tiene, o que un archivo anterior en este lote, omítelo en lugar de rechazar el lote. A un archivo omitido se le asigna una fila cancelada cuyo last_error es duplicate_file y nombra el archivo que contiene el contenido. Valor predeterminado: false; un duplicado hace fallar todo el lote con 409 y no se adjunta nada.

Respuesta

200 - application/json

Está bien

Un lote de archivos adjuntos a un almacén de vectores.

id
string
requerido

El identificador, que se puede referenciar en los puntos finales de la API.

object
any
requerido

El tipo de objeto, que siempre es 'vector_store.file_batch'.

created_at
integer
requerido

La marca de tiempo de Unix (en segundos) para cuando se creó el lote de archivos del almacén de vectores.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
vector_store_id
string
requerido

La ID del almacén de vectores al que está adjunto el archivo.

status
enum<string>
requerido

El estado de los archivos del lote de la tienda de vectores. 'en_progreso' significa que los archivos están siendo procesados, 'completado' significa que todos los archivos han sido procesados, 'cancelado' significa que el lote fue cancelado, 'fallido' significa que el lote falló.

Opciones disponibles:
in_progress,
completed,
cancelled,
failed
file_counts
object
requerido

Conteos de estado de procesamiento de archivos.