> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whaapy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar Knowledge

> Cómo alimentar al agente con documentos, políticas, FAQs y contexto del negocio

# Configurar Knowledge

La tab `Knowledge` contiene la información que el agente puede consultar para responder con contexto del negocio.

Úsala para sacar información estable del prompt principal y convertirla en una base consultable: servicios, políticas, FAQs, procesos, precios simples, condiciones, cobertura y documentos comerciales.

***

## Qué debe ir en Knowledge

<CardGroup cols={2}>
  <Card title="FAQs" icon="circle-question">
    Preguntas frecuentes, respuestas aprobadas y dudas comunes.
  </Card>

  <Card title="Políticas" icon="shield-check">
    Cambios, devoluciones, garantías, cancelaciones y términos de servicio.
  </Card>

  <Card title="Servicios" icon="briefcase">
    Qué ofrece el negocio, cómo se vende, duración, requisitos y restricciones.
  </Card>

  <Card title="Procesos" icon="list-check">
    Pasos para cotizar, agendar, comprar, renovar, reclamar o recibir soporte.
  </Card>

  <Card title="Catálogos simples" icon="tags">
    Listas pequeñas o medianas de productos con información estable.
  </Card>

  <Card title="Contexto de marca" icon="message-smile">
    Tono, estilo, promesas permitidas y cosas que el agente debe evitar.
  </Card>
</CardGroup>

<Warning>
  No uses Knowledge como base de datos viva. Inventario en tiempo real, pedidos, disponibilidad o datos privados de clientes deben ir por [Tools](/guides/agent-tools) o [MCPs](/guides/agent-mcps).
</Warning>

***

## Cómo subir documentos

<Steps>
  <Step title="Prepara el documento">
    Divide la información por tema. Un documento claro sobre "política de cambios" funciona mejor que un PDF enorme con todo mezclado.
  </Step>

  <Step title="Ponle un nombre descriptivo">
    Usa nombres como `Politica de cambios`, `Servicios dentales`, `Preguntas frecuentes de envios` o `Catalogo basico 2026`.
  </Step>

  <Step title="Agrega descripción de uso">
    Explica cuándo debe usarlo el agente. Por ejemplo: "Usar cuando el cliente pregunte por envíos, tiempos de entrega o zonas de cobertura".
  </Step>

  <Step title="Sube el archivo">
    Carga el documento desde la tab `Knowledge` o desde SDK/API si tu integración lo permite.
  </Step>

  <Step title="Prueba con preguntas reales">
    Haz preguntas como las haría un cliente. Ajusta el documento si el agente responde ambiguo.
  </Step>
</Steps>

***

## Formato recomendado

Los mejores documentos son directos, estructurados y explícitos.

### Bueno

```md theme={null}
# Politica de cambios

Los cambios se aceptan dentro de los primeros 15 dias despues de la compra.
El producto debe estar sin uso y con empaque original.

No aplican cambios en productos personalizados.

Si el cliente quiere hacer un cambio:
1. Pedir numero de pedido.
2. Confirmar fecha de compra.
3. Explicar que soporte revisara el caso.
```

### Malo

```md theme={null}
Somos una empresa comprometida con la satisfaccion del cliente.
Dependiendo del caso se puede revisar la situacion y buscar alternativas.
```

El segundo ejemplo suena bien, pero no le da reglas operativas al agente.

***

## Descripciones útiles

| Documento              | Descripción útil                                                           |
| ---------------------- | -------------------------------------------------------------------------- |
| `Horarios`             | Usar cuando pregunten por horarios, dias festivos o disponibilidad general |
| `Precios`              | Usar cuando pregunten por costos aproximados, paquetes o planes            |
| `Politica de garantia` | Usar cuando el cliente mencione fallas, cambios, devoluciones o garantia   |
| `Servicios`            | Usar para explicar servicios, requisitos, duracion y beneficios            |

Evita descripciones como:

```text theme={null}
Documento importante
Info general
Usar siempre
```

***

## Cuándo actualizar Knowledge

Actualiza Knowledge cuando cambie algo que el agente pueda prometer:

* precios
* horarios
* cobertura
* requisitos
* políticas
* servicios activos
* tiempos de entrega
* condiciones legales o comerciales

<Tip>
  Si una respuesta incorrecta puede causar costo, promesa falsa o mala experiencia, esa información debe estar documentada y actualizada.
</Tip>

***

## Knowledge vs Prompt vs Tools

| Necesidad                     | Mejor lugar                    |
| ----------------------------- | ------------------------------ |
| Tono del agente               | Prompt o configuración general |
| Reglas de cuándo responder    | `Control`                      |
| FAQs y políticas              | `Knowledge`                    |
| Inventario actualizado        | `Tools` o `MCPs`               |
| Consultar pedido de cliente   | `Tools` o `MCPs`               |
| Agendar cita                  | `Tools`                        |
| Flujo especializado de ventas | `Subagents`                    |

***

## Errores comunes

| Error                              | Resultado                       | Mejor enfoque                    |
| ---------------------------------- | ------------------------------- | -------------------------------- |
| Subir un PDF enorme sin estructura | Respuestas ambiguas             | Divide por tema                  |
| No poner descripción               | El agente no sabe cuándo usarlo | Describe el caso de uso          |
| Meter datos vivos                  | Respuestas desactualizadas      | Usa Tools o MCPs                 |
| Contradecir el prompt              | Comportamiento inconsistente    | Alinea prompt y documentos       |
| No probar preguntas reales         | Falsos positivos                | Prueba con conversaciones reales |

***

## Siguiente paso

Cuando Knowledge ya esté limpia, conecta acciones:

<CardGroup cols={2}>
  <Card title="Tools" icon="wrench" href="/guides/agent-tools">
    Permite que el agente consulte o ejecute acciones reales.
  </Card>

  <Card title="Subagents" icon="diagram-project" href="/guides/agent-subagents">
    Separa ventas, soporte, agenda o seguimiento en flujos especializados.
  </Card>
</CardGroup>