Esquema JSONL de teste do Qwen e seu uso

Data de criação: 28 de junho de 2026

Propósito

Criar trechos de código Godot com o Qwen e, ao anexar JSONL de respostas corretas e JSONL de respostas incorretas a esses trechos de código para validação “sim”/“não”, organizar o formato JSONL de referência e a finalidade de cada JSONL.

Este documento não fornece dados de exemplo. É um documento de referência de esquema para verificar, durante os testes, qual JSONL desempenha qual papel e quais campos são usados para a avaliação de evidência direta.

Critério comum

JSONL escreve um objeto JSON por linha.

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

Nos testes, não há um wrapper envolvendo o nome da tabela; os campos correspondentes às colunas da tabela de destino são colocados no nível superior.

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

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

Campos que são gerados automaticamente no DB ou usados para o índice de pesquisa não precisam ser preenchidos diretamente no JSONL de teste.

No que diz respeito à verificação de evidência direta do Qwen, o importante é “qual campo no JSONL corresponde diretamente à string/API/padrão real do SOURCE_CODE”.

docs_chunks

Uso

docs_chunks é um JSONL que armazena explicações de documentação oficial, tutoriais e o corpo de referências de classes em unidades de chunk.

É usado para solicitar explicações de código, verificar o uso comum da API, confirmar explicações de sintaxe comum do Godot 3/4. Serve como base para determinar “quão diretamente este código está relacionado a alguma explicação da documentação oficial”, mais do que para as próprias regras de migração.

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"
}

Como campo visto como evidência direta

Papel nos testes

api_mapping

Uso

api_mapping é um arquivo JSONL que registra como nomes, nomes de classe, nomes de função e nomes de símbolos mudaram do Godot 3 para o Godot 4.

É usado para decisões de mudança de nome simples, rename, replacement, APIs depreciadas/removidas. Exemplos em que todo o modo de usar a função muda são mais adequados para a seção 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>"
}

Evidência direta por campo

Papel nos testes

label_prototypes

Uso

label_prototypes é um JSONL que armazena exemplos nos quais não se trata apenas de renomear, mas de mudar completamente a forma de usar a função, a composição dos argumentos e o padrão de chamada.

Se api_mapping responde “qual nome foi trocado por qual”, então label_prototypes se aproxima de “como o código deve ser escrito em termos de padrão”.

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 pode ter os seguintes subcampos.

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

Evidência direta por campo

Papel nos testes

Limites dos três JSONL

Tratamento de sintaxe comum

Se a sintaxe for a mesma em Godot 3 e Godot 4, não se considera diferença de versão.