Migraciones¶
Lo que tai-chat init copia (el back, el front, config.yaml, los roles) es del proyecto desde
ese momento: una versión nueva de tai-chat no lo toca. Este fichero dice, versión a versión, qué
tiene que hacer un proyecto ya creado para tener lo nuevo, y qué pasa si no lo hace.
Los comandos se lanzan con el .env exportado (set -a && . .env && set +a), desde cualquier
punto del repositorio.
Copiar una tabla con su título, para Word y Excel¶
Qué cambia: cada tabla de una respuesta tiene, junto a «CSV», un botón «Copiar» que la lleva con su título (el encabezado de encima y los que lo contienen) en HTML, para pegarla en Word o Excel con sus bordes, y en texto separado por tabuladores. El «Copiar» de una respuesta del asistente la copia también en HTML, con sus títulos y sus tablas. En móvil, los botones de la tabla se ven sin pasar el ratón.
Las celdas que Excel cambiaría al pegarlas van marcadas como texto (mso-number-format): «3/4» o «12-34», que se
pegaban unas veces como fecha o como 0,75 y otras tal cual; «007», sin sus ceros; un código de más de 15 cifras;
«1e5»; y lo que empieza como una fórmula. Los números y las fechas completas no, para que se sigan sumando.
Si no se migra, las tablas solo se exportan a CSV, y copiar una respuesta da su markdown.
Para migrar, de la plantilla, en app/front/src/: lib/copiar.ts (nuevo), el renderer.table de
lib/markdown.ts (los dos botones, en un mismo contenedor), initCopiarTabla() en main.tsx y el handleCopy
de components/MessageBubble.tsx.
Los gpt-6 en Azure responden con herramientas¶
Qué cambia: un gpt-6 de Azure que razona no admite herramientas en Chat Completions, y cada respuesta
del chat las lleva: fallaba con un 400 («Function tools with reasoning_effort are not supported for this model
in /v1/chat/completions»). El cliente de Azure lleva ahora el modelo (model=) además del despliegue, y con él
LangChain manda un gpt-6 con herramientas a la Responses API; los demás, y el título y el informe, que no
llevan herramientas, siguen por Chat Completions. La api_version pasa a 2025-04-01-preview, la primera con la
Responses API (con la anterior es un 404). Y sin_razonar cuenta los gpt-6 como modelos que razonan: el
título y el informe los piden con reasoning_effort="low", en vez del razonamiento por defecto del modelo.
Necesita que el despliegue de Azure se llame como el modelo (gpt-6-…): LangChain decide por el nombre.
Si no se migra, un gpt-6 de Azure no responde a nada: todas las respuestas fallan con ese 400.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/modelos/: clientes.py (el
AzureChatOpenAI de _construir) y ajustes.py (_OPENAI_QUE_RAZONA).
La identidad de un usuario es su id: eliminar a alguien conserva lo suyo¶
Qué cambia (specs/SPEC-borrar-usuario.md): la persona es su id, y el nombre, una etiqueta. Hasta
ahora el nombre lo era todo: al eliminar a «ana» y crear otra «ana», la nueva veía las conversaciones de la
anterior, estrenaba el mes con su gasto y su límite, y en Consumo eran una fila.
auth, por ids: cada tabla tiene unid(el deuser, un UUID que pone la base) y ununiquecon su clave natural, y se relacionan por id (user_role.user_id,role.parent_id,realm_id…).- tai-api: el token lleva
user_id,/auth/mey/rbacdan elidde cada usuario, yowner(..., compare_to="user_id")acota por él. Eliminar sigue siendo elDELETEde/rbac: quita el acceso y no toca lo demás. chatbot:chat.usuario_id(el dueño),token_usage.usuario_id(a quién se cobra) ylimite_presupuestopor(mes, usuario_id); el límite por defecto de cada mes, que era la fila'*', es la del UUID nulo (00000000-0000-0000-0000-000000000000), que ningún usuario tiene. Las vistas llevanusuario_id, yusuario_consumotambién a los eliminados con consumo (eliminado).chat.usernameytoken_usage.usernamese quedan, con el nombre que tenía.- El back y el front van por la identidad: los apuntes, los límites, las conexiones del WebSocket y las pantallas de consumo. Un eliminado sale en Consumo como «@ana · eliminado».
Necesita tai-chat 0.4.7, con tai-api 0.7.5 y tai-sql 0.8.7. No hay convivencia: un tai-api nuevo exige auth
migrado, y un back anterior no escribe usuario_id. Todo el mundo vuelve a entrar.
Un proyecto sin datos (o una base vacía) no migra nada: los auth.py y chatbot.py nuevos y tai-chat db
push.
Migrar un proyecto con datos¶
push no puede hacerlo solo: los ids nuevos hay que rellenarlos cruzando por nombre antes de quitar lo que iba
por nombre, y eso es una migración de datos. auth la hace un comando de tai-sql (auth-migrate); chatbot, el
script de abajo. Se para la API desplegada, se migra y se despliega la nueva: la vieja no funciona con la base
migrada, ni la nueva con la vieja. Desde la raíz del repositorio, con el .env exportado (set -a && . .env &&
set +a), en este orden (lo hace la skill actualizar-tai-chat):
- Una copia de la base, antes de nada (
pg_dump, otai-chat sql backup -s authy-s chatbot), y las comprobaciones de abajo, guardando lo que dan. auth, a ids: primero el ensayo, que no escribe y cuenta lo que haría:
Tiene que decir que no se pierde ninguna fila, cuántas sesiones cierra y que elimina la vista
chatbot.usuario_consumo (la vuelve a crear el push del paso 5). Después, tai-chat sql auth-migrate, que pide
confirmación y lo aplica en una transacción. Reescribe database/schemas/auth.py con la plantilla por ids si
era la anterior sin cambios; si el proyecto lo había cambiado, lo dice, y se pasa a mano.
3. chatbot, a usuario_id: el script de abajo, una vez (psql "$MAIN_DATABASE_URL" -v ON_ERROR_STOP=1 -f
migrar_chatbot.sql). Cambia 'chatbot' por el auth.realm de config.yaml si es otro. Se para si auth no
está migrado. Cada nombre con datos recibe el id de su usuario en el realm del chatbot (otra «ana» de otro
realm no cuenta), y uno que ya no está en auth recibe un id nuevo, el mismo en todas sus filas: queda como una
persona eliminada. El límite por defecto ('*') pasa a la fila del UUID nulo.
4. El chatbot.py nuevo y sus vistas, de la plantilla de tai-sql 0.8.7, que se sacan de un proyecto vacío en
una carpeta aparte:
mkdir /tmp/plantilla && cd /tmp/plantilla && tai-sql init -n database -s auth --no-install && tai-sql new-schema chatbot
Se copian database/schemas/chatbot.py y database/views/chatbot/*.sql sobre los del proyecto (las vistas, todas:
las antiguas van por nombre). Lo propio del proyecto en chatbot.py, si lo hubiera, se vuelve a añadir.
5. tai-chat db push. Su plan, en chatbot: las claves y los índices por usuario_id, quitar
ix_chat_username e ix_token_usage_username y volver a crear las vistas. Ningún DROP COLUMN ni DROP TABLE:
si sale uno, se contesta que no y se revisa. En auth, nada. Repetirlo dice «No se detectaron cambios».
6. La plantilla: api/rbac/chatbot.py (owner(..., compare_to="user_id")), el back entero de
api/api/routers/custom/assistant/ y, en el front, services/billingService.ts, types/billing.ts,
hooks/billing/useFacturacion.ts, components/billing/ (Consumo, Límites, General y el selector de usuario) y
components/admin/DeleteUserModal.tsx. Después, tai-chat api generate, que regenera la autenticación con el
login por id (routers/auth). Y se despliega.
7. Las comprobaciones otra vez: el consumo y los totales, iguales que en el paso 1; los usuarios, sus roles y sus
permisos, los mismos; y ninguna conversación ni apunte sin usuario_id.
Lo anterior a migrar no se puede separar: si «ana» se eliminó y se volvió a crear antes, nada dice qué era de cuál, y todo va a la «ana» actual.
Para volver atrás, la copia del paso 1 y la versión anterior de tai-chat, tai-api y tai-sql.
Si no se migra, el proyecto sigue como estaba, con tai-sql y tai-api anteriores.
Probado contra una base con la plantilla de tai-sql 0.8.4 y datos (dos realms con una «ana» en cada uno, roles
con jerarquía, conversaciones, apuntes, límites con '*' y un usuario eliminado antes de migrar): el consumo
diario, el mensual y los apuntes dan lo mismo, columna a columna, y el segundo push no ve cambios.
El login con ids¶
Para quien entra no cambia nada: el mismo usuario, la misma contraseña y el mismo POST /auth/<realm>/login. Al
migrar se cierran las sesiones (los tokens de antes no llevan user_id), así que todo el mundo vuelve a entrar una
vez: un token anterior es un 401, y el front lleva al login.
Por dentro:
- el usuario se busca por su nombre dentro de su realm (
(username, realm_id), que es único), y el token llevauser_id, eliddeauth.user(un UUID que no se reutiliza); - en cada petición se comprueba al usuario por ese id, que existe, que está activo y que la sesión es la suya. El token de una «ana» eliminada no vale para otra «ana» creada después;
/auth/mey/rbac/<realm>/userdan elidde cada usuario; en el front, la sesión lo tiene enuser.sub. Las rutas de/rbacsiguen por nombre;owner(..., compare_to="user_id")compara la columna con ese id, y en lo propio de/assistant,usuario_de(token)lo saca detoken.sub.
El código propio del proyecto:
- Lo que guarda de quién es algo con el nombre (
token.username,preferred_username) sigue funcionando, yowner()por nombre también. Pero hereda el problema de esta versión: una «ana» nueva vería lo de la anterior. Para pasarlo a id, una columna UUID que se rellena contoken.sub,owner(..., "<columna>", compare_to="user_id")y sus datos migrados como hace el script conchatbot. - Lo que lee
authcon su cliente de tai-sql va por id:user.find(username=..., realm_name=...)pasa auser.find_by(username=..., realm_id=...)ouser.find(<id>), yuser_rolese relaciona poruser_idyrole_id. - El nombre del token sigue valiendo como etiqueta (en un log o en la auditoría de tai-sql).
Las comprobaciones¶
Solo leen. Antes y después de migrar tienen que dar lo mismo, salvo la última, que antes de migrar no se puede lanzar y después tiene que dar 0:
SELECT 'mensual', username, mes, provider, total_tokens, total_cache_read, round(coste_eur::numeric, 6), message_count
FROM chatbot.consumo_mensual ORDER BY 2, 3, 4;
SELECT 'diario', username, date, total_tokens, round(total_cost_eur::numeric, 6), chat_count, message_count
FROM chatbot.consumo_diario ORDER BY 2, 3;
SELECT 'apuntes', count(*), sum(total_tokens), round(sum(coste_eur)::numeric, 6) FROM chatbot.consumo_apunte;
SELECT 'usuarios', count(*) FROM auth."user";
SELECT 'asignaciones', count(*) FROM auth.user_role;
SELECT 'permisos de rol', count(*) FROM auth.role_permission;
-- solo después: lo que se quedó sin dueño
SELECT 'sin usuario_id', (SELECT count(*) FROM chatbot.chat WHERE usuario_id IS NULL)
+ (SELECT count(*) FROM chatbot.token_usage WHERE usuario_id IS NULL);
El script de chatbot¶
-- El schema chatbot, por usuario_id (SPEC-borrar-usuario.md). Una vez por proyecto, después de
-- `tai-chat sql auth-migrate` y antes de copiar el chatbot.py nuevo y de lanzar `tai-chat db push`.
-- Solo transforma los datos: añade usuario_id, lo rellena cruzando el nombre con auth.user y quita el
-- nombre de limite_presupuesto, con su clave; la nueva (mes, usuario_id) la pone después el push.
-- Todo en una transacción: si algo falla, no se aplica nada.
BEGIN;
-- El realm del chatbot: el `auth.realm` de config.yaml
CREATE TEMP TABLE migracion_ajustes ON COMMIT DROP AS SELECT 'chatbot'::text AS realm;
-- Sin auth migrado no hay ids con los que cruzar: se para aquí
DO $$ BEGIN
IF NOT EXISTS (SELECT 1 FROM information_schema.columns
WHERE table_schema = 'auth' AND table_name = 'user' AND column_name = 'realm_id') THEN
RAISE EXCEPTION 'auth todavía va por nombre: lanza antes tai-chat sql auth-migrate';
END IF;
IF NOT EXISTS (SELECT 1 FROM auth.realm r, migracion_ajustes a WHERE r.name = a.realm) THEN
RAISE EXCEPTION 'el realm del chatbot no existe en auth: pon en migracion_ajustes el auth.realm de config.yaml';
END IF;
END $$;
ALTER TABLE chatbot.chat ADD COLUMN usuario_id UUID;
ALTER TABLE chatbot.token_usage ADD COLUMN usuario_id UUID;
ALTER TABLE chatbot.limite_presupuesto ADD COLUMN usuario_id UUID;
-- La identidad de cada nombre con datos: la de su usuario en el realm del chatbot, y si ya no está (se
-- eliminó antes de migrar), una nueva, la misma en todas sus filas
CREATE TEMP TABLE migracion_usuarios ON COMMIT DROP AS
SELECT nombres.username, COALESCE(u.id, gen_random_uuid()) AS id
FROM (SELECT username FROM chatbot.chat
UNION SELECT username FROM chatbot.token_usage
UNION SELECT username FROM chatbot.limite_presupuesto WHERE username <> '*') nombres
LEFT JOIN auth."user" u
ON u.username = nombres.username AND u.realm_id = (SELECT r.id FROM auth.realm r, migracion_ajustes a WHERE r.name = a.realm);
UPDATE chatbot.chat t SET usuario_id = m.id FROM migracion_usuarios m WHERE m.username = t.username;
UPDATE chatbot.token_usage t SET usuario_id = m.id FROM migracion_usuarios m WHERE m.username = t.username;
UPDATE chatbot.limite_presupuesto t SET usuario_id = m.id FROM migracion_usuarios m WHERE m.username = t.username;
-- El límite por defecto de cada mes, que era la fila '*', es la del UUID nulo: ningún usuario lo tiene
UPDATE chatbot.limite_presupuesto SET usuario_id = '00000000-0000-0000-0000-000000000000' WHERE username = '*';
-- Fuera el nombre de limite_presupuesto, con su clave primaria: el push la vuelve a crear por (mes,
-- usuario_id). chat.username y token_usage.username se quedan, como el nombre que tenía al crear o al gastar
ALTER TABLE chatbot.limite_presupuesto DROP COLUMN username CASCADE;
COMMIT;
Gestión de usuarios, sin la petición cancelada y con contadores ligeros¶
Qué cambia: al entrar en Gestión de usuarios, la página de la tabla salía con 7 filas, se cancelaba al medir el
alto y se repetía con las que caben; y cada contador (activos e inactivos) traía 100 usuarios para leer su total.
Ahora son tres peticiones a /rbac/<realm>/user: la página, que espera a saber cuántas filas caben, y los dos
contadores, con limit=1, que solo leen el total.
Si no se migra, sigue igual: funciona, con una petición más y los contadores más pesados.
Para migrar, de la plantilla, en app/front/src/: hooks/users/useUsers.ts (useGetUsers, que acepta
null, y useContarUsuarios), pages/AdminUsersPage.tsx y components/admin/UsersSection.tsx.
La hora de la valoración, y cambiarla¶
Qué cambia:
- mensaje.feedback_timestamp guarda cuándo se valoró una respuesta, y la vista valoracion la da (en las
valoradas antes, la de la respuesta). tai-chat feedback filtra por ella: antes filtraba por la hora de la
respuesta, y una respuesta anterior al último informe valorada después no salía en ninguno.
- La marca del informe siguiente es la última valoración leída, de la base, y no el reloj de quien lo lanza:
con la base en UTC y el equipo en la hora de España, iba una o dos horas por delante y se saltaba lo último.
- Valorar otra vez una respuesta sustituye la valoración (ya era así) y mueve su hora, así que sale en el
siguiente informe. El botón de una respuesta valorada enseña su pulgar, y el diálogo se abre con la
valoración y el comentario de antes.
Necesita tai-sql 0.8.8, que publica feedback_timestamp en la plantilla chatbot. La plantilla del back la
escribe al valorar: con el schema de antes, valorar falla. Por eso este paso no es opcional al copiar el back nuevo.
Si no se migra, tai-chat feedback filtra por la hora de la respuesta, como antes, y lo avisa; el diálogo
se sigue abriendo vacío.
Para migrar:
- En
database/schemas/chatbot.py, de un proyecto nuevo, la columnafeedback_timestampdeMensajey la de la vistaValoracion, y el SQL dedatabase/views/chatbot/valoracion.sql. Después,tai-chat db push. - De la plantilla,
api/api/routers/custom/assistant/routers/conversaciones.py(valorar_mensaje, que la escribe) y, enapp/front/src/components/,FeedbackDialog.tsxyMessageBubble.tsx. - El primer informe después de migrar empieza en la marca de antes, que puede ir adelantada, y desde él la marca
ya es la de la base. Lo que esa marca se saltó se recupera aparte con
--fromel día del último informe (repite las de ese día y no mueve la marca).
Consumo y Límites, solo con los usuarios del chatbot¶
Qué cambia: auth se comparte con el resto del repositorio, y la vista usuario_consumo trae a los usuarios
de todos los realms. Las pantallas de Consumo y de Límites enseñaban a los de otras aplicaciones, y el back les
daba un límite cada mes. Ahora solo salen los del realm del chatbot (y los eliminados con consumo), y solo ellos
reciben límite. El back sabe el realm por .config.json, que lleva una sección nueva, auth.
Si no se migra, sigue pasando, y solo se nota si hay otros realms en auth.
Para migrar:
- De la plantilla,
api/api/routers/custom/assistant/config.py(AuthConfig) ymodelos/precios.py(asegurar_limites_del_mes), y en el front,hooks/billing/useUsuarios.ts. tai-chat config generate, que escribe el realm en.config.json(tai-chat devlo hace solo).- Los límites que ya se dieron a usuarios de otros realms se pueden borrar; no los usa nadie:
DELETE FROM chatbot.limite_presupuesto l USING auth."user" u, auth.realm r
WHERE u.id = l.usuario_id AND r.id = u.realm_id AND r.name <> 'chatbot'; -- el auth.realm de config.yaml
Mientras responde, no se envía otro mensaje ni se exporta¶
Qué cambia: con una respuesta en curso, Enter ya no envía el mensaje que se esté escribiendo (se queda en el cajón hasta que acabe), y «Exportar» se deshabilita, como ya lo estaba «Obtener informe». Antes Enter lo enviaba, la API lo rechazaba («la conversación ya está respondiendo»), el texto se perdía y la conversación dejaba de verse respondiendo aunque siguiera.
Si no se migra, sigue pasando.
Para migrar, de la plantilla, en app/front/src/: components/ChatInput.tsx y components/ChatWindow.tsx
(send y MenuExportar).
Las sugerencias, con borde y el icono de enviar; y las cifras de Consumo caben¶
Qué cambia:
- Las sugerencias se ven como algo que se pulsa: borde del color de los mensajes del usuario, fondo más
claro (
--sugerencia, sacado de--primary, así que sigue aconfig.yaml) y el icono de enviar. Al pasar por encima crecen y ganan sombra. El bocadillo, con su pico abajo a la derecha, es un solo trazado SVG: con piezas sueltas se veía el corte. - Las listas numeradas de las respuestas dejan sitio a los números de dos cifras («10.»), que se
recortaban: más margen en
.markdown ol, y la respuesta que crece recorta solo por abajo. - Consumo → Consumo: cada columna numérica tiene su ancho, y los tokens a partir de 10 millones se abrevian («12,3 M», con la cifra entera al pasar por encima): antes las cifras grandes se salían.
Si no se migra, siguen como estaban.
Para migrar, de la plantilla, en app/front/src/: components/Sugerencias.tsx,
components/MessageBubble.tsx, components/billing/ConsumoTab.tsx, lib/consumoCache.ts (textoTokens) y,
en index.css, las variables --sugerencia, --sugerencia-hover y --sugerencia-foreground (en :root,
en .dark y en @theme) y el margen de .markdown ol.
Las sugerencias y los mensajes entran por su lado, y la respuesta crece sin saltos¶
Qué cambia:
- Las sugerencias van en bocadillo, a la derecha y con el color de los mensajes del usuario. Entran y se van por la derecha, y mientras la respuesta se escribe no ocupan sitio debajo.
- Al enviar, la lista no se mueve: el mensaje ocupa el sitio de las sugerencias cuando casi se han ido, entrando desde la derecha, y los puntos de «pensando», desde la izquierda. Antes el mensaje enviado aparecía de golpe: su entrada se decidía tarde.
- La respuesta sustituye a los puntos sin entrada propia, crece línea a línea con una transición, a unos 150 caracteres por segundo, y su pie aparece al acabar.
- «Obtener informe»: las extensiones, en una fila y solo con su nombre, y la caja de indicaciones, algo más alta.
Si no se migra, siguen como estaban.
Para migrar, de la plantilla, en app/front/src/: components/Sugerencias.tsx,
components/MessageBubble.tsx, components/ChatWindow.tsx, components/InformeDialog.tsx y
lib/sugerencias.ts (nuevo).
Las sugerencias, cuando la respuesta ya se ve entera y sin saltos¶
Qué cambia: las sugerencias aparecían mientras la respuesta todavía se escribía letra a letra, y de golpe; al enviar, se iban plegando a la vez que se desvanecían. Ahora esperan a que la respuesta se vea entera, el hueco se abre tras una pausa y entran una detrás de otra; al irse, se desvanecen primero y después se cierra el hueco.
Si no se migra, siguen como estaban.
Para migrar, de la plantilla, en app/front/src/: components/Sugerencias.tsx,
components/MessageBubble.tsx (onEscrita) y components/ChatWindow.tsx (escribiendo, y onEscrita en
la última respuesta).
tai-sql 0.8.4: el árbol de llamadas a herramientas, con tree=True¶
Qué cambia: la relación de una llamada con la que creó su sub-agente (ToolCall.llamada_padre) y la del
rol con su padre en auth (Role.parent) llevan tree=True: el cliente de tai-sql admite las consultas en
árbol sobre esa misma clave (find_many(tree_mode="descendants", tree_root=(mensaje, call_id))), con las
reglas rls en todo el árbol, y el cliente TS trae tree_level, ancestors y descendants en el registro.
Los endpoints generados no las exponen. tai-chat no las usa: es para el código propio del proyecto.
Si no se migra, nada cambia: la clave y la relación son las mismas, y la base no cambia.
Para migrar, con tai-chat ya instalado (trae tai-sql 0.8.4 y tai-api 0.7.4): en
database/schemas/chatbot.py, añadir tree=True a llamada_padre, y en database/schemas/auth.py, a
parent, como en un proyecto nuevo. No hay nada que llevar a la base, así que db push no regenera los
clientes: se regeneran a mano.
Regenerar tras un error ya no borra la respuesta anterior¶
Qué cambia: cuando una respuesta falla («No se pudo completar la respuesta») y se regenera, se borraba de la base la última respuesta del asistente, que era la de la pregunta anterior: el front la seguía enseñando, pero al recargar esa pregunta se quedaba sin respuesta. Ahora regenerar solo borra la respuesta de la última pregunta, si la hay.
Si no se migra, regenerar después de un error sigue borrando la respuesta anterior. Las ya borradas no se recuperan.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/: routers/mensajes.py
(regenerate_response).
Tablas nuevas en el informe de una conversación¶
Qué cambia: el informe puede llevar tablas que no estaban en la conversación, con lo que se dijo reorganizado (los datos de varios asuntos juntos, el estado final de cada cosa), y las indicaciones pueden pedirlas («los atributos de cada pedido, al final, en una tabla»). Van al final del documento, o en su asunto si lo piden. Cada número de una celda tiene que estar en la conversación: si no, la celda sale vacía.
Si no se migra, el informe solo lleva tablas de la conversación, y una tabla nueva pedida en las indicaciones sale como viñetas.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/: informes/redactor.py. Los
informes ya guardados no cambian.
Los diálogos del chat, centrados en la conversación¶
Qué cambia: «Obtener informe» y la valoración de una respuesta se abren en el centro de la conversación, no en el de la pantalla: con la barra lateral abierta quedaban a su izquierda.
Si no se migra, siguen en el centro de la pantalla.
Para migrar, de la plantilla, en app/front/src/: hooks/chat/useCentroDelChat.ts (nuevo),
components/ChatWindow.tsx (da su elemento con AreaDelChat), components/InformeDialog.tsx y
components/FeedbackDialog.tsx (style={useCentroDelChat()} en DialogContent).
Los tokens totales y sus cuatro partes, en las tablas de consumo¶
Qué cambia: en Mi consumo (el consumo diario), en Consumo → Consumo (por usuario) y en la tabla junto a la gráfica de General, los tokens totales van a tamaño normal y a su lado, en pequeño, las cuatro partes que los suman: «Entrada» (sin la caché), «Leídos de caché», «Escritos en caché» y «Salida». En Mi consumo, además, una fila «Total» con las sumas del mes; las otras dos ya la tenían. El PDF de Consumo lleva las mismas cuatro columnas y, arriba de cada página, el logo y el nombre de la marca. Los nombres de la caché son los mismos en todas las pantallas, el PDF y Modelos («€ leídos de caché / millón de tokens»), y la línea de las tarjetas de tokens dice «6000 leídos de caché».
Necesita las columnas total_cache_read y total_cache_write de consumo_diario (ver «La caché del
proveedor en las pantallas de consumo», más abajo).
Si no se migra, las tablas siguen con la entrada, la caché leída y la salida, sin lo escrito en caché, y Mi consumo sin fila de totales.
Para migrar, de la plantilla, en app/front/src/: lib/consumoCache.ts (entradaSinCache admite lo
escrito en caché, y los nombres de la caché), lib/consumoPdf.ts y, en components/billing/,
MiConsumoTab.tsx, ConsumoTab.tsx, GraficoModelos.tsx, GeneralTab.tsx y ModelosTab.tsx.
La clave de call_id, los índices y la valoración que nace vacía¶
Qué cambia (specs/SPEC-revision-schema.md):
- Cada llamada de un sub-agente está unida por clave a la que lo creó (tool_call: call_id único en su
mensaje, y (message_id, padre) → (message_id, call_id)), y el CRUD da el árbol con hijas.
- Índices en chat.username, mensaje.chat_id, token_usage.timestamp, token_usage.message_id e
informe_conversacion.message_id.
- mensaje.feedback nace vacía: un 👍 sin comentario se distingue de un mensaje sin valorar. La vista
valoracion trae todas las valoradas, y tai-chat feedback cuenta las que no tienen comentario.
Necesita la plantilla de tai-sql desde la versión que lo publique. En un proyecto ya creado se copian de
un proyecto nuevo, en database/schemas/chatbot.py, las clases Chat, Mensaje, TokenUsage, ToolCall,
InformeConversacion y Valoracion y el SQL de la vista valoracion, y después tai-chat db push. Con un
tai-sql anterior, el push falla al crear la clave de tool_call («there is no unique constraint matching
given keys»): crea la clave antes que la restricción única.
Antes del push, si hay call_id repetidos en un mensaje o un padre sin su llamada, la clave no se puede
crear. Se ven con:
SELECT message_id, call_id FROM chatbot.tool_call WHERE call_id IS NOT NULL
GROUP BY 1, 2 HAVING count(*) > 1;
SELECT h.id FROM chatbot.tool_call h WHERE h.padre IS NOT NULL AND NOT EXISTS (
SELECT 1 FROM chatbot.tool_call p WHERE p.message_id = h.message_id AND p.call_id = h.padre);
Después del push, los mensajes que nadie valoró siguen con good, y feedback los contaría como
positivas sin comentario. No se distinguen de un 👍 sin texto, que antes no se podía leer, así que se vacían
todos:
Si no se migra, nada cambia: el back nuevo no escribe filas que la clave rechazaría, y feedback sigue
con las que tienen comentario.
Para migrar, después del schema, de la plantilla, api/api/routers/custom/assistant/agente/trackers.py
(quita lo que la clave rechazaría) y, en el front, services/chatService.ts (la valoración vacía).
La caché del proveedor en las pantallas de consumo¶
Qué cambia (specs/SPEC-cache-en-consumo.md): las pantallas de Consumo y Mi consumo enseñan qué parte
de la entrada salió de la caché del proveedor, en su columna («Tokens caché»), con la entrada sin ella.
Necesita dos columnas en las vistas consumo_mensual y consumo_diario (total_cache_read y
total_cache_write), que trae la plantilla de tai-sql desde la versión que las
publique. En un proyecto ya creado se copian de un proyecto nuevo las dos vistas (sus clases en
database/schemas/chatbot.py y su SQL), y después tai-chat db push.
Si no se migra, nada cambia. Un front nuevo con las vistas anteriores no compila: se migran juntos.
Para migrar, después de las vistas, de la plantilla, en app/front/src/: lib/consumoCache.ts
(nuevo), lib/consumoPdf.ts, services/billingService.ts, types/billing.ts y, en
components/billing/, GraficoModelos.tsx, GeneralTab.tsx, ConsumoTab.tsx, MiConsumoTab.tsx y
ModelosTab.tsx (los precios de la caché, en castellano).
Las herramientas de un sub-agente, en tool_call; y las sugerencias no tumban una respuesta¶
Qué cambia (specs/SPEC-herramientas-subagente.md):
- Las herramientas que llama un sub-agente se guardan en tool_call con la respuesta, debajo de la que lo
creó: antes solo se guardaba esa. tai-chat feedback, tai-chat consumo y el laboratorio del front las
enseñan anidadas. Lo que tarda cada una es ya solo su ejecución.
- Si falla quitar las sugerencias del mensaje, la respuesta llega igual: antes se perdía, ya pagada.
Necesita dos columnas en tool_call (call_id y padre), que trae la plantilla de tai-sql desde
la versión que las publique. En un proyecto ya creado se añaden a la clase ToolCall de
database/schemas/chatbot.py, como en un proyecto nuevo, y después tai-chat db push, que las crea y
regenera el cliente.
Si no se migra, nada cambia: se siguen guardando solo las del agente principal. feedback y
consumo leen igual las filas sin esas columnas, y el back nuevo sin ellas guarda las del sub-agente sin
padre (en el primer nivel).
Para migrar, después de las columnas, de la plantilla, en api/api/routers/custom/assistant/:
agente/trackers.py, agente/middlewares.py, agente/contexto.py, agente/subagente.py y
agente/agente.py; y en el front, components/ToolCallLab.tsx.
El motivo de un rechazo, y los diálogos con un texto largo¶
Qué cambia (el front): - Cuando la API rechaza algo con un 422 (enviar con la conversación respondiendo, regenerar…), el aviso decía «Se ha producido un error»: ahora dice el motivo, que viaja en el primer error de la respuesta. - Un texto largo sin espacios en el campo de un diálogo (el comentario de una valoración) sacaba el campo por la derecha del diálogo: ahora se parte dentro.
Si no se migra, los avisos siguen con el mensaje genérico, y el diálogo se desborda con un texto así.
Para migrar, de la plantilla, en app/front/src/: lib/errores.ts (nuevo), components/ui/dialog.tsx
y components/ui/textarea.tsx; y en components/ChatWindow.tsx, motivoDelEnvio por motivoDe, de
lib/errores.ts.
La plantilla del back, ordenada por capacidad¶
Qué cambia: api/api/routers/custom/assistant/ se ordena en tres capacidades, agente/ (responder),
titulo/ (titular) e informes/ (resumir), y lo común a todo lo que llama a un modelo pasa de agente/
a modelos/. Ninguna de las tres importa de otra. El comportamiento no cambia.
| Antes | Ahora |
|---|---|
agente/modelos.py |
modelos/clientes.py |
agente/ajustes.py |
modelos/ajustes.py |
agente/desglose.py |
modelos/desglose.py |
TokenUsageTracker, en agente/trackers.py |
modelos/contador.py (los otros dos trackers se quedan) |
precios.py |
modelos/precios.py |
memoria.py |
agente/memoria.py |
sugerencias.py |
agente/entrega.py (guardar y enviar las sugerencias) |
titulo.py |
titulo/redactor.py (la llamada) y titulo/tareas.py (en segundo plano) |
No se mueve lo que importan las herramientas de un proyecto: agente/contexto.py, agente/subagente.py
y agente/herramientas/.
Si no se migra, nada cambia: el back del proyecto es suyo y funciona con su estructura. Pero un
módulo de la plantilla nueva no se puede copiar suelto sobre la antigua: importa de modelos/. Antes de
copiar informes/ (o cualquier módulo que lo importe), hay que migrar esto.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/:
- Copiar
modelos/ytitulo/(nuevos), yagente/yrouters/salvoagente/herramientas/y lo que el proyecto haya cambiado (que se lleva a mano a la versión nueva). - Borrar los de la columna «Antes»:
precios.py,memoria.py,sugerencias.pyytitulo.py, y enagente/,modelos.py,ajustes.pyydesglose.py. - El código propio que importara alguno de esos módulos cambia el import. Lo habitual, una herramienta
que llama al modelo por su cuenta:
from ..modelos import clientepasa afrom ...modelos.clientes import cliente, yfrom ...precios import resolver, afrom ...modelos.precios import resolver. tai-chat rules install, si las reglas están instaladas: la tabla del asistente dice dónde está cada cosa.
«Obtener informe»: el resumen de una conversación en DOCX o PDF¶
Qué cambia (specs/SPEC-informe-conversacion.md, y en el manual, «El informe de una
conversación»).
- Junto a «Exportar», «Obtener informe»: exportar la conversación resumida con IA, de la extensión
que se elija (corto, medio o largo) y, si se quiere, con unas indicaciones («todas las tablas»,
«céntrate en…») que no salen en el documento. El modelo de la conversación la resume en segundo plano, como una
respuesta (la barra lateral la marca), y llega como un mensaje de sistema con su descarga en PDF y en
DOCX, con el logo y el nombre del chatbot.
- Se guarda en la tabla informe_conversacion (uno a muchos con chat), y se reutiliza sin llamar al
modelo si la conversación no ha cambiado. Se paga con origen informe.
- Lo enseña el permiso de aplicación app-informe; la API pide informe_conversacion-read.
Necesita la tabla informe_conversacion en el schema chatbot: la trae la plantilla de tai-sql
desde la versión que la publique. En un proyecto ya creado, se copia de un proyecto nuevo a
database/schemas/chatbot.py: la clase InformeConversacion entera, y la relación informes:
onetomany[InformeConversacion] en Chat y en Mensaje. Después, tai-chat db push, que la crea y
regenera el cliente.
Si no se migra, nada cambia. Un front nuevo con un back anterior no compila sin la tabla
(InformeConversacionRead): se migran juntos.
Para migrar, después de la tabla, de la plantilla:
- Las dependencias de la API:
markdown-it-py>=3,<5,python-docx>=1,<2yfpdf2>=2.8,<3(poetry addenchatbot/api). - El back, en
api/api/routers/custom/assistant/, después de «La plantilla del back, ordenada por capacidad» (informes/importa demodelos/):informes/entera (confuentes/),routers/informes.py(nuevo),routers/__init__.py,__init__.py,routers/conversaciones.py(ocultar cancela el informe),agente/agente.py(respondiendo),config.pyytipos.py. - Los roles, en
api/rbac/chatbot.py:InformeConversacionen el import,.ADMINpara el Administrador,.READpara el Usuario, y elapp_permissionapp-informepara los dos. Después,tai-chat api generate(losPERMISSIONSdel front) ytai-chat db push(el RBAC). tai-chat config generate, que lleva la marca al back (.config.jsonyapi/api/marca/) yinformeal front. Opcional, enconfig.yaml:asistente.informe. Si el logo del front es SVG, los documentos salen sin él hasta declararasistente.informe.logoen PNG o JPG.- El front, en
app/front/src/:components/InformeDialog.tsx,components/InformePildora.tsx,hooks/chat/useInforme.tsylib/informe.ts(nuevos),lib/errores.ts(si no se copió con «El motivo de un rechazo, y los diálogos con un texto largo»),components/ChatWindow.tsx,components/MessageBubble.tsx,components/ChatSidebar.tsx,services/chatService.ts,hooks/chat/useConversaciones.ts,hooks/chat/useRespuesta.ts,pages/ChatPage.tsx,types/chat.tsyapi/custom/assistant/(models.ts,resources.tsyquery.ts).
tai-chat feedback se salta los mensajes de sistema: no hace falta nada.
Lo que el proveedor no da, estimado con la petición entera¶
Qué cambia (specs/SPEC-desglose-consumo.md, D4).
- Cuando el proveedor no da el uso de una llamada, se estima con la petición entera que salió hacia
el modelo (el prompt, las definiciones, el historial y el turno) y con lo que escribió. Antes se
estimaba con las palabras de la pregunta, y se apuntaba una fracción de lo cobrado.
- Cancelar una respuesta con OpenAI o Azure apunta también la llamada que estaba en curso, estimada:
esos proveedores mandan el uso al final del streaming, y cortado no llega, pero cobran la entrada y lo
escrito. Con Gemini ya se apuntaba, porque lo manda en cada trozo.
- Cancelar mientras se resume el historial apunta la entrada del resumen, estimada.
- El apunte va con estimado, y ahora con sus partes.
Si no se migra, se sigue apuntando de menos en esos casos.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/: agente/desglose.py,
agente/middlewares.py, agente/trackers.py, agente/historial.py y agente/agente.py. No toca la
base ni config.yaml.
El historial se resume al llegar a max_tokens_contexto¶
Qué cambia (specs/SPEC-contexto.md, D3 y D5).
- Lo antiguo de una conversación se resume cuando el historial llega a max_tokens_contexto, no al 70 %
de él: con 100000, se envían hasta 100000 tokens de historial (antes, hasta 70000). Al resumir, lo más
reciente (conservar, 30 %) se queda entero y lo de antes pasa a un resumen de como mucho el 5 %.
- asistente.contexto.resumir_al ya no existe. Un config.yaml que la declare no es válido: config
check, config generate y dev fallan diciendo que hay que quitarla.
- conservar + resumen tiene que ser menor que 1 (antes, que resumir_al).
Para migrar, quitar resumir_al de asistente.contexto en config.yaml y lanzar tai-chat config
generate. Con eso basta: el .config.json lleva contexto_resumir_al: 1, y el back ya copiado resume
también al llegar al máximo, sin tocarlo. El de la plantilla ya no lee esa clave
(agente/middlewares.py, agente/agente.py y config.py, en api/api/routers/custom/assistant/):
copiarlo es opcional.
Si no se migra, tai-chat no arranca (dev) ni regenera los derivados hasta quitar la clave.
Las conversaciones que ya están entre el 70 % y el 100 % dejan de resumirse hasta llegar al
máximo: las respuestas siguientes envían más historial y cuestan algo más por llamada, a cambio de que el
modelo vea más conversación. Si se quiere el gasto de antes, se baja max_tokens_contexto (a 70000, con
la plantilla).
El precio de la caché en la tarifa, y cuatro vistas menos¶
Qué cambia (specs/SPEC-precio-cache.md).
- Una tarifa puede llevar, junto a la entrada y la salida, el precio de cache input (lo leído de la
caché del proveedor, su «cached input») y el de cache write (lo escrito en ella: solo OpenAI y
Azure desde GPT-5.6 lo cobran aparte). Sin ellos, lo de la caché va al precio de entrada, como hasta
ahora: lo ya cobrado no cambia.
- Cada apunte guarda también lo escrito en la caché (token_usage.cache_write), de los tres
proveedores que lo dan.
- Las vistas que calculan dinero (consumo_mensual, consumo_diario, bolsa_estado,
consumo_apunte y consumo_parte) lo valoran a su precio, con la misma fórmula.
- Fuera cuatro vistas: user_stats y chat_activity, que no usaba nadie; tarifa_vigente, que eran
las filas de tarifa_historico con vigente; y consumo_desglose, que sale de consumo_apunte y
consumo_parte.
- El menú de tarifas de tai-chat config pide los dos precios, y la pantalla de modelos los enseña.
Necesita las columnas y las vistas de la plantilla de tai-sql desde la versión que las publique.
En un proyecto ya creado, se copian de un proyecto nuevo a database/schemas/chatbot.py: en Tarifa,
precio_cache_input_eur_millon y precio_cache_write_eur_millon; en TokenUsage, cache_write; y las
vistas ConsumoDiario, ConsumoMensual, BolsaEstado, ConsumoApunte, ConsumoParte y
TarifaHistorico, con sus .sql en database/views/chatbot/. Después, tai-chat db push (dos
veces, por las vistas que dependen de token_usage). Las cuatro vistas que salen se pueden dejar: no
estorban.
Si no se migra, todo sigue como estaba, valorando la caché a precio de entrada.
Para migrar, después del schema, de la plantilla:
- El back, en
api/api/routers/custom/assistant/:agente/desglose.py,agente/contexto.py,agente/agente.py,titulo.pyyprecios.py(que lee la tarifa vigente detarifa_historico). - Los roles, en
api/rbac/chatbot.py: sinUserStats,ChatActivity,TarifaVigenteniConsumoDesglose, si se quitan sus vistas. Después,tai-chat api generateytai-chat db push. - El front, en
app/front/src/:components/billing/ModelosTab.tsx. - Las tarifas: una nueva por modelo, desde hoy, con su cache input (y su cache write, si lo tiene).
Los informes, sobre el cliente generado¶
Qué cambia.
- tai-chat consumo es nuevo: un informe del consumo y su coste (ver el manual, «Comandos»).
- tai-chat feedback y tai-chat consumo leen la base de datos con el cliente que genera tai-sql, no
con SQL propio, y de tres vistas nuevas del schema chatbot:
- valoracion: las respuestas valoradas con comentario;
- consumo_apunte: cada apunte con su modelo y su coste;
- consumo_parte: cada parte de un apunte con su coste.
El coste lo calculan las vistas, como consumo_mensual.
- feedback ya no repite una valoración por cada apunte de su respuesta (la de un sub-agente es otro
apunte), y sus tokens son los de todos.
- init genera los clientes de tai-sql de auth y chatbot, y db push el que falte.
Necesita las tres vistas, que trae la plantilla de tai-sql desde la versión que las publique, sobre
las columnas del desglose (ver «El desglose del consumo»). En un proyecto ya creado, se copian de un
proyecto nuevo a database/schemas/chatbot.py las clases ConsumoApunte, ConsumoParte y
Valoracion, con sus .sql en database/views/chatbot/. Después, tai-chat db push, que también
regenera el cliente.
Si no se migra, el chatbot sigue igual, pero feedback y consumo fallan diciendo qué vista falta.
Para migrar los roles (opcional: los informes no pasan por la API), en api/rbac/chatbot.py:
ConsumoApunte, ConsumoParte y Valoracion en sus imports y su ADMIN al Administrador. Después,
tai-chat api generate y tai-chat db push.
Las sugerencias dentro de la respuesta, y el título sin razonar¶
Qué cambia (specs/SPEC-sugerencias.md).
- Las sugerencias las escribe el modelo al final de su respuesta, en la misma llamada, en vez de
pedirlas en otra al terminar. Van más ligadas a la respuesta y cuestan mucho menos: con Gemini 3.1
Pro, unas sugerencias costaban 2,3 veces su respuesta, casi todo en razonamiento. Ya no hay apuntes
con origen sugerencias: se cobran con la respuesta.
- El usuario no las ve escribirse: las líneas SUGERENCIA: … no se le enseñan, ni se guardan en el
mensaje ni quedan en la memoria del agente. Siguen llegando por chat_suggestions y guardándose en
la tabla sugerencia: el front no cambia.
- El título se pide sin razonar (o con el mínimo que admite el modelo): costaba casi el doble que
una respuesta corta.
Si no se migra, todo sigue funcionando, con las sugerencias y el título como antes.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/: agente/sugerencias.py y
agente/ajustes.py (nuevos), agente/middlewares.py, agente/agente.py, agente/modelos.py
(con_salida pasa a ajustes.py), sugerencias.py y titulo.py. La configuración no cambia
(asistente.sugerencias).
El historial que se envía al modelo: resumir, vaciar y regenerar¶
Qué cambia (specs/SPEC-contexto.md).
- La pregunta en curso no se pierde nunca. El recorte iba sobre todo junto, y una respuesta con
resultados grandes de herramientas podía dejar al modelo sin la pregunta (con 4000 tokens, bastaba
una consulta de un centenar de filas). Ahora max_tokens_contexto acota solo el historial anterior,
y el turno en curso va entero.
- Los resultados de herramientas de turnos anteriores se envían vaciados, salvo los del último
turno: el modelo ya los resumió al contestar, y puede volver a pedirlos. La memoria los conserva.
- Lo antiguo se resume cuando el historial llega al 70 % de max_tokens_contexto, al empezar un
turno: el modelo de la respuesta lo resume, lo más reciente (30 %) se queda entero, y el resumen
sustituye a lo resumido en la memoria del agente (lo que ve el usuario no cambia). Lo que cuesta
se apunta con origen resumen, en el mensaje de esa respuesta.
- Regenerar quita también de la memoria la respuesta descartada: antes, el modelo la seguía
viendo en los turnos siguientes, con la pregunta repetida.
- max_tokens_contexto de un proyecto nuevo es 100000 (era 4000).
Al migrar, las conversaciones que ya pasan del umbral se resumen en su siguiente turno. Es lo único que no se puede deshacer: lo resumido deja de estar en la memoria del agente.
Si no se migra, todo sigue como estaba, con el recorte de antes.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/: agente/historial.py
(nuevo), agente/agente.py, agente/middlewares.py (con los del historial y MedirConsumoMiddleware,
que sale de desglose.py; sin TrimMessagesMiddleware),
agente/modelos.py, agente/contexto.py, agente/desglose.py, routers/mensajes.py y config.py.
Después, en config.yaml, si se quieren otros valores que los
de por defecto, la sección asistente.contexto (turnos_con_resultados, resumir_al, conservar,
resumen), y tai-chat config generate. Con max_tokens_contexto: 4000, el resumen saltaría a los
2800 tokens: conviene subirlo.
Va encima de la del desglose del consumo (el origen resumen es un valor más de token_usage.origen).
El desglose del consumo: de dónde sale y de qué se compone¶
Qué cambia (specs/SPEC-desglose-consumo.md).
- Cada apunte de token_usage dice de dónde sale (origen: respuesta, subagente, titulo o
resumen) y de qué se compone (sus partes, en token_usage_parte). Lo exacto lo da el proveedor: las llamadas al
modelo, los tokens de caché y el razonamiento. La entrada de una respuesta se reparte, estimada, entre
las instrucciones, las definiciones de las herramientas, el contexto, los resultados de herramientas
anteriores, la pregunta y las herramientas de esa respuesta. Las partes suman siempre lo que se cobra:
lo que se cobra no cambia.
- Es interno: la aplicación no lo enseña. Se mira con tai-chat consumo, en las vistas
consumo_apunte y consumo_parte (con importes, solo el Administrador) y en el log de la API, una
línea [desglose] por respuesta en DEBUG: se ve con el logger tai-chatbot en DEBUG (ver el
manual, «El consumo de una respuesta»).
- Lo de cada sub-agente va en su propio apunte, con el nombre de la herramienta y del mismo mensaje.
- El laboratorio suma todos los apuntes del mensaje (antes enseñaba el primero).
Necesita columnas nuevas en token_usage y la tabla token_usage_parte en el schema chatbot: las
trae la plantilla de tai-sql desde la versión que las publique. En un proyecto ya creado, se copian de
un proyecto nuevo a database/schemas/chatbot.py: en la clase TokenUsage, las columnas origen,
llamadas, cache_read, estimado y herramienta y la relación partes: onetomany[TokenUsageParte],
y la clase TokenUsageParte entera. Las vistas para mirarlo son las de «Los informes, sobre el cliente
generado». Después, tai-chat db push. Lánzalo dos veces: el primero recrea las vistas que
dependen de token_usage, y el segundo deja consumo_diario y consumo_mensual como dicen sus
ficheros (un fallo de tai-sql).
Si no se migra, todo sigue como estaba. Los apuntes anteriores salen como sin_desglose: no se
puede saber de qué se componían.
Para migrar, después del schema, de la plantilla:
- El back, en
api/api/routers/custom/assistant/:agente/desglose.py(nuevo),agente/middlewares.py(MedirConsumoMiddleware),agente/agente.py,agente/contexto.py,agente/subagente.py,agente/trackers.py,precios.py,titulo.py,sugerencias.py, yconfig.py. - Los roles, en
api/rbac/chatbot.py:TokenUsageParteen sus imports, y suADMINal Administrador. Después,tai-chat api generateytai-chat db push. - El front, en
app/front/src/:components/ToolCallLab.tsx.
Una herramienta propia que sume a mano a runtime.context.consumo sigue cobrándose, como sub-agente sin
nombre. Lo nuevo es runtime.context.consumo.sumar(respuesta.usage_metadata), que lleva también el
razonamiento y la caché.
Las sugerencias, como burbujas del asistente, y apagarlas del todo¶
Qué cambia.
- Las sugerencias van debajo de su respuesta, con el estilo de sus burbujas, una debajo de otra y
alineadas con ella. Al enviar un mensaje se pliegan y se desvanecen en vez de desaparecer de golpe.
- Con asistente.sugerencias.activas: false, ni se generan ni se ven, tampoco las que ya estaban
guardadas (antes se seguían viendo).
Si no se migra, se ven como antes.
Para migrar, de la plantilla, en app/front/src/: components/Sugerencias.tsx y
components/ChatWindow.tsx, y tai-chat config generate, que escribe sugerencias en MARCA.
Con Gemini, la salida de las respuestas se apunta entera¶
Qué cambia. Con Gemini, de cada llamada del agente se apuntaba solo la salida del trozo más grande
del streaming, no la de todos: se cobraba de menos. Ahora se suman todos los trozos. Con OpenAI y
Azure OpenAI no cambia nada, y el título y las sugerencias ya se apuntaban bien. Lo ya apuntado no se
corrige (specs/SPEC-desglose-consumo.md, D0).
Si no se migra, las respuestas con Gemini siguen apuntando menos salida de la que se paga.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/: agente/trackers.py.
Sugerencias para seguir la conversación, y el título con el modelo del mensaje¶
Qué cambia.
- Al terminar bien una respuesta, el modelo de esa respuesta sugiere hasta tres formas de seguir. Se
ven como botones bajo la última respuesta, y la primera en el cajón de texto (Tab la escribe). Se
guardan colgando del mensaje (tabla sugerencia), así que al recargar siguen ahí. Se pagan, y se
apuntan sueltas con la conversación (specs/SPEC-sugerencias.md).
- El título lo pone el modelo del mensaje, el mismo que la respuesta, y no el de por defecto.
Necesita la tabla sugerencia en el schema chatbot, que cuelga de mensaje: la trae la
plantilla de tai-sql desde la versión que la publique. En un proyecto ya creado, se copia de un
proyecto nuevo a database/schemas/chatbot.py: la clase Sugerencia entera y, en la clase Mensaje,
la relación sugerencias: onetomany[Sugerencia]. Después, tai-chat db push, que la crea y regenera
el cliente. Los roles necesitan Sugerencia en api/rbac/chatbot.py (Sugerencia.READ para el
Usuario, Sugerencia.ADMIN para el Administrador), y tai-chat api generate.
Si no se migra, nada cambia. Un back nuevo con un front antiguo gasta la llamada sin enseñarlas:
se migran juntos, o se desactivan (asistente.sugerencias.activas: false) hasta migrar el front.
Para migrar, después de la columna, de la plantilla:
- El back, en
api/api/routers/custom/assistant/:sugerencias.py(nuevo),titulo.py,routers/mensajes.py,agente/agente.py,agente/middlewares.py,tipos.pyyconfig.py. - Opcional, en
config.yaml:asistente.sugerencias(activas,cuantas), ytai-chat config generate. - El front, en
app/front/src/:components/Sugerencias.tsx(nuevo),components/ChatWindow.tsx,components/ChatInput.tsx,services/chatService.ts,hooks/chat/useConversaciones.ts(la lista pidemessages.sugerencias: sin él, al abrir una conversación no se ven),contexts/ChatContext.tsx,pages/ChatPage.tsxytypes/chat.ts.
El chat en el móvil, y el WebSocket al volver al chat¶
Qué cambia.
- En el móvil, los mensajes van sin icono: los del usuario a la derecha y los del asistente a la
izquierda, cada uno hasta el 85 % del ancho. Desde sm, con su icono, como antes.
- Al volver al chat desde otra pantalla, la API registraba como errores («Error enviando a
conexión…», «WebSocket is not connected») un socket que el front abría y descartaba enseguida (el
doble montaje de StrictMode en desarrollo, o una navegación rápida). El front ya no lo llega a
abrir si se desconecta en el mismo instante, y la API trata como normal un cliente que se va antes
de la confirmación.
Si no se migra, nada deja de funcionar: los iconos siguen en el móvil y esos errores en el log.
Para migrar, de la plantilla: en app/front/src/, components/MessageBubble.tsx,
components/ChatWindow.tsx y services/chatService.ts; en api/api/routers/custom/assistant/,
conexiones.py y routers/websocket.py.
La memoria del agente sobre el pool de conexiones¶
Qué cambia. Cada respuesta retenía una conexión del pool del checkpointer mientras duraba, también
mientras el modelo escribía, y la mayoría sin autocommit. Con 10 respuestas largas a la vez, la
undécima esperaba conexión y a los 30 s fallaba («No se pudo completar la respuesta»); la memoria de
una respuesta no se guardaba hasta el final, y al cancelarla se perdía (según la conexión que le
tocara); y ocultar una conversación mientras respondía no le borraba la memoria. Ahora el
checkpointer trabaja sobre el pool, con autocommit: cada paso toma una conexión milisegundos y la
devuelve. Ocultar una conversación que está respondiendo la para antes de borrar su memoria.
Si no se migra, todo sigue funcionando, con esos límites.
Para migrar, de la plantilla, en api/api/routers/custom/assistant/: memoria.py,
agente/agente.py y routers/conversaciones.py. Las tablas del checkpointer no cambian.
El límite repartido del consumo general, al día¶
Qué cambia. El «Límite repartido» de la pestaña General sumaba las filas de limite_presupuesto
del mes, y el back las da de alta al pedir la configuración o cuando un usuario escribe por primera
vez: la pantalla las leía a la vez que la configuración, antes de que existieran, y no se enteraba
de las que llegaban después. Ahora, en el mes en curso, suma el límite de cada usuario, con su fila
o con el de por defecto del mes: el mismo total que la pestaña Límites. En un mes cerrado, las filas
que quedaron. Además, los límites se piden después de la configuración, y dar de alta, cambiar o
borrar un usuario vuelve a leer los usuarios del consumo.
Si no se migra, el general puede quedarse corto hasta recargar la página.
Para migrar, de la plantilla, en app/front/src/: services/billingService.ts,
components/billing/GeneralTab.tsx, hooks/billing/useFacturacion.ts, hooks/users/useUsers.ts y
pages/ConsumoPage.tsx.
tai-api 0.7.2 y tai-sql 0.8.0: el cliente TypeScript 2 en el front¶
Qué cambia. tai-chat pasa a tai-api 0.7.2 y tai-sql 0.8.0. El cliente TypeScript de la 0.7 no es compatible con el de la 0.6 (ver Migrar desde el cliente 0.6 en el manual de tai-api), y la plantilla del front lo sigue:
- Las mutaciones son factorías y los callbacks de la pantalla se suman a la invalidación:
useMutation(m.chat.create({ onSuccess })). - La invalidación es por tablas, sin keys: lo propio de
/assistantusachatbotQueryychatbotMutation, que declaran las tablas que leen o escriben. FueraassistantKeysyafectaConsumo(ahoraTABLAS_DE_CONSUMO). - El registro trae lo que se pidió: el tipo con relaciones sale de los
includes, escritosas const. /rbac/{realm}y/auth/melos genera tai-api:api.rbac(REALM)conrbacQueries/rbacMutations, yapi.session.me()/updateProfile(). Fuerasrc/api/custom/rbacysrc/api/custom/me: con la 0.7.2, un dominio propio llamadorbacno compila. Editar un usuario cambia sus roles en la misma petición (la lista entera).- El modo estricto, por defecto: un filtro, un
order_byo unincludesque la API no conoce es un 422. - Las escrituras anidadas del CRUD piden el permiso de la tabla hija y le aplican su
owner(): se cierra el fallo por el que el Administrador podía tocar los mensajes de otros editando un chat suyo. Los roles de la plantilla ya tienen los permisos que hacen falta.
Si no se migra, lo que ya está generado sigue funcionando: la API desplegada no depende de
tai-api, y el front lleva el cliente con el que se generó. Pero un tai-chat nuevo instala tai-api
0.7, y el siguiente tai-chat api generate regenera el cliente: a partir de ahí el front no compila hasta migrarlo. Para quedarse en la 0.6, tai-chat 0.4.1.
Para migrar:
pip install -U tai-chat, que trae tai-api 0.7.2 y tai-sql 0.8.0.tai-chat sql generate -s chatbot,tai-chat sql generate -s authytai-chat api generate: el cliente de Python, la API y el cliente TypeScript.- El front, de la plantilla de tai-chat, en
app/front/: - borrar
src/api/custom/rbac/ysrc/api/custom/me/; src/api/custom/index.tsysrc/api/custom/assistant/query.ts;src/hooks/users/useUsers.ts,src/hooks/auth/useCuenta.ts,src/hooks/chat/useConversaciones.tsysrc/hooks/billing/useFacturacion.ts;src/services/chatService.ts,src/lib/tai.tsyeslint.config.js;src/components/AvisosSesion.tsx,FeedbackDialog.tsx,SettingsDialog.tsx,ToolCallLab.tsx,admin/EditUserModal.tsxyadmin/UsersSection.tsx.- Lo que el proyecto haya añadido al front, con lo que diga
npm run buildy la guía de tai-api: las mutaciones como factorías, losincludesconas consty ninguna key escrita a mano. tai-chat rules install.
El título, en paralelo con la primera respuesta¶
Qué cambia. El título de una conversación nueva lo pone el back al llegar su primer mensaje, a
la vez que la respuesta (titulo.py), y lo manda por el WebSocket como chat_title: llega
en un par de segundos, a menudo antes de que acabe la respuesta. Antes, el front esperaba a que
terminara, y un segundo más, para pedirlo con generate-title. El front lo escribe letra a letra;
uno escrito a mano sale entero.
generate-title sigue para los front de antes, y si la conversación ya tiene título lo devuelve sin
pagar otra vez el modelo: un back nuevo con un front antiguo no paga el título dos veces. El título
sale ahora del primer mensaje del usuario, el único que hay cuando se pone
(asistente.titulo.mensajes cuenta si un front antiguo lo pide después).
Si no se migra, el título sigue llegando al terminar la primera respuesta. Un front nuevo necesita el back nuevo: ya no lo pide, y con un back antiguo las conversaciones se quedan sin título.
Para migrar, necesita lo de varias conversaciones a la vez, que trae el socket de la sesión. Después, de la plantilla:
- El back, en
api/api/routers/custom/assistant/:titulo.py(nuevo),routers/mensajes.pyytipos.py(CHAT_TITLE). - El front, en
app/front/src/:hooks/chat/useTituloEscrito.ts(nuevo),services/chatService.ts,pages/ChatPage.tsx,components/ChatWindow.tsx,components/ChatSidebar.tsxyapi/custom/assistant/resources.ts(singenerateTitle).
Varias conversaciones respondiendo a la vez¶
Qué cambia. Se puede preguntar en una conversación, dejarla respondiendo, abrir otra y preguntar
allí: las dos siguen llegando, y la barra lateral marca las que responden y las que tienen una
respuesta sin ver (specs/SPEC-chats-simultaneos.md).
- El back tiene un WebSocket por sesión,
/assistant/ws, por el que llegan las respuestas de todas las conversaciones del usuario, y todo evento lleva suchat_id. La ruta de antes,/assistant/ws/chat/{id}, sigue igual (sus eventos llevan tambiénchat_id, que un front antiguo ignora). - Una respuesta por conversación, y hasta
asistente.max_respuestas_simultaneas(5) por usuario: lo demás es un 422 con su motivo, antes de guardar el mensaje. - El pool del checkpointer pasa de las 4 conexiones por defecto de psycopg a hasta 10.
- El front abre un solo socket mientras se usa el chat, y lo que se escribe en cada conversación
es estado de
chatService, que se lee conhooks/chat/useRespuesta. Fuera el contador de generación.
Si no se migra, nada deja de funcionar: un back y un front antiguos siguen con un socket por chat. Un back nuevo con un front antiguo también funciona; un front nuevo necesita el back nuevo.
Para migrar, el back primero, de la plantilla de tai-chat, en api/api/routers/custom/assistant/:
conexiones.py,routers/websocket.py,routers/mensajes.py,agente/agente.py,config.pyymemoria.py. Una herramienta propia que useconnection_manager.send_to_chatsigue funcionando, pero solo llega al socket antiguo: que pase aenviar(chat_id, username, evento).- Opcional, en
config.yaml:asistente.max_respuestas_simultaneas(sin ella, 5), ytai-chat config generate. - El front, de la plantilla, en
app/front/src/:services/chatService.ts,hooks/chat/useRespuesta.ts(nuevo),contexts/ChatContext.tsx,pages/ChatPage.tsx,components/ChatWindow.tsx,components/ChatSidebar.tsx,components/AvisosSesion.tsxyapi/custom/assistant/resources.ts(webSocketPath()).
El front sobre el cliente entero de tai-api¶
Qué cambia. El front usa todo lo que genera tai-api, no solo el núcleo
(specs/SPEC-front-cliente-tai-api.md):
- El cliente va en
app/front/src/api/(antessrc/lib/api/), con TanStack y el adaptador de React ("react": true). Lo propio de la plantilla —las llamadas a/assistant,/rbac/{realm}y/auth/me— va ensrc/api/custom/, que tai-api no toca porque sus ficheros no llevan su marca, con la forma de un schema generado (assistant/,rbac/yme/, cada uno conmodels,resourcesyquery). Comorouters/custom/en la API,custom/index.tsexportacustomResources(http)y elcreateTaiClientgenerado lo registra (tai-api 0.6.3). La instancia essrc/lib/tai.ts:api.chatbot.*es lo generado, yapi.assistant.*,api.rbac.*yapi.me.*, lo propio. - La sesión es la del adaptador:
TaiProviderenmain.tsx,useSession()en los componentes yuseCuenta()para el usuario con su perfil. FueraAuthContextyuseAuth. - Las rutas, el menú y los permisos salen de
src/routes/routes.tsx(defineRoutes), con losPERMISSIONSque genera tai-api desderbac/<realm>.py. FueraProtectedRoute,useAccessGuardyconstants/permissions. El login vuelve a la pantalla de la que venía. - Todo lo que se lee o se escribe es una consulta o una mutación de TanStack, también lo de
/assistanty/rbac. Las pantallas de consumo y el indicador de tokens se actualizan solos al terminar cada respuesta. - El WebSocket descarta la conexión que llega tarde al cambiar de chat, en vez de pisar la del chat nuevo.
- ESLint impide que vuelva lo escrito a mano (la sesión, las guardas, los permisos, las
queryKey, un segundo cliente) y losconsole.log.
Si no se migra, nada deja de funcionar: el front del proyecto es suyo y sigue con su cliente
donde diga frontend.output_dir en api/.taiapiproject. Lo que no tendrá es lo de arriba.
Para migrar. Hace falta tai-api 0.6.3 o posterior, que es la que registra custom/ en
createTaiClient. Lo necesita también el back: el indicador de tokens lee
GET /assistant/billing/chat/{id}, en routers/consumo.py de la plantilla del back.
- En
api/.taiapiproject, enfrontend:"output_dir": "../app/front/src/api","react": truey"tanstack": true. Borrarapp/front/src/lib/api/. Se genera después de copiarsrc/api/custom/(paso 2 o 3):generatesolo registracustom/si ya existe. - Si el front no tiene cambios propios, lo más corto es sustituirlo por la plantilla, salvo
src/marca/, y volver a generar:
PLANTILLA=$(python -c "import tai_chat, pathlib; print(pathlib.Path(tai_chat.__file__).parent / 'front')")
rsync -a --delete --exclude node_modules --exclude src/marca --exclude src/api "$PLANTILLA"/ chatbot/app/front/
rsync -a "$PLANTILLA"/src/api/custom/ chatbot/app/front/src/api/custom/
tai-chat config generate && tai-chat api generate
cd chatbot/app/front && npm ci
- Si los tiene, fichero a fichero, desde la plantilla:
- nuevos:
src/api/custom/(y después,tai-chat api generate),src/routes/routes.tsx,src/lib/queryClient.ts,src/components/AvisosSesion.tsxysrc/hooks/auth/{useCuenta,useFinDeSesion}.ts; - cambiados:
src/lib/tai.ts(soloexport const api = createTaiClient()),main.tsx,App.tsx,eslint.config.js,vite.config.ts,services/chatService.ts,services/billingService.ts,hooks/chat/useConversaciones.ts,hooks/billing/useFacturacion.ts,hooks/users/useUsers.ts,types/billing.ts, las páginas y los componentes que usaban la sesión, los permisos o las llamadas sueltas (ChatSidebar,ChatWindow,MessageBubble,SettingsDialog,TokenUsageBar,ToolCallLab,FeedbackDialog); - fuera:
src/api/{auth,billing,chat,users}/,contexts/AuthContext.tsx,hooks/auth/useAuth.ts,hooks/auth/useAccessGuard.ts,constants/permissions/,services/userService.tsytypes/users.ts.
Una pantalla propia se declara en routes/routes.tsx, con su permission si lo pide. npx tsc -b
y npx eslint . dicen qué queda: cada regla nueva lleva el mensaje de lo que sustituye a lo viejo.
tai-api 0.6.2 y tai-sql 0.7.21: los mensajes en el consumo¶
Qué cambia. En las vistas consumo_diario y consumo_mensual, message_count contaba
apuntes de consumo, no mensajes, y lo gastado sin mensaje (el título) no contaba en chat_count.
Con la plantilla chatbot de tai-sql 0.7.21, los tokens y el importe son todos los apuntes, y
message_count son los mensajes que envió el usuario, en el modelo al que se enviaron. Por eso
el back guarda ahora el modelo también en el mensaje del usuario; los anteriores cuentan en el de la
respuesta que los siguió. Las columnas no cambian: el front no se toca.
Además, create_many de los DAO devuelve los registros creados en vez de cuántos, y la API generada
gana POST /<tabla>/bulk (y createMany en el cliente TS). tai-api 0.6.2 deja la sesión anónima,
en vez de cargando para siempre, si el refresco del arranque da un 5xx.
Si no se migra, las pantallas de consumo siguen contando apuntes como mensajes. Un script que
use el número que devolvía create_many recibe ahora una lista.
Para migrar:
- Las vistas son ficheros del proyecto, que la plantilla de tai-sql solo escribe al crear el
schema: copiar
database/views/chatbot/consumo_diario.sqlyconsumo_mensual.sqlde undatabase/recién creado con tai-sql 0.7.21, ytai-chat db push(reescribe las dos vistas). - De la plantilla de tai-chat,
api/api/routers/custom/assistant/routers/mensajes.py(send_message_to_streamguarda el modelo en el mensaje del usuario). tai-chat api generate, para el cliente concreate_manynuevo y los endpointsbulk. Donde se use el resultado decreate_manycomo número,len(...).
tai-sql 0.7.20: buscar en documentos¶
Qué cambia. El manual tiene una página nueva, «Buscar en documentos», sobre herramientas que buscan por significado con las columnas vectoriales de tai-sql. tai-chat pide tai-sql 0.7.20, que calcula los vectores al escribir —en lote y, en el cliente asíncrono, sin parar la API—; antes los calculaba al construir cada DTO, de uno en uno y bloqueando.
Si no se migra, nada deja de funcionar: un proyecto sin columnas vectoriales no nota nada.
Para migrar: si el proyecto tiene alguna vector_column(), tai-chat api generate para
regenerar su cliente con tai-sql 0.7.20. Y tai-chat rules install, para que las reglas de los
asistentes de IA lleven la sección de búsqueda por significado.
pydantic por debajo de la 2.14¶
Qué cambia. Con pydantic 2.14, declarar una herramienta con runtime: ToolRuntime[Contexto]
falla al importar la API: zip() argument 2 is shorter than argument 1. init ya añade
pydantic<2.14 a la API, y tai-chat lo pide para el entorno desde el que se lanza dev.
Si no se migra, un proyecto que haya resuelto la 2.14 no arranca.
Para migrar: en api/, poetry add "pydantic<2.14"; y en el entorno de tai-chat,
pip install "pydantic<2.14".
La conversación duplicada al enviar mientras se crea¶
Qué cambia. Si el usuario escribía y pulsaba Enter justo después de «Nueva conversación», se creaban dos conversaciones: el mensaje iba a una, el WebSocket a la otra, y la respuesta no se veía (quedaba guardada en la primera). Ahora hay una sola creación en vuelo.
Para migrar: en app/front/src/pages/ChatPage.tsx, newChat y crearChat de la plantilla de
tai-chat. Opcional: eslint.config.js, con las reglas de la plantilla como errores (sin fetch, el
idioma y los colores de la marca, ningún token en el navegador), y el data-chat-id de cada
conversación en components/ChatSidebar.tsx.
El consumo del título y de las respuestas que no terminan¶
Qué cambia. Se apuntaba solo lo que acababa en una respuesta. El título de cada conversación y
las respuestas que no terminan —se pasan de max_iteraciones, el usuario las cancela o una
excepción las corta— gastaban tokens que no se cobraban. Ahora se apuntan, con la conversación
(chat_id) y, si no hay mensaje del que colgarlos, sueltos.
Si no se migra, esos tokens se siguen gastando sin cobrarse. Nada deja de funcionar.
Para migrar, de la plantilla de tai-chat, en api/api/routers/custom/assistant/: precios.py
(apunte con chat_id y apuntar_suelto), agente/agente.py y routers/mensajes.py
(generate_chat_title). Lo ya apuntado no cambia.
El consumo de las respuestas con herramientas¶
Qué cambia. Una respuesta que usa herramientas hace varias llamadas al modelo, y hasta ahora solo se apuntaba la mayor: se cobraba de menos. Ahora se suman todas, y también lo que gasten los sub-agentes de las herramientas.
Para migrar: api/api/routers/custom/assistant/agente/trackers.py (TokenUsageTracker) de la
plantilla de tai-chat. El consumo ya apuntado no cambia; desde ese momento se apunta entero.
Las herramientas con su propio agente (opcional): agente/subagente.py y, en
agente/contexto.py y agente/agente.py, el modelo y el consumo del Contexto.
Las herramientas del agente leen como el usuario¶
Qué cambia. El agente pasa el AccessToken a sus herramientas, que piden el permiso de la
tabla y consultan con rls_for: leen lo que el usuario podría leer por la API, y nada más.
Si no se migra, las herramientas siguen recibiendo solo los permisos del usuario. Una que lea datos con dueño o acotados por RLS leería los de todos: no debe hacerlo hasta migrar.
Para migrar, de la plantilla de tai-chat, en api/api/routers/custom/assistant/:
agente/contexto.py (nuevo), agente/middlewares.py (SinPermisoMiddleware), agente/agente.py
(context_schema y el token en start_streaming) y routers/mensajes.py (que le pasa el token).
Después, cada herramienta que lea datos recibe runtime: ToolRuntime[Contexto], como
contar_mis_conversaciones en agente/herramientas/toolfuncs.py.
tai-api 0.6.0 y tai-sql 0.7.19: la contraseña propia y el modelo de cada chat¶
La contraseña propia. tai-api 0.6.0 (desde la 0.5.11) la cambia solo con POST
/auth/me/password, comprobando la actual, y PATCH /auth/me con password es un 422. Al
regenerar con esta versión, el «Mi cuenta» de un proyecto anterior deja de poder cambiar la
contraseña. Para migrar:
app/front/src/api/auth/auth.ts: fuerapassworddeUpdateMePayload, y una función que llame aapi.session.changePassword(actual, nueva).app/front/src/components/SettingsDialog.tsx: un campo para la contraseña actual, la nueva por esa función, y el perfil porupdateMesolo si cambió algo (unPATCHvacío es un 422). Un error conerrors[0].field === "current_password"es que la actual no es la correcta.
Los dos ficheros de la plantilla de tai-chat sirven tal cual. Además, auth.contrasena_min en
config.yaml ya no puede bajar de 8, que es lo que exige tai-api.
El modelo de cada chat (chat.modelo). Sin migrar, el chat sigue funcionando: cada respuesta
usa el modelo que pide el front. Para migrar:
- En
database/schemas/chatbot.py, en la claseChat:
modelo: col[str | None] = column(description='Alias del modelo con el que responde esta conversación; sin él, el de por defecto')
Después: tai-chat sql push -s chatbot (solo añade la columna; los chats que ya hay quedan
sin modelo, que es el de por defecto) y tai-chat api generate.
2. El back y el front de la plantilla: ChatUpdateRequest.modelo y su validación en
routers/conversaciones.py, chat.modelo en routers/mensajes.py, y en el front
updateChatModelo y el selector de ChatWindow.tsx.
Las conversaciones con owner() (tai-api 0.5.6, tai-sql 0.7.18)¶
Qué cambia. Las conversaciones, sus mensajes y sus tokens los acota owner() de tai-api: cada
usuario solo alcanza los suyos, por el CRUD generado y por /assistant. Antes las aislaba a mano
el back del chat.
Si no se migra, el proyecto sigue funcionando como estaba: su back y su front copiados aíslan
las conversaciones por su cuenta, con su /assistant de siempre.
Para migrar:
- La vista
tokens_mensaje, que necesita el dueño del chat para queowner()la acote. Endatabase/schemas/chatbot.py, en la claseTokensMensaje:
# El dueño del chat. Una vista no tiene relaciones por las que llegar a `chat`, así que
# una regla de propietario (tai-api `owner()`) necesita la columna aquí
username: col[str]
y en database/views/chatbot/tokens_mensaje.sql, la columna, el JOIN y el GROUP BY:
SELECT ..., c.username, ...
FROM token_usage tu
JOIN mensaje m ON m.id = tu.message_id
JOIN chat c ON c.id = m.chat_id
GROUP BY tu.message_id, m.chat_id, c.username, m.model_name, m.provider;
Después: tai-chat sql push -s chatbot.
- Las reglas, en
api/rbac/chatbot.py:
from tai_api.rbac import source, role, app_permission, owner
owner("chatbot", "chat", "username")
owner("chatbot", "tokens_mensaje", "username")
y, en el rol que chatea, solo lectura por el CRUD:
Sin Chat.CREATE ni ningún UPDATE: el POST y el PATCH generados escriben también
las filas anidadas del cuerpo sin pedir su permiso (un fallo de tai-api, ver
.claude/rules/01-arquitectura-objetivo.md).
Después: tai-chat api generate (las reglas owner() se escriben en la API al generar) y
tai-chat api rbac push -r chatbot.
- El back y el front, si se quieren los de esta versión:
routers/custom/assistant/(conacceso.py) yapp/front/src/api/chat/chat.ts, de la plantilla de tai-chat. Con el back antiguo, los pasos 1 y 2 ya acotan el CRUD generado, y/assistantsigue aislando a mano.