Listar la base de conocimiento

Muestra los documentos de la base de conocimiento del workspace: los archivos que usan los agentes de IA para responder. De cada documento indica a qué agente pertenece, en cuántos fragmentos se dividió y si se procesó con error. También funciona como plazbot kb list.

bash

01plazbot knowledge list [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Agente	`-a, --agent <agentId>`	No	Solo los documentos de un agente de IA (`age_...`).
Workspace	`-w, --workspace <id>`	No	Workspace donde se ejecuta. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona de la sesión.
JSON	`--json`	No	Imprime el resultado como JSON.

Los fragmentos (los trozos de texto indexados) no se imprimen: el CLI los cuenta en fragmentsCount. Con --json la salida es { "data": [...], "nextCursor": null }.

Ejemplos

bash

01# Todos los documentos
02plazbot knowledge list
03 
04# Documentos de un agente
05plazbot knowledge list -a age_AbcDef123
06 
07# Documentos que fallaron al procesarse
08plazbot knowledge list --json | jq '.data[] | select(.errorMessage)'

Resultado

text

01  Knowledge base (2)
02  ────────────────────────────────────────
03┌───────────────┬──────────────────┬───────────────┬───────────┬───────────────────────┬──────────────────┐
04│ ID            │ File             │ Agent         │ Fragments │ State                 │ Updated          │
05├───────────────┼──────────────────┼───────────────┼───────────┼───────────────────────┼──────────────────┤
06│ kwl_AbcDef123 │ precios-2026.pdf │ age_AbcDef123 │ 14        │ 2                     │ 2026-09-18 11:20 │
07├───────────────┼──────────────────┼───────────────┼───────────┼───────────────────────┼──────────────────┤
08│ kwl_GhiJkl456 │ manual.docx      │ age_AbcDef123 │ 0         │ error: File too large │ 2026-09-20 08:05 │
09└───────────────┴──────────────────┴───────────────┴───────────┴───────────────────────┴──────────────────┘

Columna	Descripción
ID	ID del documento.
File	Nombre del archivo, o su referencia si no tiene archivo.
Agent	Agente al que pertenece.
Fragments	Fragmentos indexados.
State	Estado de procesamiento, o `error: <mensaje>` si falló.
Updated	Última actualización (UTC).

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "kwl_AbcDef123",
05      "workspaceId": "wok_AbcDef123",
06      "agentId": "age_AbcDef123",
07      "reference": "Lista de precios 2026",
08      "fileName": "precios-2026.pdf",
09      "fileUrl": "https://...",
10      "tags": ["precios"],
11      "stateId": 2,
12      "errorMessage": null,
13      "fileHash": "...",
14      "creationDate": "2026-09-18T11:20:00Z",
15      "updateDate": "2026-09-18T11:20:00Z",
16      "fragmentsCount": 14
17    }
18  ],
19  "nextCursor": null
20}

Para administrar los archivos de un agente usa plazbot agent files.

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.