Cómo funciona · ejemplosHow it works · examples
Tú decides qué información necesitas: tickets, productos, pedidos o los datos de tu aplicación. mini-format te ayuda a definir cómo debe responder la IA, comprobar su respuesta y convertirla en datos que puedas usar.You decide what information you need: tickets, products, orders or your application's data. mini-format helps you define how the AI should respond, check its answer and turn it into data you can use.
01 · Entiende el proceso01 · Understand the process
.mini es un formato de texto para intercambiar datos. Un contrato es el archivo que define sus reglas: qué campos hay, en qué orden aparecen y qué valores aceptan. Tú lo creas para tu aplicación. El prompt explica esas reglas a la IA; el parser lee y comprueba lo que devuelve..mini is a text format for exchanging data. A contract is the file that defines its rules: which fields exist, their order and the values they accept. You create it for your application. The prompt explains these rules to the AI; the parser reads and checks its response.
Imagina una aplicación que convierte mensajes de clientes en tickets. Cada ticket necesita un identificador, prioridad, categoría, resumen y horas estimadas. Este JSON muestra la información que queremos obtener.Imagine an application that turns customer messages into tickets. Each ticket needs an ID, priority, category, summary and estimated hours. This JSON shows the information we want to obtain.
__MUESTRA_JSON__
Si tu aplicación maneja productos o pedidos, eliges sus campos. Puedes repetir este proceso con tu propia estructura.If your application handles products or orders, choose their fields. You can repeat this process with your own structure.
En este ejemplo el contrato se llama tk. Fija estos cinco campos, su orden y los valores permitidos. Así, la IA y tu aplicación comparten las mismas reglas.In this example the contract is named tk. It defines these five fields, their order and allowed values, so the AI and your application share the same rules.
mini from-schema ticket.schema.json -p tk --out contrato.json mini prompt --contract contrato.json --lang es
¿Tienes muestras JSON en vez de un esquema? mini build crea tu toolkit con contrato, prompt, parser y validador. Más abajo puedes crear el tuyo.Have JSON samples instead of a schema? mini build creates your toolkit with a contract, prompt, parser and validator. You can create your own below.
Añades el prompt generado a tu petición. La primera línea identifica el contrato y el número de registros; cada línea siguiente contiene un ticket. Los valores siguen el orden acordado y se separan con |.Add the generated prompt to your request. The first line identifies the contract and record count; each following line contains a ticket. Values follow the agreed order and are separated by |.
__MUESTRA_MINI__
__PROMPT_MUESTRA_ES__
__PROMPT_MUESTRA_EN__
Los nombres de los campos ya están en el contrato, así que la respuesta puede centrarse en los valores. El ahorro depende de tus datos y de las instrucciones que añadas.Field names are already in the contract, so the response can focus on values. Savings depend on your data and the instructions you include.
from minifmt import Contract, parse
contrato = Contract.load("contrato.json")
doc = parse(respuesta, contrato, strict=False)
registros = doc.records
errores = doc.errorsLa muestra produce 2 registros válidos y 0 errores, con los campos y tipos del JSON original. Puedes guardarlos en tu base de datos o devolverlos desde tu API.The sample produces 2 valid records and 0 errors, with the fields and types of the original JSON. You can store them in your database or return them from your API.
Si la IA escribe un valor inválido o corta la respuesta, el parser indica qué falló. Tu aplicación conserva los registros válidos y puede volver a pedir los que faltan. La demo de abajo muestra ese proceso.If the AI writes an invalid value or truncates its answer, the parser reports what failed. Your application keeps valid records and can request missing ones again. The demo below shows that process.
02 · Ejemplo interactivo02 · Interactive example
Esta es una aplicación de muestra para entender cómo integrar .mini. Recibe diez mensajes, pide a la IA que los convierta en tickets y valida la respuesta. Tú puedes aplicar el mismo proceso a los datos de tu proyecto.This sample application shows how to integrate .mini. It receives ten messages, asks the AI to turn them into tickets and validates the response. You can apply the same process to your project's data.
Empieza sin clave: usa el modo Grabado, elige “Un valor inválido” o “Respuesta cortada” y pulsa “Crear tickets con IA”. Después cambia entre .mini y JSON para ver qué aprovecha esta aplicación. Las respuestas están guardadas; la validación se ejecuta aquí.Start without a key: use Recorded mode, select “One invalid value” or “Truncated answer” and press “Create tickets with AI”. Then switch between .mini and JSON to see what this application can use. Responses are stored; validation runs here.
__MESA_DEMO__