Saltar a contenido

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:

despliegue:
  api:
    puerto: 5000
  front:
    puerto: 5173
    hosts: [localhost, chat.miempresa.com]

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.