Saltar a contenido

Comandos

Todos se lanzan desde cualquier carpeta del repositorio, con el .env exportado (set -a && . .env && set +a). Buscan el proyecto por su marcador, .taichatproject; con más de un chatbot en el repositorio, se elige con -p <nombre>.

Un comando que falla sale con código 1 y dice qué pasó y cómo arreglarlo.

tai-chat init

Crea un chatbot en el repositorio: <nombre>/ con la API, el asistente, el front, config.yaml y Docker, y database/ si no existe.

Pregunta el nombre (por defecto, chatbot) y las opciones de la autenticación de tai-api. Comprueba Poetry, npm, Graphviz y MAIN_DATABASE_URL antes de crear nada. Instala las dependencias de la API con Poetry, en el entorno activo, y las del front con npm ci. Genera los clientes de tai-sql de auth y chatbot en database/database/, que usa db push; no se conecta a la base de datos.

tai-chat db push

Lleva a la base de datos lo que declara el proyecto, en este orden:

  1. los schemas auth y chatbot (con tai-sql push);
  2. el schema context, con las tablas de la memoria del agente;
  3. los modelos de config.yaml, a la tabla modelo;
  4. los roles de api/rbac/<realm>.py;
  5. el usuario admin, si el realm no tiene ninguno.

Cada paso enseña lo que va a cambiar y pregunta. Repetirlo no cambia nada. Si falta el cliente de tai-sql de auth o de chatbot (un database/ que ya estaba, o un proyecto anterior), lo genera: tai-sql push solo genera cuando aplica cambios. Los demás schemas del repositorio se llevan con tai-chat sql push -s <schema>.

Opción
-p, --project El proyecto, si hay más de uno

tai-chat config

Sin subcomando, el menú de modelos (los enseña: se declaran en config.yaml), tarifas y bolsas. Escribe en la base de datos de MAIN_DATABASE_URL.

Opción
-p, --project El proyecto, si hay más de uno
-s, --schema El schema de las tablas. Por defecto, chatbot

tai-chat config generate

Valida config.yaml y escribe sus derivados. Si algo no es válido, no escribe nada y dice qué clave falla. Repetirlo no cambia nada.

tai-chat config check

Dice qué derivado no está al día, sin tocar nada. Sale con 1 si hay alguno, o si la autenticación generada no corresponde a auth.clave_de_firma.

tai-chat dev

