Esquema JSONL de prueba para Qwen y su uso

Fecha de creación: 28 de junio de 2026

Propósito

Crear fragmentos de código de Godot con Qwen y, para esos fragmentos, adjuntar JSONL de respuestas correctas y JSONL de respuestas incorrectas para validar con “sí”/“no”. Este documento resume el formato JSONL de referencia y el propósito de cada JSONL.

Este no es un documento que proporcione datos de ejemplo. Es una referencia de esquema para verificar qué JSONL cumple qué función y qué campos se utilizan para la evaluación directa.

Criterios comunes

JSONL escribe un objeto JSON por línea.

{...}
{...}
{...}

En la prueba, no se coloca un contenedor que envuelva el nombre de la tabla, sino que los campos que corresponden a las columnas de la tabla objetivo se colocan en el nivel superior.

Bueno:
{"chunk_id":"...","content":"...","code_blocks":[...]}

Evitar:
{"table":"docs_chunks","payload":{"chunk_id":"..."}}

Los campos que se generan automáticamente en la base de datos o que se usan para el índice de búsqueda no necesitan ser completados directamente en el JSONL de prueba.

Lo importante en la verificación de evidencia directa de Qwen es “qué campo dentro del JSONL coincide directamente con la cadena/API/patrón real del SOURCE_CODE”.

docs_chunks

Uso

docs_chunks es un JSONL que almacena la explicación de la documentación oficial, tutoriales y el cuerpo de la referencia de clases en unidades de fragmentos.

Se utiliza para solicitar explicaciones de código, verificar el uso de API comunes, y confirmar explicaciones de la sintaxis común de Godot 3/4. Es una base para determinar “qué tan directamente relacionado está este código con alguna explicación de la documentación oficial”, más que para las reglas de migración en sí.

Formato JSONL

{
  "chunk_id": "text, required",
  "doc_version": "text, required",
  "source_url": "text, required",
  "source_file": "text, required",
  "source_sha256": "text, required",
  "doc_type": "text, required",
  "symbol": "text or null",
  "section_path": "array, required",
  "heading": "text or null",
  "content": "text, required",
  "code_blocks": "array, required",
  "language_tags": "array<string>",
  "godot_version_tags": "array<string>",
  "api_symbols": "array<string>",
  "token_count": "integer or null",
  "metadata": "object"
}

Directamente basado en evidencia del campo

Rol en las pruebas

api_mapping

Propósito

api_mapping es un archivo JSONL que almacena cómo cambian los nombres, nombres de clase, nombres de función y nombres de símbolo de Godot 3 a Godot 4.

Se usa para determinar cambios de nombre simples, renombrados, reemplazos o APIs obsoletas/eliminadas. Los casos en los que cambia todo el modo de usar una función se manejan más en la sección label_prototypes.

Formato JSONL

{
  "mapping_id": "text, required",
  "source_api": "text, required",
  "target_api": "text or null",
  "change_type": "text, required",
  "godot_from": "text, required",
  "godot_to": "text, required",
  "confidence": "text, required",
  "evidence_chunk_ids": "array<string>",
  "match_terms": "array<string>",
  "notes": "text",
  "negative_patterns": "array<string>"
}

Directamente basado en evidencia del campo

Rol en las pruebas

label_prototypes

Uso

label_prototypes es un JSONL que almacena ejemplos donde no solo cambia el nombre, sino que también se modifica por completo la forma de usar la función, la composición de argumentos y el patrón de llamada.

Si api_mapping responde a “qué nombre cambió a cuál”, label_prototypes se acerca a “qué patrón de código debe emplearse”.

Formato JSONL

{
  "prototype_id": "text, required",
  "label": "text, required",
  "task_type": "text, required",
  "input_pattern": "text, required",
  "expected_finding": "text, required",
  "recommended_action": "text, required",
  "evidence_mapping_ids": "array<string>",
  "evidence_chunk_ids": "array<string>",
  "severity": "text",
  "validator_rules": "object"
}

validator_rules puede tener los siguientes subcampos.

{
  "required_when_seen_in_code": "array<string>",
  "before_code": "text",
  "after_code": "text",
  "reject_when_seen_in_code": "array<string>"
}

Campos vistos como evidencia directa

Rol en las pruebas

Límite de los tres JSONL

Manejo de sintaxis común