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:
- los schemas
authychatbot(contai-sql push); - el schema
context, con las tablas de la memoria del agente; - los modelos de
config.yaml, a la tablamodelo; - los roles de
api/rbac/<realm>.py; - 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.