Skip to main content
POST
Añadir documentos a una base existente

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-workspace-id
string<uuid>
required

Identificador del workspace multi-tenant.

Path Parameters

knowledgeBaseId
string<uuid>
required

Identificador de la base en Agents Studio.

Body

application/json

Los archivos que se le añaden a una base que ya existe. Cero bytes, igual que en el alta: lo que viaja son referencias a objetos que ya están en el almacén y ya se verificaron.

uploadIds
string<uuid>[]
required

De 1 a 25 archivos confirmados, sin repetir. El máximo acota el lote; el tope de verdad es por base y se comprueba contra los documentos que ya tiene.

Required array length: 1 - 25 elements

Response

Aceptado. Los documentos están escritos y la base quedó en syncing; el indexado ocurre después.

id
string<uuid>
required

Identificador de la base en Agents Studio. La referencia interna del proveedor no se publica.

name
string
required
description
string
required
status
enum<string>
required

queued: dada de alta, todavía no existe en el proveedor. syncing: el proveedor la está indexando. ready: el agente ya puede consultarla. error: el indexado falló, y errorMessages dice por qué.

Available options:
queued,
syncing,
ready,
error
documentCount
integer
required
totalSizeBytes
integer
required
agentCount
integer
required

Cuántos agentes del workspace consultan esta base. Cuenta agentes, no conexiones: un agente con dos conexiones a la misma base suma uno.

Cero significa que ninguno la consulta, y por tanto que retirarla no cambia el comportamiento de nadie.

documents
object[]
required

Vacío en el listado a propósito. Los documentos los tiene el proveedor y traerlos costaría una llamada por elemento de la página. Vienen en el detalle.

errorMessages
string[]
required

Vacío salvo que status sea error.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required