Manual do Usuário

Guia completo do O Estagiário, em etapas: da instalação ao primeiro documento gerado, com a explicação de cada tela, de cada opção e das proteções do sistema. Atualizado em junho de 2026 (versão 0.17).

1. Antes de começar: como o programa pensa

O O Estagiário funciona em volta de quatro ideias simples. Entendê-las torna todo o resto natural:

• Agente — um "funcionário virtual" que você configura uma vez: ele tem uma profissão (especialidade), um provedor de IA, três pastas de trabalho e uma rotina (horário e/ou monitoramento de pasta). Você pode ter vários agentes, um para cada cliente ou tipo de documento.
• Pasta de Modelos — os documentos de referência (somente leitura). O agente estuda esta pasta, monta um catálogo dos modelos e usa o modelo certo como base de cada documento — sem nunca alterá-lo, removê-lo ou resumi-lo.
• Pasta de Rascunho — os insumos de cada trabalho (textos, fotos, dados). Cada subpasta vira um documento. Concluído e aprovado, o trabalho é movido para a subpasta Processados e não é refeito.
• Pasta de Entrega — onde os documentos prontos são gravados (.docx, ou .xlsx quando o modelo é uma planilha).

A inteligência vem de um provedor de IA (Claude, OpenAI ou Gemini) usando a sua própria conta — você paga os tokens diretamente ao provedor, sem intermediação nossa. Os seus documentos ficam no seu computador, em banco de dados cifrado; nós nunca os recebemos.

2. Etapa 1 — Instalação

2.1 Requisitos

• Windows 10 (versão 1809 ou superior) ou Windows 11, 64 bits.
• Não é preciso instalar nada antes (nem .NET): o instalador já traz tudo.
• Conexão com a internet (para a IA gerar os documentos).

2.2 Passo a passo

1. Baixe o OEstagiario-Setup.exe pelo link recebido na compra.
2. Execute o instalador como administrador. Se o Windows SmartScreen exibir um aviso de "editor desconhecido", clique em Mais informações → Executar assim mesmo — o aviso aparece porque o instalador ainda não tem assinatura digital de editor, não por problema no arquivo.
3. Siga o assistente. Ao final, o instalador:
   • instala o aplicativo (a interface que você usa) e o Serviço do Windows (o orquestrador que gera documentos nos horários agendados, mesmo com o aplicativo fechado);
   • inicia o serviço automaticamente;
   • cria os atalhos no Menu Iniciar (e na área de trabalho, se você marcar a opção).

2.3 Atualização e desinstalação

• Atualizar: basta executar o instalador da versão nova por cima — ele fecha o aplicativo e o serviço, troca os arquivos no mesmo local e religa tudo. Os seus dados são preservados (agentes, provedores, memórias, ativação).
• Desinstalar: pelo Painel de Controle/Configurações do Windows. Ao final, o desinstalador pergunta se você também quer remover todos os dados (configurações, memórias aprendidas e chaves de API). Essa remoção é irreversível — se pretende reinstalar depois mantendo tudo, responda Não.

3. Etapa 2 — Ativação do computador

Na primeira abertura, o programa mostra a tela de Ativação com o código de instalação desta máquina (um identificador gerado localmente). O fluxo é:

1. Clique em Copiar código e informe esse código na hora da compra (ou ao suporte).
2. Você recebe por e-mail uma chave de ativação exclusiva deste computador.
3. Cole a chave no campo Chave de ativação e clique em Ativar. Pronto — nas próximas aberturas o programa entra direto.

A chave é emitida travada àquela máquina — por isso o código de instalação é pedido antes. Para usar em outro computador, é necessária outra chave (veja a seção de proteções, que explica como migrar corretamente de máquina usando o Backup).

4. Etapa 3 — Provedores de IA

Abra Provedores de IA no menu lateral. É aqui que você conecta a sua conta de IA — sem isso, nenhum agente consegue trabalhar.

4.1 Conectando um provedor (passo a passo)

