Skip to main content
POST
Dar de alta una base de conocimiento

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.

Body

application/json

Un nombre y los archivos ya subidos. Cero bytes: lo que viaja son referencias a objetos que ya están en el almacén y ya se verificaron.

name
string
required
Required string length: 1 - 120
uploadIds
string<uuid>[]
required

De 1 a 25 archivos confirmados, sin repetir. El mínimo no es cosmético: el proveedor rechaza una base sin fuentes, así que nace con al menos un documento o no nace. El máximo es el tope del namespace knowledge-sources.

Required array length: 1 - 25 elements
description
string
Maximum string length: 500

Response

Aceptada. La base existe con sus documentos y la ingesta está encolada; el proveedor todavía no la conoce, así que documentCount y totalSizeBytes vienen en cero hasta que él los reporte.

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