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

# Guía del agente

> El método woku y las dos herramientas meta con las que un agente aprende a usar woku: woku_guide y design_voc_program

Antes de operar el catálogo de herramientas, el agente cuenta con dos herramientas meta que no devuelven datos, sino que le enseñan a usar woku: `woku_guide`, que entrega el método y los playbooks, y `design_voc_program`, que propone un programa de escucha para tu viaje de cliente. Un buen agente las llama primero y actúa como consultor de experiencia: ayuda a diseñar, no solo ejecuta comandos.

## El método woku

Todo negocio es un viaje del cliente, y cada momento de la verdad decide si el cliente vuelve o se va. woku protege ingresos con la voz del cliente a partir de una idea simple:

1. En cada momento de la verdad se escucha con un instrumento rápido de responder (una calificación más un comentario en texto o audio, en menos de 60 segundos): NPS, CSAT, CES o un woku.
2. Cada señal desata una acción. Una sola señal se convierte en un **ticket de soporte** (atención individual, construido desde el historial del cliente). Varias señales recurrentes de distintos clientes se convierten en un **plan de acción** (mejora sistemática).
3. Los **trackers** son el tejido conector: segmentan los instrumentos por viaje, momento o localidad, y esa segmentación es la que rutea cada ticket al destino correcto y agrupa las señales en el plan correcto.

Así el ciclo se cierra: de lo operacional a lo táctico a lo estratégico.

## woku\_guide

Es la herramienta con la que conviene empezar. Devuelve, a demanda, cómo usar woku:

* Sin argumentos: el índice de temas, el método y las reglas para descubrir ids.
* Con `topic`: un playbook paso a paso para esa intención (la secuencia de herramientas con sus argumentos, de dónde sale cada id, las confirmaciones necesarias y las trampas comunes).
* Con `question` en lenguaje natural: elige el playbook que mejor calza.

También entrega las escalas (woku 1 a 5 estrellas, NPS 0 a 10, CSAT y CES 1 a 5) y las reglas de escritura. Es de solo lectura.

## design\_voc\_program

Propone un programa de escucha completo para tu empresa. Recibe, todo opcional, el tipo de negocio, los canales disponibles, los momentos propios de tu viaje y cómo querés segmentar, y devuelve un plano:

* El viaje con el instrumento recomendado en cada momento, partiendo de la plantilla canónica: venta con CSAT, entrega con woku, soporte con CES, posventa con woku, lealtad con NPS, adaptada a tu caso.
* El diseño de trackers por viaje, momento o localidad, con cómo cada dimensión rutea tickets y agrupa planes.
* El cableado de acciones (una señal a un ticket, señales recurrentes a un plan) y los pasos concretos, nombrando las herramientas `create_*` reales, para construirlo.

Es de solo lectura: propone. Nada se crea hasta que el usuario aprueba y el agente llama a las herramientas de escritura.

## Flujo recomendado

1. Llamá `woku_guide` para el método y los playbooks.
2. Mapeá el viaje del cliente con el usuario y usá `design_voc_program` para proponer el programa.
3. Construílo con las herramientas `create_*` una vez que el usuario aprueba, y distribuí los instrumentos con las herramientas `send_*`.
4. Después, deja que cada señal active su acción: tickets para la atención individual, planes para la mejora sistemática.