Genera los derivados y levanta la API (http://localhost:8000) y el front (front.puerto, 4713 por defecto). La API se recarga al guardar.

No arranca si los puertos están ocupados, si falta una variable o si la autenticación generada está desfasada respecto a auth.clave_de_firma.

tai-chat dev La API y el front
tai-chat dev api Solo la API
tai-chat dev app Solo el front
-d, --detach En segundo plano
tai-chat dev logs [api\|app] Los logs de lo que está en segundo plano
tai-chat dev stop [api\|app] Para lo que está en segundo plano. Sale con 1 si no había nada

tai-chat feedback

Un informe de las valoraciones con comentario, para entender de dónde sale cada queja. Lee la vista valoracion, los mensajes y la tabla tool_call; un proyecto anterior a la vista tiene que añadirla (Migraciones). Las valoraciones sin comentario no tienen ficha: se cuentan en el resumen del principio, separadas en quejas y positivas.

Cuenta la hora de la valoración, no la de la respuesta. Sin --from ni --to, el informe empieza justo después de la última valoración del anterior (lo apunta en .taichatproject), así que dos seguidos ni repiten ni se saltan ninguna: una respuesta de la semana pasada valorada hoy sale en el de hoy. Quien cambia su valoración la vuelve a sacar en el siguiente, con lo nuevo. La marca sale de la propia base, no del reloj de quien lo lanza, y solo avanza si hubo valoraciones.

  • Arriba, un índice: una fila por valoración, con quién, cuándo, si es una queja o positiva, el comentario y la conversación. Cada fila lleva a su ficha.
  • Una ficha por valoración, agrupadas por conversación (primero las que tienen quejas):
  • el comentario;
  • la pregunta;
  • la respuesta valorada, entera, y debajo, plegadas, las herramientas que usó: su nombre y lo que tardó, como en el laboratorio, y si falló. Las de un sub-agente van anidadas bajo la herramienta que lo creó. Es lo que dice si el problema está en la herramienta, en los datos o en el modelo;
  • cómo se respondió: el modelo, las vueltas, los tokens y el tiempo;
  • en un desplegable, la conversación anterior: las preguntas y respuestas que había antes, como mucho cinco, cada respuesta con sus herramientas plegadas. En una conversación con varias valoraciones, cada una empieza donde acabó la anterior: no se repite.

El HTML es el más cómodo de leer: los desplegables se abren y las respuestas se ven como en el chat, con sus tablas. Se abre sin conexión. El PDF no lleva la conversación anterior.

Opción
-o, --output Ruta o carpeta de salida. Por defecto, reports/ del proyecto
-f, --format md (por defecto), html, pdf, both (md y pdf) o all (los tres). El PDF necesita pip install "tai-chat[pdf]"
-u, --username Solo las de un usuario
--from, --to Las valoradas entre dos fechas (--to incluye el día entero). Con ellas, la marca no se mueve
-s, --schema El schema de los mensajes. Por defecto, chatbot
-p, --project El proyecto, si hay más de uno

tai-chat consumo

Un informe del consumo y su coste, para quien mantiene el chatbot: en qué se gasta y por qué. Solo lee la base de datos.

  • Cuánto y en qué: tokens y coste por día, mes, usuario, modelo y origen (la respuesta, los sub-agentes, el título y el resumen del historial), el coste medio de una respuesta, y cómo van las bolsas y, si el informe es de un mes, el límite de cada usuario.
  • De qué se compone una respuesta: las partes de su entrada (instrucciones, definiciones de herramientas, contexto, resultados de herramientas anteriores, pregunta, ronda) y de su salida (texto, llamadas a herramientas, razonamiento). Ver El consumo.
  • La caché, las llamadas y las herramientas: cuánto de la entrada salió de la caché del proveedor, cuántas llamadas al modelo hace cada respuesta y qué herramientas las provocan. Las de un sub-agente van con la herramienta que lo creó (contar_pedidos (en investigar)).
  • Lo más caro: las respuestas y conversaciones de más coste, con su desglose, quién y cuándo, y el principio de la pregunta. Nunca el contenido de la respuesta.
  • Avisos: lo que suele tener arreglo, como un contexto que pasa de la mitad de la entrada o unas definiciones de herramientas que pesan más del 20 %.

En la terminal deja además un resumen: el total, el coste y los avisos. El coste lo calculan las vistas consumo_apunte y consumo_parte, como las que facturan, con la tarifa con la que se apuntó cada consumo; uno sin tarifa se cuenta en tokens y se avisa. Un proyecto anterior a esas vistas tiene que añadirlas (Migraciones).

Opción
-o, --output Ruta o carpeta de salida. Por defecto, reports/ del proyecto
-f, --format md (por defecto), html, pdf o all. El HTML lleva las gráficas y se abre sin conexión; el PDF necesita pip install "tai-chat[pdf]"
--from, --to Entre dos fechas. Por defecto, el mes en curso
-u, --username Solo un usuario
-m, --modelo Solo un modelo, por su alias
--top Cuántas respuestas y conversaciones caras enseñar. Por defecto, 10
-s, --schema El schema del consumo. Por defecto, chatbot
-p, --project El proyecto, si hay más de uno
tai-chat consumo                                  # el mes en curso, en Markdown
tai-chat consumo --from 2026-09-01 -f html        # desde septiembre, con gráficas
tai-chat consumo -u ana -m rapido -f all          # lo de un usuario con un modelo, en los tres

tai-chat rules

Instala en el repositorio las reglas para asistentes de IA (Claude Code y compatibles) de la versión de tai-chat instalada: cómo funciona el chatbot, cómo se escriben las herramientas, el front y qué falla. Y una derivada de este proyecto, proyecto.md, con su prompt, sus modelos y sus herramientas: qué lee cada una y si lo lee como el usuario.

tai-chat rules install          # instala o actualiza
tai-chat rules install --force  # también lo editado a mano
tai-chat rules check            # ¿están al día? Sale con 1 si no, para el CI
tai-chat rules diff             # en qué se diferencian

Van a <raíz>/.claude/rules/_platform/tai-chat/, junto a las de tai-sql y tai-api, que se instalan con tai-chat sql rules install y tai-chat api rules install: el asistente necesita las tres. No se editan: se regeneran. Ningún otro comando las escribe; config generate y dev avisan si se han quedado atrás.

Opción
-p, --project El proyecto, si hay más de uno

tai-chat sql … y tai-chat api …

Los CLI de tai-sql y tai-api, resueltos contra el proyecto: funcionan desde cualquier carpeta.

tai-chat sql push -s mantenimiento
tai-chat api generate
tai-chat api generate -s mantenimiento
tai-chat api rbac push -r chatbot

Sus opciones son las de cada librería: ver la documentación de tai-sql y tai-api.