1. Provedor: escolha a IA a configurar (Claude, OpenAI ou Gemini). Você pode configurar mais de um; cada agente escolhe o seu na tela Agentes.
2. API key: cole a chave secreta da sua conta no provedor. Ela é guardada cifrada no seu computador (DPAPI do Windows) e nunca sai dele a não ser para falar com o próprio provedor. Ao salvar de novo no futuro, deixar o campo em branco mantém a chave já gravada.
3. Use o link "comprar tokens" da tela para abrir a página do provedor onde você adiciona créditos.
4. Testar conexão: valida a chave e busca a lista de modelos disponíveis na sua conta.
5. Modelo: por padrão o programa já seleciona o modelo mais avançado do provedor (melhor qualidade — porém mais caro por token). Troque se quiser equilibrar custo: por exemplo, no Claude o Sonnet custa menos que o Opus e resolve bem documentos rotineiros.
6. Provedor habilitado: deixe ligado. Desligado, o provedor não é usado pelos agentes, mesmo configurado — útil para suspender temporariamente um provedor sem apagar nada.
7. Clique em Salvar.

4.2 Parâmetros do modelo — o que são e o que recomendamos

Depois de testar a conexão e escolher o modelo, aparecem os parâmetros — ajustes finos de como a IA trabalha. A tela é adaptativa: só mostra os parâmetros que aquele modelo realmente aceita.

5. Etapa 4 — Criando o seu primeiro agente

Na tela Agentes, clique em Criar agente. Cada opção do editor muda um aspecto de como o agente atua:

5.1 Identidade

5.2 Quando rodar

Há dois gatilhos independentes — ligue um, os dois, ou nenhum (aí o agente só roda quando você manda, pelo botão ▶ da lista):

5.3 Pastas deste agente

5.4 Inteligência e qualidade

6. Etapa 5 — A rotina de trabalho do agente

6.1 O fluxo normal: uma subpasta → um documento

Com provedor configurado e agente criado, o ciclo de cada trabalho é:

1. Você (ou sua equipe) coloca os insumos numa subpasta nova do Rascunho — fotos, anotações, planilhas, o que houver. O nome da subpasta também é usado como dado (ex.: o código da obra).
2. No gatilho (horário, monitoramento ou "Iniciar agora"), o agente identifica qual modelo do catálogo corresponde àqueles insumos.
3. Ele preenche o modelo com os dados novos — preservando a formatação, as tabelas e as posições das fotos do original, expandindo ou encolhendo as partes repetitivas (mais fotos, mais linhas) conforme o caso. O que não tem dado fica com um marcador visível (____) e uma observação ao final — o agente nunca inventa.
4. O Agente Revisor (se ligado) confere e, se preciso, manda refazer com a lista de correções.
5. O documento aprovado é gravado na Entrega e a subpasta vai para Processados. Tudo fica rastreado nos Registros.

6.2 Mala-direta: um arquivo de texto → vários documentos de uma vez

Há trabalhos em que o mesmo modelo precisa ser emitido para várias pessoas — certificados de conclusão de curso, atestados, declarações, convocações. Para isso você não precisa criar uma subpasta por pessoa: basta um único arquivo de texto com a lista.

Como montar o arquivo (pode ser um .txt simples, solto direto na pasta de Rascunho):

• Primeira linha — a instrução: diga o que fazer, com a expressão "um para cada" (é ela que diferencia a mala-direta de um documento único). Ex.: "Emitir um certificado de conclusão do curso NR-35 para cada pessoa abaixo".
• Linhas seguintes — a lista: uma pessoa por linha, com os dados que o modelo pede (nome, CPF, e o que mais o certificado usar). Não precisa de formato rígido — o agente entende a lista como ela vier.

Emitir um certificado de conclusão do curso NR-35 (Trabalho em Altura,
8 horas) para cada pessoa abaixo. Data de conclusão: 15/06/2026.

Maria Helena Castro — CPF 123.456.789-00
João Pedro Almeida — CPF 987.654.321-00
Carlos Eduardo Souza — CPF 456.789.123-00

O que acontece em seguida:

