# Listar la base de conocimiento

> plazbot knowledge list: documentos de la base de conocimiento que usan los agentes de IA.

Fuente: https://developers.plazbot.com/cli/knowledge/list/

### 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
plazbot 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
# Todos los documentos
plazbot knowledge list

# Documentos de un agente
plazbot knowledge list -a age_AbcDef123

# Documentos que fallaron al procesarse
plazbot knowledge list --json | jq '.data[] | select(.errorMessage)'
```

### Resultado

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

| 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
{
"data": [
  {
    "id": "kwl_AbcDef123",
    "workspaceId": "wok_AbcDef123",
    "agentId": "age_AbcDef123",
    "reference": "Lista de precios 2026",
    "fileName": "precios-2026.pdf",
    "fileUrl": "https://...",
    "tags": ["precios"],
    "stateId": 2,
    "errorMessage": null,
    "fileHash": "...",
    "creationDate": "2026-09-18T11:20:00Z",
    "updateDate": "2026-09-18T11:20:00Z",
    "fragmentsCount": 14
  }
],
"nextCursor": null
}
```

Para administrar los archivos de un agente usa [`plazbot agent files`](https://developers.plazbot.com/cli/agent/files).

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |