config.yaml¶
chatbot/config.yaml es la declaración del chatbot: el agente, los WebSocket, el consumo, el
realm y su admin, la marca del front, los puertos y los modelos. Lo que se configura del chatbot
sale de aquí.
Ni el back ni el front lo leen. tai-chat config generate lo valida y escribe lo que leen ellos:
| Derivado | Quién lo lee | Qué lleva |
|---|---|---|
api/api/.config.json |
La API | El agente, los WebSocket y el consumo |
app/front/src/marca/ y public/marca/ |
El front | El nombre, el idioma, los logos, los colores y la bienvenida |
.env.compose |
docker compose |
Los puertos y los hosts del despliegue |
secret_key_name del .taiapiproject |
tai-api | La variable de la clave de firma |
tai-chat config generate # valida y escribe los derivados; 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)
tai-chat dev lo genera solo al arrancar, así que en desarrollo basta con guardar el fichero y
reiniciar.
Una clave desconocida es un error
config.yaml se valida entero antes de escribir nada. Una errata (max_iteracion:) no se
ignora: falla y dice dónde. Una declaración que no se puede aplicar entera no se aplica a medias.
Lo que no está aquí¶
- Los secretos. De una clave solo se declara el nombre de su variable de entorno
(
clave: OPENAI_API_KEY), nunca su valor. - Las tarifas y las bolsas. Son datos con historia —qué precio regía cuándo, qué se ha gastado
de cada bolsa— y se gestionan en
tai-chat config. Ver modelos y consumo. - Los roles. Van en
api/rbac/chatbot.py. Ver roles.
asistente¶
El agente que responde.
asistente:
prompt: |
Eres un asistente del departamento de mantenimiento. Respondes con datos de las
herramientas, y si no los tienes, lo dices. Todos los costes están en euros.
max_iteraciones: 6
max_respuestas_simultaneas: 5
max_tokens_contexto: 100000
contexto:
turnos_con_resultados: 1
conservar: 0.3
resumen: 0.05
titulo:
mensajes: 3
max_caracteres: 60
titulo_nuevo_chat: Nuevo Chat
| Clave | Por defecto | Qué hace |
|---|---|---|
prompt |
— | El prompt del sistema |
max_iteraciones |
6 |
Cuántas veces puede el agente llamar a herramientas y volver al modelo en una respuesta. Al pasarse, contesta que no pudo completar la consulta |
max_respuestas_simultaneas |
5 |
Cuántas conversaciones de un mismo usuario pueden estar respondiendo a la vez. Una más se rechaza con un aviso. Acota también cuánto se puede pasar del límite de gasto: el límite se comprueba antes de cada respuesta, y las que van a la vez lo pasan juntas |
max_tokens_contexto |
100000 |
Cuánto historial de la conversación se le da al modelo, en tokens aproximados: lo anterior a la pregunta en curso. Al llegar, lo antiguo se resume. No cuentan el turno en curso (la pregunta, y las herramientas que llame y sus resultados), que va siempre entero, ni el prompt ni las definiciones de las herramientas: se envían aparte, y se pagan igual. Ver lo que se envía de la memoria |
contexto.turnos_con_resultados |
1 |
Los últimos turnos que se envían con los resultados de sus herramientas. Los de antes van vaciados: el modelo ya los resumió al contestar |
contexto.conservar |
0.3 |
Cuando el historial llega a max_tokens_contexto, al empezar un turno, lo más reciente que se queda entero, en parte de max_tokens_contexto. Lo de antes (en torno al 70 %) se resume: el resumen lo hace el modelo de la respuesta, se paga, y sustituye a lo resumido en la memoria del agente |
contexto.resumen |
0.05 |
Lo que ocupa el resumen, como mucho, en parte de max_tokens_contexto. conservar + resumen tiene que ser menor que 1: si no, se resumiría en cada turno |
titulo.mensajes |
3 |
Con cuántos de los primeros mensajes se genera el título de una conversación. El título se pone en paralelo con la primera respuesta, así que suele salir del primer mensaje del usuario; los demás cuentan si un front antiguo lo pide después con generate-title |
titulo.max_caracteres |
60 |
El largo máximo del título |
titulo_nuevo_chat |
Nuevo Chat |
El título de una conversación recién creada |
sugerencias.activas |
false |
Si al terminar cada respuesta se sugiere qué preguntar después. Las escribe el modelo al final de la respuesta, en la misma llamada: unos pocos tokens más de salida. Apagadas, ni se piden ni se ven, tampoco las que ya estaban guardadas |
sugerencias.cuantas |
3 |
Cuántas sugerencias, como mucho (de 1 a 5) |
informe.activo |
true |
Si se ofrece «Obtener informe», el resumen de la conversación en DOCX o PDF. Además hace falta el permiso app-informe. Ver El informe de una conversación |
informe.palabras |
{corto: 120, medio: 350, largo: 800} |
Lo que ocupa cada extensión, en palabras aproximadas |
informe.max_tokens_conversacion |
60000 |
La conversación que se le da entera al modelo. Si no cabe, lo antiguo se resume antes por tandas |
informe.mensajes_literales |
10 |
Los últimos mensajes que van enteros aunque se resuma lo antiguo |
informe.timeout_s |
300 |
Lo que puede tardar uno. Pasado, el que sigue preparándose (su proceso murió) se da por fallido y deja pedir otro |
informe.logo |
— | El logo de los documentos, en PNG o JPG. Sin él, el claro del front; si es SVG, salen sin logo |
El agente explica qué hace cada una en el bucle.
websocket¶
Las respuestas llegan por un WebSocket por sesión (/assistant/ws), el de todas las conversaciones del usuario.
| Clave | Por defecto | Qué hace |
|---|---|---|
timeout_s |
300 |
Cuánto puede estar una conexión sin actividad antes de darla por muerta |
max_conexiones |
100 |
Cuántas conexiones admite la API a la vez |
limpieza_s |
900 |
Cada cuánto se cierran las conexiones sin actividad |
consumo¶
| Clave | Por defecto | Qué hace |
|---|---|---|
bolsas |
false |
Con bolsas, el consumo se carga a créditos comprados y sin saldo no se responde. Sin ellas, se factura a mes vencido contra el límite de cada usuario |
limite_por_defecto_eur |
10 |
El límite mensual con el que se da de alta a quien llega nuevo |
cache_catalogo_s |
60 |
Cada cuánto relee la API los modelos y sus tarifas |
Ver modelos y consumo.
auth¶
auth:
realm: chatbot
clave_de_firma: CHATBOT_SECRET_KEY
admin:
usuario: admin
rol: Administrador
contrasena_min: 8
| Clave | Qué hace |
|---|---|
realm |
El realm de tai-api del chatbot. Tiene que existir api/rbac/<realm>.py |
clave_de_firma |
El nombre de la variable con la que la API firma sus tokens |
admin.usuario, admin.rol |
El usuario que crea tai-chat db push si el realm no tiene ninguno. Su contraseña es la de ADMIN_PWD |
contrasena_min |
El mínimo que exige el front al cambiar una contraseña: 8 o más, como tai-api |
El chatbot tiene su realm y su clave de firma porque comparte el schema auth con lo que haya
en el repositorio: con la misma clave, otra API sobre el mismo auth aceptaría los tokens del
chatbot, y al revés.
Cambiar clave_de_firma
La autenticación generada por tai-api lleva escrito el nombre de la variable. Después de
cambiarlo hay que regenerarla con tai-chat api generate: tai-chat config check y
tai-chat dev avisan si no se ha hecho. La variable del docker-compose.yaml se cambia a mano.
front¶
front:
nombre: Mantenimiento
idioma: es-ES
logo:
claro: marca/logo.png
oscuro: marca/logo-oscuro.png # opcional: sin él, el claro en los dos temas
icono: marca/favicon.png # opcional: sin él, el claro es también el favicon
powered_by: true
colores:
claro: {primary: "oklch(0.62 0.19 260)"}
oscuro: {primary: "oklch(0.71 0.14 255)"}
bienvenida:
- ¿Qué averías siguen abiertas?
- Resume las intervenciones de esta semana
puerto: 4713
| Clave | Qué hace |
|---|---|
nombre |
El nombre de la aplicación: la cabecera, el título de la pestaña y la pantalla de entrada |
idioma |
El idioma de la interfaz y de las fechas y los importes |
logo |
Rutas relativas a config.yaml. Se copian al front |
powered_by |
El pie con el logotipo de Triple Alpha |
colores |
Variables del tema (las de :root y .dark en src/index.css). Lo que no se dé se queda como en la plantilla |
bienvenida |
Las sugerencias de la pantalla de una conversación vacía |
puerto |
El puerto del front en tai-chat dev |
despliegue¶
Los puertos en Docker, que el compose lee de .env.compose:
hosts son los nombres con los que se puede llegar al front: Vite rechaza los demás.
modelos¶
El catálogo de modelos con los que responde el chat. Tiene su propia página: modelos y consumo.