Como preparar o arquivo de importação
O arquivo pode ser gerado pela IA da sua empresa a partir dos documentos de checklist existentes. O Cata confere tudo antes de gravar.
Passo a passo
- Copie o texto abaixo e cole na ferramenta de IA da sua empresa, junto com os documentos dos checklists. Se a ferramenta aceitar arquivos, envie também o exemplo e o JSON Schema.
- Salve a resposta da IA como um arquivo
.json. Se a IA listar dúvidas depois de uma linha---, retire essa parte do arquivo e resolva as dúvidas antes. - Em Importar, escolha o arquivo e clique em Verificar. O Cata mostra o que seria criado e aponta cada erro com o caminho no JSON (por exemplo
questions[3].type; a contagem começa em 0). - Se houver erros, peça à IA para corrigi-los colando a lista de erros, e verifique de novo.
- Clique em Importar. Cada checklist vira um rascunho; revise e publique em Checklists. Depois, em Escopos, escolha o checklist de cada modelo em cada serviço; o código do checklist fica no escopo.
Arquivos grandes podem ser divididos: perguntas já importadas são reconhecidas pelo código e podem ser usadas pelos checklists dos arquivos seguintes.
Texto para a IA
Você vai converter checklists de vistoria veicular para o formato de importação do sistema Cata.
Vou enviar os documentos (Word, PDF ou planilhas). Responda somente com um único JSON válido, sem comentários e sem texto antes ou depois.
Formato:
{
"format": "cata-checklist-import/v1",
"questions": [ ...perguntas... ],
"checklists": [ ...checklists... ]
}
Perguntas ("questions"): cada pergunta aparece uma só vez no arquivo, mesmo que seja usada em vários checklists.
- "code": identificador permanente, em MAIÚSCULAS, só letras sem acento, números e sublinhado, até 40 caracteres. Ex.: "PINTURA_ESTADO_GERAL". Use o mesmo código para a mesma pergunta em todos os checklists.
- "statement": o texto da pergunta como o vistoriador vai ler, até 300 caracteres.
- "type": um destes valores:
- "c_nc_a" quando a resposta é Conforme / Não conforme / Ausente;
- "sim_nao_na" quando a resposta é Sim / Não / Não aplicável;
- "selecao" quando o vistoriador escolhe uma opção de uma lista (ex.: marca de um equipamento);
- "texto" quando a resposta é livre (ex.: Km, número de série, observação).
- "options": somente para "selecao", lista com pelo menos duas opções, sem repetir.
- "subitems": somente para "c_nc_a" e "sim_nao_na", opcional. São os detalhes que se abrem quando a resposta é Não conforme ou Não (ex.: "Pontos de ferrugem"). Cada subitem tem até 120 caracteres.
Checklists ("checklists"):
- "name": nome do checklist, até 120 caracteres, sem repetir no arquivo.
- "categories": lista de categorias em ordem. Cada categoria tem "name" e "items".
- "items": os códigos das perguntas, em ordem, por exemplo ["KM", "PINTURA_ESTADO_GERAL"]. Cada pergunta aparece uma só vez em cada checklist. Se uma pergunta for opcional, use {"question": "CODIGO", "required": false}.
Regras:
- Todo código usado em "items" precisa estar em "questions" (ou já existir no Cata).
- Se dois documentos têm a mesma pergunta com palavras um pouco diferentes, use uma única pergunta e um único código.
- Não invente perguntas que não estão nos documentos. Se algo estiver ambíguo, escolha a interpretação mais simples e liste as dúvidas para mim depois do JSON, separadas por uma linha "---".
O que acontece com o que já existe no Cata
- Pergunta com código novo: é criada na versão v1.
- Pergunta com código existente e mesmo conteúdo: nada muda.
- Pergunta com código existente e conteúdo diferente: ganha uma nova versão. Checklists já publicados continuam usando a versão anterior até alguém publicar um rascunho com a nova.
- Checklist com nome novo: é criado com o rascunho v1.
- Checklist com nome existente: recebe um novo rascunho com exatamente o conteúdo do arquivo. Se ele já tiver um rascunho aberto, a importação é recusada até esse rascunho ser publicado ou descartado.
- Erros: se houver qualquer erro, nada é importado.
Exemplo
{
"format": "cata-checklist-import/v1",
"questions": [
{ "code": "KM", "statement": "Km", "type": "texto" },
{ "code": "PLAQUETA_ANO", "statement": "Plaqueta do ano de fabricação", "type": "c_nc_a" },
{
"code": "PINTURA_ESTADO_GERAL",
"statement": "Estado geral da pintura",
"type": "c_nc_a",
"subitems": ["Condição original", "Apresentando repintura", "Pontos amassados", "Pontos de ferrugem"]
},
{
"code": "RASTREADOR_MARCA",
"statement": "Marca do rastreador",
"type": "selecao",
"options": ["Omnilink", "Sascar", "Onixsat", "Outra"]
},
{
"code": "EXTINTOR_VALIDO",
"statement": "Extintor dentro da validade?",
"type": "sim_nao_na",
"subitems": ["Lacre rompido", "Manômetro fora da faixa"]
}
],
"checklists": [
{
"name": "Vistoria de carro de passeio",
"categories": [
{ "name": "Identificação", "items": ["KM", "PLAQUETA_ANO"] },
{ "name": "Carroceria", "items": ["PINTURA_ESTADO_GERAL"] },
{
"name": "Equipamentos",
"items": ["EXTINTOR_VALIDO", { "question": "RASTREADOR_MARCA", "required": false }]
}
]
}
]
}