Skills e instruções de extração¶

Alguns fornecedores têm regras particulares que a IA não tem como adivinhar sozinha — um jeito específico de calcular noites, uma tabela de preço que já inclui imposto, um produto que parece um tipo mas na verdade é outro. Em vez de esperar que a equipe técnica ajuste o sistema para cada caso, você pode dar essa instrução na hora do envio — e guardá-la para reaproveitar depois.

Esse bloco aparece depois de anexar o arquivo e antes de clicar em "Processar Documento", na tela de envio do tarifário.

Canal/Fonte¶

Antes de tudo, um seletor "Canal/Fonte" pergunta para qual canal esse tarifário se destina. Ele não muda como a extração roda — serve para organizar as instruções salvas (skills) por canal, para que a sugestão automática e a lista de skills disponíveis mostrem sempre as opções certas para aquele fornecedor/canal.

Instruções de extração para este upload¶

Dentro do expansor "Instruções de extração para este upload (opcional)" há um campo de texto livre. O texto de exemplo na própria tela já dá a ideia:

"Ex.: 'noites = data_saída − data_chegada − 1' ou 'preços já incluem imposto'. Tem prioridade sobre as regras genéricas do sistema, mas só para o que você mencionar."

Ou seja: a instrução não substitui todo o conhecimento que o sistema já tem sobre como ler um tarifário — ela só ajusta o que você explicitamente descrever. Todo o resto continua funcionando como sempre.

Escreva a instrução em português claro, como se estivesse explicando para uma pessoa nova no time. Frases curtas e diretas funcionam melhor do que parágrafos longos.

Skills salvas (sugestão automática)¶

Se alguém do seu time já salvou uma instrução para esse mesmo fornecedor/canal antes, ela aparece automaticamente num aviso acima do campo de texto, algo como "N skill(s) salva(s) para o canal X — aplique uma delas ou escreva instruções novas abaixo", com um menu "Aplicar skill salva (opcional)". Escolher uma delas preenche o campo de instruções automaticamente — você pode usar como está ou editar antes de processar.

Skills são compartilhadas entre todo o time do mesmo canal — não são privadas de quem criou. Isso é intencional: se você resolve o problema de um fornecedor difícil uma vez, o resto do time se beneficia sem precisar redescobrir a mesma regra.

Plugins padrão do sistema¶

Além das instruções que você escreve, existe um segundo grupo de opções: "Plugins padrão do sistema", mostrado como uma lista de seleção múltipla — blocos de regra por sistema alvo/fonte (ex.: TravelCompositor). Cada plugin tem uma descrição própria (visível ao passar o mouse) explicando o que ele ajusta.

A diferença para as instruções digitadas por você é importante: os plugins são blocos de regra revisados e mantidos pela equipe técnica antes de existirem — não são texto livre criado na hora. Ative os que forem relevantes para o sistema de destino desse tarifário (por exemplo, regras específicas do TravelCompositor).

Se sua empresa sempre trabalha com o mesmo sistema de destino, quem administra o ambiente (super_admin) pode configurar plugins que já vêm pré-marcados automaticamente nessa lista, para todo mundo do tenant — veja Gerenciar empresas. Você ainda pode desmarcar ou marcar outros na hora, isso só define o ponto de partida da tela.

Comparar antes/depois¶

Ao lado do campo de instruções há uma checkbox: "Rodar extração com e sem esta instrução (comparação antes/depois — dobra o custo em tokens)". Ela só fica disponível quando há alguma instrução digitada.

Marcando essa opção, o sistema processa o tarifário duas vezes — uma sem a instrução (como referência) e uma com ela — e mostra, na tela de revisão, uma comparação campo a campo do que mudou em cada produto, além da contagem de checagens automáticas antes e depois. Use isso quando quiser confirmar concretamente que uma instrução nova teve o efeito esperado antes de confiar nela — veja Revisar a extração para o que essa comparação mostra.

Como o nome já diz, essa opção dobra o custo em tokens da extração — não deixe marcada por padrão se não precisar validar a instrução dessa vez.

Salvando uma instrução como skill¶

Depois de processar o documento, se você digitou uma instrução (não apenas aplicou uma já salva), aparece um formulário "Salvar como skill reutilizável" com um campo para o nome da skill (ex.: "Regra de noites — Fornecedor X") e um botão de confirmação.

Se você tinha marcado a comparação antes/depois e ela mostrou uma piora nas checagens automáticas, um aviso chama atenção para isso antes de salvar — vale revisar a instrução nesse caso.

Ao salvar, o sistema roda automaticamente uma auditoria de segurança sobre o texto da instrução (verifica se o texto não tenta manipular a IA de forma indevida) — isso leva um instante e usa uma chamada extra à inteligência artificial. Dois resultados possíveis:

• Aprovada — a skill fica disponível imediatamente para sugestão/reuso nesse canal.
• Reprovada — a skill é salva mas desativada automaticamente: ela não aparece mais em sugestões nem pode ser reaplicada. Isso é raro e normalmente indica um texto que se pareceu, para o verificador automático, com uma tentativa de instrução maliciosa — se isso acontecer com uma instrução legítima, reescreva de forma mais direta e tente salvar de novo, ou fale com quem administra o DataFlow.

Gerenciando skills salvas (listar, editar, ativar/desativar, excluir)¶

A página "Skills", no menu lateral, mostra todas as skills salvas do seu tenant — não só as de um canal específico, com um filtro de Canal no topo ("Todos" ou um canal específico).

A tabela mostra, para cada skill: nome, canal, se está ativa, o status da auditoria de segurança (Aprovada/Reprovada/Pendente) e a taxa de sucesso (quantas vezes ela foi usada com sucesso, do total de vezes que foi aplicada). Essa página é visível para qualquer usuário do seu tenant, não só administradores — assim como qualquer um pode criar uma skill, hoje qualquer um também pode gerenciar as skills compartilhadas do time.

Editar¶

No menu "Editar skill", escolha a skill pelo nome. Isso abre um formulário com:

• Nome — pode ser alterado livremente, sem gerar nova auditoria (o nome não é o texto que vai para a IA).
• Instruções — o texto da instrução. Alterar esse campo dispara uma nova auditoria de segurança automaticamente, exatamente como acontece ao salvar uma skill nova — a skill fica temporariamente indisponível para sugestão até o resultado sair.
• Ativa — mesmo efeito de desativar/reativar (ver abaixo).

Se uma skill aparece com auditoria "Reprovada", o formulário mostra um aviso explicando o motivo antes de você editar — útil para saber o que ajustar no texto.

Ativar e desativar¶

Desmarque "Ativa" no formulário de edição e salve — a skill some das sugestões automáticas e não pode mais ser aplicada, mas continua salva (com todo o histórico de uso) e pode ser reativada a qualquer momento marcando a caixa de novo.

Excluir¶

Resumo rápido¶