> ## 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.

# colme-2

> La nueva generación del agente de Whaapy para conversaciones, operaciones y automatización en WhatsApp

# colme-2

`colme-2` es la nueva generación del agente de Whaapy.

No es una pantalla nueva ni un endpoint adicional. Es la base que permite que el agente responda, recuerde, use herramientas, escale a humanos y opere dentro de WhatsApp con más control.

<Info>
  `colme-2` corre detrás de Whaapy. Tú sigues usando el dashboard, la API pública en `https://api.whaapy.com` y los mismos flujos de WhatsApp.
</Info>

***

## Por qué existe

Los agentes de negocio no fallan solo porque el modelo "no sepa". Fallan cuando el sistema le pide al modelo que recuerde demasiadas reglas a la vez:

* cuándo responder y cuándo callarse
* cuándo transferir a un humano
* qué datos puede usar
* qué acciones puede ejecutar
* cómo manejar varios mensajes seguidos
* cómo evitar respuestas enormes o fuera de contexto
* cómo mantener una conversación larga sin perder el hilo

`colme-1` permitió crear la primera generación de agentes en Whaapy. `colme-2` existe porque la siguiente etapa necesitaba menos dependencia de prompts gigantes y más comportamiento controlado por producto.

En términos simples: `colme-2` mueve decisiones críticas del texto del prompt al sistema que ejecuta el agente.

***

## Qué resuelve

<CardGroup cols={2}>
  <Card title="Control real" icon="sliders">
    La IA puede activarse, pausarse, apagarse o ceder la conversación a humanos sin depender solo de instrucciones escritas.
  </Card>

  <Card title="Mejor contexto" icon="brain">
    El agente puede usar memoria, knowledge base y mensajes recientes sin cargar toda la conversación de forma ingenua.
  </Card>

  <Card title="Herramientas operativas" icon="wrench">
    El agente puede apoyarse en tools para consultar datos, ejecutar acciones o disparar automatizaciones del negocio.
  </Card>

  <Card title="Aislamiento por negocio" icon="building-lock">
    Cada negocio tiene su configuración, conocimiento, permisos y comportamiento sin mezclarse con otros negocios.
  </Card>

  <Card title="Handoff más claro" icon="people-arrows">
    Cuando un humano toma el control, la IA puede detenerse o quedar en pausa para evitar dobles respuestas.
  </Card>

  <Card title="Base para escalar" icon="chart-line">
    La arquitectura permite crecer en volumen, herramientas, subagentes y conectores sin rehacer el agente desde cero.
  </Card>
</CardGroup>

***

## Cómo se ve desde fuera

Desde el punto de vista del usuario, el flujo sigue siendo simple:

```mermaid theme={null}
flowchart LR
    customer["Cliente en WhatsApp"] --> whatsapp["WhatsApp"]
    whatsapp --> whaapy["Whaapy"]
    whaapy --> agent["Agente colme-2"]
    agent --> knowledge["Knowledge"]
    agent --> tools["Tools"]
    agent --> subagents["Subagents"]
    agent --> mcps["MCPs"]
    agent --> human["Equipo humano"]
    agent --> whatsapp
```

El cliente escribe por WhatsApp. Whaapy recibe el mensaje, decide si la IA debe responder, prepara el contexto correcto y deja que el agente actúe con las capacidades configuradas para ese negocio.

Si el agente necesita información, consulta `Knowledge`. Si necesita ejecutar una acción, usa `Tools` o `MCPs`. Si el caso requiere una responsabilidad especializada, puede apoyarse en `Subagents`. Si debe intervenir una persona, se transfiere o pausa la IA según la configuración.

***

## Qué cambia para el usuario

### Menos prompt magic

Antes era común meter demasiadas reglas en el prompt principal:

```text theme={null}
Si el cliente pide humano, transfiere. Si pregunta precio, busca catálogo.
Si manda varios mensajes, espera. Si no sabes, no inventes. Si...
```

Eso escala mal. El prompt termina mezclando tono, políticas, conocimiento, herramientas y control operativo.

Con `colme-2`, cada cosa vive donde corresponde:

| Necesidad                     | Dónde se configura |
| ----------------------------- | ------------------ |
| Cuándo responde la IA         | `Control`          |
| Qué sabe del negocio          | `Knowledge`        |
| Qué puede hacer               | `Tools`            |
| Qué tareas delega             | `Subagents`        |
| Qué sistemas externos conecta | `MCPs`             |

### Mejor convivencia con humanos

La IA no debería pelear con tu equipo. `colme-2` está pensado para que un humano pueda intervenir sin que el agente siga contestando encima.

Puedes configurar pausas, apagado por conversación, keywords de handoff y reglas para desactivar la IA cuando una persona toma control.

### Mejor manejo de conversaciones reales

En WhatsApp la gente no escribe en un solo mensaje perfecto. Manda frases cortas, corrige, agrega contexto y cambia de idea.

`colme-2` está diseñado para trabajar con esa realidad:

* puede agrupar mensajes cercanos antes de responder
* puede partir respuestas largas
* puede respetar pausas humanas
* puede usar memoria conversacional
* puede operar con conocimiento y herramientas sin meter todo en un prompt

***

## Qué no es colme-2

<Warning>
  `colme-2` no es una API pública nueva. No debes llamar directo al motor interno ni configurar infraestructura para usarlo.
</Warning>

`colme-2` tampoco reemplaza los endpoints de mensajes. Si integras Whaapy por API, sigues usando la referencia pública de mensajes, media, webhooks y control de IA.

Lo que cambia es la capacidad del agente que vive dentro de Whaapy.

***

## Cómo configurarlo

Empieza por estas guías:

<CardGroup cols={2}>
  <Card title="Control" icon="sliders" href="/guides/agent-control">
    Define cuándo responde la IA, cuándo se pausa y cómo convive con humanos.
  </Card>

  <Card title="Knowledge" icon="book-open" href="/guides/agent-knowledge">
    Alimenta al agente con documentos, FAQs, políticas y contexto del negocio.
  </Card>

  <Card title="Tools" icon="wrench" href="/guides/agent-tools">
    Habilita acciones reales como agenda, catálogo, triggers y handoff.
  </Card>

  <Card title="Subagents" icon="diagram-project" href="/guides/agent-subagents">
    Divide responsabilidades en agentes especializados por tarea.
  </Card>

  <Card title="MCPs" icon="plug" href="/guides/agent-mcps">
    Conecta sistemas externos como fuentes o acciones controladas.
  </Card>

  <Card title="Control vía API" icon="code" href="/api-reference/agent/overview">
    Pausa o desactiva la IA desde tus integraciones.
  </Card>
</CardGroup>

***

## La idea central

`colme-2` convierte al agente de Whaapy en algo más cercano a una capa operativa del negocio:

* conversa con clientes
* entiende reglas del negocio
* usa conocimiento actualizado
* ejecuta acciones permitidas
* escala a humanos cuando toca
* convive con integraciones externas

El objetivo no es que la IA "suene inteligente". El objetivo es que sea útil, controlable y confiable dentro de conversaciones reales de WhatsApp.