1. O agente confere se o arquivo corresponde a algum modelo da pasta de Modelos (ex.: o seu modelo de certificado). Se não corresponder a nenhum, o arquivo é ignorado — nada é gerado por engano.
2. Com a instrução clara ("um para cada"), ele gera um documento por pessoa: cada arquivo sai na Entrega nomeado pela pessoa (ex.: Certificado — Maria Helena Castro.docx), com os dados dela preenchidos no lugar certo do modelo.
3. Os dados comuns a todos (curso, carga horária, data) são preenchidos uma vez e valem para o lote inteiro; só os dados de cada pessoa variam entre os arquivos.
4. Ao concluir, o arquivo da lista vai para Processados — e cada documento fica registrado nos Registros com a pessoa correspondente (rastreabilidade individual).

Quando o programa pergunta antes de gerar — para nunca emitir errado, em três situações aparece um aviso com botões (na tela do computador ou, se você usa o acesso remoto, também no celular):

• Instrução ambígua: se a primeira linha não deixa claro se é "um para cada" ou um documento único com várias partes (um contrato entre cinco sócios, por exemplo, é UM documento — não cinco). O programa pergunta qual é o caso.
• Volume alto: acima de 50 pessoas, ele pede confirmação antes de gerar o lote (proteção contra listas coladas por engano).
• Conflito: se a instrução pede "um para cada" mas o modelo é claramente de documento único (ou vice-versa).

Enquanto a pergunta não é respondida, o arquivo fica intacto no Rascunho — nada é gerado pela metade. E se a geração for interrompida no meio (queda de energia, por exemplo), a próxima execução retoma de onde parou, sem duplicar os documentos já emitidos.

7. As telas, uma a uma

7.1 Painel

• Cartões de status — Em andamento, Concluídos e Falhos: a contagem dos trabalhos.
• Estatísticas de uso — Tokens consumidos (o que foi gasto de fato), Tokens economizados (estimado) (o que o reaproveitamento de catálogo e memórias evitou de gastar), detalhamento por fornecedor de IA e as médias por agente e por trabalho — a sua base para acompanhar o custo.
• Em execução — os trabalhos rodando agora, com a etapa atual e a barra de progresso.
• Acesso remoto (quando ativo) — status do servidor e os celulares pareados, com presença online/offline e botão Revogar.
• Declaração de isenção de responsabilidade — reabre o aviso sobre as limitações da IA: o documento gerado é um apoio técnico e deve ser revisado por um profissional responsável antes do uso.

7.2 Agentes (lista)

Cada linha mostra o estado (Ativo/Inativo), o nome, a especialidade e a periodicidade. Os botões, da esquerda para a direita:

• ▶ Iniciar agora — gera os documentos pendentes na hora, sem esperar o horário.
• ✎ Editar — abre o editor do agente.
• ⭯ Ativar/Desativar — liga/desliga o disparo agendado sem mexer no resto.
• ↺ Reiniciar aprendizado — apaga as memórias aprendidas deste agente (catálogo, personalidade, lições do revisor). Ele reaprende do zero na próxima execução. Use se o agente "aprendeu errado" ou se os modelos mudaram radicalmente.
• 🗑 Remover — exclui o agente (as pastas e os documentos no disco não são tocados).

7.3 Registros

O diário completo do sistema: cada execução, cada chamada de IA, cada aviso e erro. Recursos:

• Busca por mensagem, provedor, modelo ou ação; filtros por tipo (informação/aviso/erro) e por período.
• Cada entrada mostra a hora, o nível, a origem, a mensagem e as métricas (tokens e latência das chamadas de IA) — e um expansor Detalhes com o conteúdo técnico quando houver.
• Procure pela ação rastreabilidade para ver, trabalho a trabalho, qual subpasta + qual modelo viraram qual arquivo na Entrega.

7.4 Serviço

O orquestrador roda como Serviço do Windows e gera os documentos agendados mesmo com o aplicativo fechado. Ele é instalado junto com o programa; aqui você só o inicia ou para (o Windows pede confirmação de administrador). Se documentos agendados não estão saindo, esta é a primeira tela a conferir.

7.5 Backup

• Criar um backup — gera um arquivo cifrado por senha com tudo o que é configuração: agentes, provedores e, se você marcar, as chaves de API e as memórias dos agentes. Escolha onde salvar, defina a senha e a retenção (manter os últimos N backups).
• Restaurar um backup — escolha o arquivo e digite a senha dele. Os dados atuais são substituídos.

