El
Una solución de GrailAOS™ es un conjunto de documentos de texto versionados que declaran qué hace un negocio, y un la verifica entera antes de que algo corra. Esta página lo cuenta en conceptos, sin la sintaxis: el motor es propietario.
Qué es una solución
Un chatbot se configura; un negocio se programa. En GrailAOS, el negocio se declara en documentos de texto: cada uno dice qué es una pieza y a qué otras nombra, y el conjunto de esos documentos es la solución.
Escribirla, compilarla, probarla, publicarla, operarla y corregirla es un ciclo pensado para que lo recorra un modelo: el compilador le devuelve lo que encontró, y el modelo corrige con eso.
Una solución de GrailAOS es un conjunto de documentos de texto versionados: el manifiesto, agentes, procesos, herramientas, bases de conocimiento, plantillas de respuesta, tareas programadas, casos de prueba, colecciones de datos y funciones que el dueño prende y apaga.
Las piezas
Cada pieza declara una parte del negocio y nombra a las otras que necesita; el compilador revisa esos nombres.
Qué declara cada pieza
Nombra la pieza por la que entra cada conversación.
Conversan por los canales, usan herramientas y conocimiento, y delegan en otros agentes.
Encadenan pasos, bifurcaciones y decisiones; los que corren solos suman listas, ramas en paralelo, otros procesos y aprobaciones.
Las incluidas, las integraciones HTTP, las de servidores y las del código de arranque del .
Límite Varias herramientas incluidas dependen de la configuración o del código de arranque del deployment.
Los agentes las consultan por significado y por texto.
Límite La búsqueda antes de responder es opcional en cada agente y viene apagada.
Límite Se activa por configuración; revisa después de entregar, sin corregir la respuesta.
Las envían los procesos en sus pasos de mensaje o plantilla.
Corren procesos, campañas, reportes e ingesta de datos en su horario.
Viven dentro de los agentes y de los procesos que prueban.
Los datos propios de cada , con la forma declarada en la solución.
Límite Las herramientas de colecciones las habilita el código de arranque del deployment.
Lo que el dueño prende o apaga junto, sin publicar una versión.
El manifiesto
Un agente
Un proceso
Una tarea programada
Una función del dueño
Una herramienta
Por qué texto
Que una solución sea texto no es un detalle de formato: es el primero de los principios de diseño de GrailAOS.
Versionado quiere decir que cada documento declara la versión de la especificación con la que fue escrito, y que la solución entera se publica por versiones.
Unos pocos principios guían el diseño: texto primero, autocontenido, testeable por defecto, componible, observable e independiente del canal, con formas predecibles que toleran salidas parcialmente correctas; ningún cambio puede hacerle más difícil a un modelo escribir bien una solución.
Lo que se repite entre soluciones se importa de una biblioteca con su versión fija, en vez de copiarse: nada se enlaza por coincidencia de nombre y una versión publicada no cambia nunca.
Límite Se importan al compilar, en la línea de comandos.
Cada documento declara la versión de la especificación con la que fue escrito: el acepta lo escrito para versiones anteriores de la misma versión mayor y no carga lo escrito para una más nueva que él.
Límite Una versión menor puede cambiar comportamientos, y entre versiones mayores no hay migración automática.
El compilador
El compilador recibe los documentos y devuelve un reporte con todos los errores de la solución, en una sola pasada.
Las seis etapas, en una sola pasada
Corre hoyUn reporte con todos los errores que encontró
Medido en los repositorios
Antes de que algo corra, el compilador verifica la solución entera en seis etapas, de la lectura de cada documento al grafo de cada proceso, y reporta en una sola pasada todos los errores; es la misma compilación en la línea de comandos, por y al arrancar el runtime.
La compilación es una función pura y determinística: no toca el disco ni la red, no llama a ningún modelo y, con la misma entrada, produce el mismo reporte, con los diagnósticos en un orden estable.
Los códigos de diagnóstico son estables: se agregan, no se renombran ni se reutilizan, para que lo que se automatiza hoy siga valiendo mañana.
Límite La prueba que los protege cubre una parte de los códigos.
Si algo es válido pero el runtime no lo ejecuta, el compilador lo avisa en vez de aceptarlo en silencio.
Límite El aviso cubre una lista cerrada de casos.
Diagnósticos
Un diagnóstico de GrailAOS está escrito para que lo lea un modelo: dice qué pasó, por qué, dónde exactamente y cómo arreglarlo, y la sugerencia de arreglo trae su nivel de confianza.
Arreglos
Un diagnóstico no termina en un aviso. Algunos errores frecuentes tienen un arreglo automático y determinístico; para el resto, el modelo corrige con lo que le devuelve el compilador, que vuelve a verificar la solución.
El ciclo de un arreglo
ParcialCorre hoyOtra vezLo que devuelve el compilador vuelve al modelo, que corrige con eso.
Algunos errores frecuentes tienen un arreglo automático y determinístico; para el resto, el modelo corrige con lo que le devuelve el compilador, que vuelve a verificar la solución.
Límite El ciclo asistido corre sólo en la línea de comandos.
Pruebas
Los casos de prueba viven dentro de los agentes y de los procesos. Todo lo externo se simula, y el reporte distingue lo validado de lo simulado.
El camino de un caso de prueba
Corre hoyLos casos de prueba viven dentro de los agentes y procesos de la solución y corren con el mismo motor que atiende los canales, también en conversaciones de varios turnos; una conversación que se derivó a una persona puede convertirse en un caso.
Límite Un proceso que corre solo no se prueba entero en un caso: se prueban sus agentes.
En las pruebas, todo lo externo se simula, y un caso corre con el modelo real o en modo simulado: el reporte distingue lo que validó al agente de lo que sólo se simuló.
Límite Por defecto, un caso de agente corre en modo simulado.
Las pruebas están pensadas para no dar un falso verde, y hay una puerta de pruebas al activar una solución y al promover una versión nueva.
Límite En la puerta, por defecto los casos que fallan avisan; bloquear se declara en la solución.
Lo que no se puede comparar al pie de la letra lo evalúa un modelo juez, con votación configurable y un tope de gasto por corrida.
Preguntas
Todo lo externo. Un caso de agente también puede correr en modo simulado, el de por defecto, que no prueba al modelo: el reporte lo separa de lo validado.
Como cliente, con las herramientas de cada servidor fijadas en la solución. El MCP público de este sitio es otra cosa: sirve el contenido del sitio.
Corre hoyMCP como cliente
Un agente usa las herramientas de un servidor MCP externo, con el runtime como cliente: la cuenta lo conecta una vez, con una clave o con , sus herramientas quedan fijadas en la solución y la conexión pasa por la misma guarda de red.
Límite Sólo las herramientas, no los recursos ni los ; si el servidor cambia una, por defecto la llamada sigue con un aviso; la conexión es de la cuenta.