Para demonstrar um assistente de IA sem expor arquivos da empresa, monte uma coleção de documentos inventados desde a origem, identifique cada arquivo como sintético e execute a aplicação em um ambiente separado. Use perguntas e respostas esperadas previamente revisadas. Assim, a apresentação mostra como o fluxo funciona e permite repetir os mesmos cenários sem depender de cadastros, contratos ou mensagens reais.
A recomendação deste guia é tratar a demonstração como um produto próprio: documentos versionados, integrações simuladas, acesso limitado e um roteiro de falhas. Dados sintéticos não comprovam desempenho em produção, ausência de vazamento ou conformidade. Eles ajudam a verificar comportamentos delimitados, como encontrar uma cláusula fictícia, reconhecer informação ausente e impedir uma ação fora do ambiente de teste.
Resumo rápido
- Escreva documentos novos, sem copiar registros ou estruturas identificáveis de clientes.
- Repita o rótulo sintético no conteúdo, nos metadados e na interface.
- Use identificadores incompatíveis com cadastros reais e contatos no domínio .invalid.
- Congele arquivos, perguntas e respostas esperadas em um conjunto de fixtures.
- Separe credenciais, índices, armazenamento e destinos de mensagens.
- Apresente limitações e resultados somente dentro do cenário demonstrado.
Defina o que a demonstração precisa comprovar
Comece com uma pergunta operacional: qual decisão o público deve conseguir avaliar? Uma apresentação de busca documental pode mostrar a origem de uma resposta, o tratamento de versões conflitantes e a recusa quando falta informação. Isso é diferente de demonstrar integração com um sistema financeiro ou comprovar acurácia em uma população de documentos reais.
Recomendação: escreva três critérios observáveis antes de gerar qualquer arquivo. Por exemplo, localizar o prazo descrito na política fictícia, indicar o documento usado e pedir esclarecimento quando a pergunta menciona uma regra inexistente. Evite critérios como parecer inteligente, que dependem da impressão de quem assiste e não permitem verificar regressões.
Desenhe também o caminho da falha. Uma pergunta sem resposta deve terminar em informação insuficiente, sem uma regra inventada. Um documento ilegível deve aparecer como falha de extração. Um pedido de envio deve produzir uma simulação visível. O roteiro precisa incluir essas saídas, porque elas ajudam a compreender os limites do sistema.
Para organizar critérios mais amplos, consulte o guia sobre como testar um agente de IA antes da produção. A demonstração aqui proposta é uma etapa controlada desse trabalho, com escopo menor e sem substituir a avaliação posterior com dados e permissões adequados.
Crie um corpus fictício e identificável
Corpus é o conjunto de documentos consultado pela aplicação. Recomendação: escreva esse conjunto a partir de regras inventadas e situações genéricas. Não use contratos reais trocando apenas os nomes. Endereços, combinações de valores, observações e cláusulas particulares ainda podem revelar a origem de um documento.
Escolha nomes explicitamente artificiais, como Empresa Demonstração Ipê, e códigos como DEMO-CLIENTE-A001. Não gere números com aparência de CPF, CNPJ, chave de nota fiscal ou conta bancária válida. Se o sistema exige esse formato para avançar, ajuste o adaptador de demonstração para aceitar um tipo próprio, sem criar uma exceção no validador usado em produção.
A RFC 2606 reserva o domínio de topo .invalid para nomes reconhecidamente inválidos. Um endereço como contato@empresa-demo.invalid sinaliza a intenção do exemplo. Isso não substitui bloquear o envio no aplicativo: uma ferramenta ainda pode tentar transmitir a mensagem, e configurações locais podem alterar a resolução de nomes.
Insira uma frase inequívoca no início de cada arquivo: Documento sintético para demonstração. Nenhuma pessoa, obrigação ou transação descrita é real. Repita o marcador no rodapé, no nome do arquivo e nos metadados, por exemplo synthetic=true e environment=demo. Mantenha o rótulo também em trechos extraídos, anexos e exportações.
| Elemento | Exemplo recomendado | Verificação |
|---|---|---|
| Cliente | DEMO-CLIENTE-A001 | Produção rejeita o prefixo |
| Contato | equipe@loja-demo.invalid | Saída de mensagens desabilitada |
| Política | SINTETICO-politica-trocas-v1 | Marcador presente no texto extraído |
| Pedido | DEMO-PEDIDO-0001 | Não existe rota para o ERP real |
| Resposta | Simulação baseada em documento sintético | Aviso acompanha a exportação |
Separe a aplicação e simule as integrações
Recomendação: use um projeto de demonstração com armazenamento, índice de busca e usuários próprios. Não aponte o assistente para uma pasta real contando apenas com o prompt para ignorar arquivos confidenciais. A separação precisa existir nas configurações e nas permissões que controlam o acesso.
Substitua ferramentas de escrita por adaptadores simulados. Uma função de abrir chamado deve registrar um evento local identificado como simulação. Uma função de cobrança deve devolver um comprovante fictício sem chamar o provedor de pagamento. O público precisa ver qual ação foi simulada, em vez de receber uma confirmação que sugira execução real.
Faça um inventário dos destinos: rede, e-mail, mensageria, banco de dados, armazenamento e logs. Defina uma lista explícita do que pode ser acessado. Remova credenciais de produção e desabilite conectores que não fazem parte do roteiro. Na abertura da aplicação, uma checagem deve impedir o início quando encontrar ambiente ou destino incompatível.
Quando houver um serviço externo de geração, registre que existe comunicação com esse serviço e confira suas condições separadamente. Um corpus inventado não torna automaticamente fictícios o nome do operador, a conversa digitada ao vivo ou os metadados de acesso. Para estudar o alcance das permissões, veja como limitar o que um agente pode fazer.
Congele fixtures e prepare perguntas de controle
Fixture é um conjunto preparado de entradas e condições de teste. A documentação do pytest explica como fixtures reutilizam preparações e permitem iniciar testes com dados consistentes. Para uma apresentação, a recomendação é manter documentos, consultas e expectativas juntos, em uma versão que possa ser restaurada.
Um manifesto pode listar identificador, nome do arquivo, versão do gerador, semente, hash SHA-256, classificação sintética e cenário associado. O módulo hashlib do Python oferece SHA-256. Use o resumo criptográfico para conferir se os bytes do arquivo mudaram, sem tratá-lo como prova de que o conteúdo é verdadeiro ou seguro.
Se usar geração pseudoaleatória, registre a semente e fixe a versão do programa, as dependências e a ordem das entradas. A documentação de random descreve a inicialização por semente e alerta que seus geradores não servem para segurança. Não utilize a mesma técnica para tokens de acesso. Prefira guardar os arquivos finais: a semente sozinha não documenta todas as condições de geração.
Recomendação: separe perguntas de apresentação das perguntas de controle. A primeira coleção explica o percurso ao público; a segunda tenta encontrar defeitos. Inclua pergunta com resposta literal, pergunta que exige combinar documentos, informação ausente, regra contraditória, arquivo sem texto e pedido para ultrapassar uma permissão.
Para cada pergunta, anote quais fatos precisam aparecer, quais fontes devem ser recuperadas e o que não pode ser afirmado. Não exija uma redação idêntica se o objetivo é avaliar fundamentação. Repetibilidade das entradas não garante repetibilidade textual da geração. Compare o comportamento definido, preservando a resposta observada e a configuração utilizada.
Antes da sessão, execute uma conferência automática do pacote: todos os documentos devem ter marcador sintético, nenhum identificador pode sair do prefixo DEMO e os hashes precisam corresponder ao manifesto aprovado. Em seguida, abra uma pergunta de controle e confirme os documentos recuperados. Recomendação: interrompa a apresentação se qualquer uma dessas condições falhar. Corrigir a base durante a sessão muda o cenário e dificulta explicar o que foi efetivamente avaliado. Se uma alteração for necessária, gere uma nova versão e repita a conferência. Registre também a pessoa responsável pela liberação, para que a equipe saiba qual pacote está autorizado para compartilhar.
Exemplo: distribuidora fictícia em Campinas
Considere uma distribuidora de materiais de escritório em Campinas que deseja apresentar uma busca de políticas comerciais. O caso é ilustrativo. A equipe cria a Empresa Demonstração Ipê, sem correspondência com uma organização real, e inventa uma política de entrega, uma tabela de regiões atendidas e um manual de devoluções.
O primeiro documento determina que pedidos DEMO de uma região fictícia precisam de confirmação manual. O segundo não informa prazo para outra região. O terceiro contém duas versões de uma regra, com uma delas marcada como substituída. Esses detalhes são escolhas do cenário, sem representar práticas comerciais ou resultados medidos de uma distribuidora existente.
Na apresentação, a pessoa pergunta sobre a região com confirmação manual. O comportamento esperado é citar a regra e mostrar o botão de encaminhamento simulado. Depois, pergunta pelo prazo ausente. A aplicação deve explicar que a base não contém essa informação. Por fim, uma consulta à regra antiga verifica se a interface distingue a versão substituída.
Recomendação: restaure o estado inicial entre sessões. Limpe a conversa, remova eventos simulados e reconstrua o índice a partir da versão aprovada. Mantenha uma cópia de conferência do manifesto. Se alguém carregar um arquivo próprio durante a demonstração, interrompa esse fluxo e use um procedimento separado, com autorização e avaliação do conteúdo.
Erros comuns
Chamar cópia mascarada de sintética. Trocar nomes em um documento real não comprova que ele deixou de carregar informações identificáveis. Para este tipo de demonstração, prefira elaboração do zero e revisão de origem. Registre quem criou o conteúdo e confirme que nenhum anexo veio de uma base operacional.
Deixar o aviso apenas na tela inicial. Uma captura ou exportação pode circular sem esse contexto. Recomendação: inclua o rótulo no arquivo e na resposta exportada. Verifique também miniaturas, nomes de anexos e trechos retornados pela busca, pois são superfícies que o público pode compartilhar.
Medir só perguntas favoráveis. Uma coleção cuidadosamente simplificada pode esconder ambiguidades, ruído de digitalização e variedade de formatos. Explique o que o cenário cobre e registre os casos ausentes. A discussão sobre alucinação e fundamentação de respostas ajuda a interpretar respostas convincentes que não encontram apoio nos documentos.
Prometer privacidade ou desempenho real. O ensaio mostra o comportamento nas condições preparadas. Não demonstra resistência a todo ataque, representatividade dos arquivos da empresa ou conformidade de um tratamento futuro. Recomendação: encerre com uma lista de verificações pendentes para o piloto, com responsáveis e critérios de passagem.
Perguntas frequentes
Posso pedir que a própria IA invente os documentos?
Sim, como auxílio de redação. Recomendação: forneça apenas regras fictícias e revise o resultado antes de usar. Remova contatos que pareçam reais, afirmações sobre empresas existentes e identificadores operacionais. Guarde a versão final aprovada, pois gerar novamente pode produzir uma coleção diferente.
Preciso de centenas de arquivos para uma boa demonstração?
Não há uma quantidade universal. Escolha arquivos suficientes para cobrir os comportamentos prometidos, incluindo falhas e informação ausente. Volume só deve virar objetivo quando a apresentação pretende avaliar carregamento, recuperação ou operação sob condições de escala claramente definidas.
Uma semente fixa torna a resposta da IA determinística?
Não. A semente do gerador de documentos controla uma parte da preparação. A geração de respostas depende de outras condições. Recomendação: congele o corpus e as configurações, preserve as saídas e avalie fatos, fontes e decisões, sem prometer frases iguais em toda execução.
Posso usar os documentos sintéticos depois no treinamento da equipe?
Sim, desde que a finalidade continue explícita. Recomendação: distribua o pacote com instruções de restauração, limitações e proibição de tratar suas regras como políticas reais. Separe exercícios de aprendizagem das avaliações de prontidão para produção.
Qual é o critério para encerrar a demonstração?
Recomendação: confirme que o roteiro e os casos de controle foram executados, os rótulos permaneceram visíveis e nenhum destino real recebeu ações. Entregue o manifesto e as limitações conhecidas. Um piloto posterior deve ter critérios próprios para dados, segurança, qualidade e operação.