7.6 Acesso remoto

Acompanhe e dispare agentes pelo aplicativo de celular O Estagiário – Despachante, de qualquer lugar:

• Ativar acesso remoto — o interruptor geral da máquina (além dele, cada agente tem o próprio "Permitir acesso remoto").
• Parear novo dispositivo — gera um QR code; escaneie com o app do celular para parear.
• Dispositivos pareados — lista com presença online/offline, Renomear e Revogar (corta o acesso daquele aparelho imediatamente).

A comunicação é criptografada de ponta a ponta: o conteúdo nunca passa em claro pela nuvem — o servidor intermediário só transporta envelopes cifrados que apenas o seu computador e o seu celular sabem abrir.

7.7 Ajustes

• Senha das telas de configuração — Provedores, Ajustes, Backup e Serviço são protegidos por senha (pedida uma vez por sessão), para que só o responsável mexa em chaves e configurações. Enquanto você não define a sua, vale a senha padrão, que muda todo dia: 4 dígitos no formato DDMM, somando 10 ao dia e 10 ao mês de hoje. Exemplos: 05/06 → 1516; 28/11 → 3821. Ao definir aqui a sua própria senha, a padrão deixa de valer — passa a funcionar só a sua.
• Atualizar o catálogo automaticamente — quando ligado, qualquer mudança na pasta de Modelos recataloga sozinha (consome tokens a cada mudança). Desligado, você atualiza manualmente pelo editor do agente. Recomendação: desligado se a pasta de Modelos muda com frequência; ligado se muda raramente.

8. As proteções do sistema (segurança e anti-cópia)

8.1 Os seus dados, no seu computador

• Banco de dados cifrado (SQLCipher) — agentes, memórias, registros e configurações ficam num banco local integralmente criptografado. Mesmo que alguém copie o arquivo do banco, não consegue ler nada sem a chave.
• Segredos protegidos pela máquina (DPAPI) — a chave do banco e as chaves de API são cifradas pela proteção de dados do próprio Windows, amarrada a este computador. Um arquivo de chave copiado para outra máquina é ilegível lá.
• Nada de nuvem nossa — o conteúdo dos documentos só sai do seu computador para o provedor de IA que você escolheu, pela sua própria conta. Detalhes na Política de Privacidade.

8.2 Anti-cópia: como a licença protege o seu investimento

A licença é por computador, e a proteção é criptográfica — não um simples "número de série":

1. Na compra, você informa o código de instalação que o programa exibe. A chave de ativação é assinada digitalmente para aquele código — ela não funciona em nenhuma outra máquina.
2. Ao ativar, o programa grava um registro cifrado contendo a impressão digital do computador (uma combinação de componentes de hardware/sistema).
3. Em toda abertura, o programa confere essa impressão digital. A verificação é tolerante a trocas parciais — trocar um componente (ex.: um disco) não derruba a ativação; a máquina precisa continuar reconhecível no conjunto.
4. Se a instalação inteira for copiada para outro computador (disco clonado, pasta copiada, imagem de máquina), a proteção do Windows não decifra os segredos e a impressão digital não confere: o programa trava na tela de ativação e zera os dados locais daquela cópia. Os documentos já gerados nas suas pastas de Entrega não são afetados — eles são arquivos seus, normais.

8.3 Proteções do dia a dia

• Senha das telas de configuração — impede que qualquer pessoa com acesso ao computador altere chaves de API, agentes ou backups.
• Backup cifrado por senha — o arquivo de backup é ilegível sem a senha definida por você (guarde-a: não há como recuperar um backup com a senha perdida).
• Acesso remoto com criptografia ponta-a-ponta e revogação — cada celular é pareado individualmente por QR code e pode ser revogado a qualquer momento.
• Anti-injeção de instruções — os textos dos seus rascunhos e modelos são tratados pela IA como dados, nunca como comandos: um texto malicioso embutido num documento não consegue alterar o comportamento do agente.

9. Dúvidas e suporte

Não encontrou o que precisava? Escreva para contato@oestagiario.ia.br — respondemos no menor prazo possível. Ao relatar um problema, anexar as entradas relevantes da tela Registros acelera muito o diagnóstico.