# Como funciona a Iterabase > Visão técnica dos colaboradores de IA da Iterabase. Versão web: https://docs.iterabase.com/pt/ > Site: https://www.iterabase.com/pt/ · Marcar chamada de 30 minutos: https://cal.com/nunocgoncalves/30min · hello@iterabase.com > Preços: alojado desde 790 €/mês (UE) ou 990 $/mês (EUA), faturação anual; ou uma licença única para correr nos seus servidores, definida na chamada. O primeiro colaborador de IA é construído e posto a trabalhar durante uma semana, grátis. ## O que é A Iterabase dá a uma equipa de operações um conjunto de colaboradores de IA que fazem trabalho real nos sistemas reais da empresa (email, documentos, portais web, pastas partilhadas e bases de dados), enquanto as pessoas confirmam cada ação com consequências. Cada cliente tem o seu próprio ambiente dedicado, com modelos alojados na UE, retenção zero de dados e um registo completo de auditoria. A Iterabase constrói consigo os primeiros processos; depois, os seus administradores podem criar novos colaboradores pedindo à Sofia. Um colaborador lê o email que chega, desmonta os documentos, consulta portais e sistemas internos, prepara o resultado e pede a uma pessoa que confirme antes de qualquer coisa sair. A Sofia, o seu braço direito, está ao lado da equipa na aplicação e no Microsoft Teams. Dois processos de referência mostram o que isto significa na prática: - **Do comprovativo de entrega à fatura.** Um comprovativo de entrega recebido por email é associado a uma fatura na pasta partilhada do cliente, verificado com dados do ERP em modo de leitura e carregado no portal do transportador. - **Do pedido de cotação à cotação enviada.** Um pedido por email com PDFs digitalizados gera pedidos de preço a APIs de transportadores, portais web e fornecedores por email; as respostas são reunidas, as regras de margem aplicadas, uma pessoa aprova e a cotação é enviada. ## Visão geral *Diagrama: Os colaboradores trabalham no seu ambiente; as pessoas confirmam o que sai.* O trabalho chega - Email - App e Sofia - Microsoft Teams ↓ O seu ambiente dedicado - **Motor de processos**: espera respostas, pausa, retoma segura - **Entrada de documentos**: antivírus, OCR, leitura visual - **Browsers geridos**: login automático, login assistido - **As pessoas confirmam**: cada envio e submissão ↓ Os colaboradores atuam em - **Portais web**: submissões guiadas - **Email de saída**: confirmado ou autorizado - **Runner na sua rede**: só ligações de saída; ficheiros, SQL só leitura - **Modelos de IA**: alojados na UE, retenção zero, acesso por mTLS _Tudo corre num ambiente dedicado a si; só saem ações confirmadas e pedidos aos modelos, que nunca são guardados._ ## Colaboradores e processos | Capacidade | Como funciona | |---|---| | Configurado para si | Cada cliente tem a sua configuração: processos, ferramentas, Skills, credenciais, identidades dos colaboradores, caixas de correio e referências de valor. As ferramentas de integração comuns vêm versionadas em cada versão da plataforma. | | Esperar respostas | Um processo pode enviar vários pedidos (por exemplo, três pedidos de preço a fornecedores) e esperar por todas ou por uma das respostas até um prazo, continuando depois a mesma execução. Nada fica ocupado enquanto espera. | | Passos em paralelo | Ramos independentes correm lado a lado e juntam-se quando todos terminam; se um ramo obrigatório falhar, a execução para logo. | | Estado verdadeiro | O trabalho aparece como A trabalhar, A aguardar, Em pausa, Precisa de si, Falhou ou Concluído. As pausas (fim do período de teste, falha do fornecedor do modelo, runner desligado) retomam sozinhas. | | Recuperação segura | Um passo interrompido só é repetido se não tiver escrito nada; caso contrário, a tarefa para até uma pessoa a reiniciar. O reinício retoma a partir de pontos de controlo declarados. | | Verificação final | Pós-condições opcionais verificam o resultado de um passo com a sua evidência antes de o dar como concluído. | *Diagrama: Cada tarefa mostra o seu estado real, e nada é repetido em silêncio.* - **Nova tarefa**: email, chat, API ↓ - **A trabalhar**: um colaborador trata ↓ - **Concluído**: cópias exatas Volta a A trabalhar sozinha, ou quando alguém age - **A aguardar**: respostas ou um prazo; sem recursos ocupados - **Precisa de si**: confirmar, responder, entrar ou libertar um email retido - **Em pausa**: teste terminado, falha do modelo ou runner desligado; retoma sozinha Para até uma pessoa decidir - **Falhou**: inclui resultado incerto; Reiniciar cria uma nova tentativa, confirmada _A aguardar, Em pausa e Precisa de si voltam todos a A trabalhar; só Falhou exige um reinício deliberado, por isso um passo que já escreveu nos seus sistemas nunca é repetido por engano._ ## As pessoas decidem - **Confirmar antes de agir.** Cada envio ou submissão é confirmado por uma pessoa sobre o conteúdo exato, ou pré-aprovado apenas para uma lista declarada de destinatários. Tudo o resto volta à confirmação. - **Precisa de si.** Uma só lista, de todo o trabalho, com o que espera por uma pessoa: confirmações, perguntas, logins em portais e emails retidos. Cada entrada abre a sua tarefa. - **Sem repetições silenciosas.** Um envio com resultado incerto fica marcado como "resultado incerto" e nunca é reenviado automaticamente. - **Atribuição completa.** Cada ação regista quem a iniciou, que colaborador agiu e por que canal (browser, API, Chat, Teams). ![A sua vez: uma decisão de cada vez, com o email exato que vai ser enviado](https://www.iterabase.com/assets/screens/pt/decide.webp) _A sua vez: quem preparou, como o preço foi calculado, o que foi verificado e o email exato. Aprove, edite primeiro ou recuse._ ## Email (Microsoft 365 e Google Workspace) - **Receção** por webhooks do fornecedor e recuperação incremental, para que nenhuma mensagem se perca depois de uma paragem; consulta periódica só onde não há endpoint público. - **Encaminhamento**: as respostas são primeiro associadas ao seu trabalho (pela conversa, depois por um código no assunto, com verificação do domínio do remetente); o email novo segue a regra de início do processo; duplicados dão uma só tarefa. - **Respostas ambíguas ou de outro domínio** ficam retidas para uma pessoa. Respostas tardias ficam como evidência. - **Nunca responde automaticamente.** O email de saída só passa por passos de envio confirmados ou pré-aprovados. *Diagrama: Um passo pede a três fornecedores; cada resposta volta à mesma execução.* - **Passo de envio**: 3 pedidos enviados, um código em cada assunto ↓ - Fornecedor A - Fornecedor B - Fornecedor C ↓ respostas - **Associar respostas**: 1. mesma conversa; 2. código no assunto; 3. domínio do remetente ↓ - **A execução continua**: todas ou uma resposta, ou o prazo - **Retida para revisão**: ambígua ou de outro domínio _Uma resposta que não pode ser associada com confiança espera por uma pessoa em vez de ser adivinhada; respostas depois do prazo ficam apenas como evidência._ ## Documentos - **Um só caminho de quarentena** para cada ficheiro, seja qual for a origem: carregamento, email, runner ou ferramenta. - **Análise antivírus** (ClamAV) e depois **extração de texto e OCR** (Apache Tika, Tesseract) como leitura de referência de cada documento. - **Emails anexados** (.eml, .msg) são abertos; o corpo é convertido em texto limpo. - **Manuscritos e carimbos**: os colaboradores podem ler imagens das páginas com um modelo de visão quando o OCR não chega. *Diagrama: Cada ficheiro segue o mesmo caminho antes de um colaborador o ler.* - Ficheiros - Email - Runner - Ferramentas ↓ - **Quarentena**: todas as origens, uma só entrada ↓ - **Antivírus**: ClamAV, antes de ser aberto ↓ - **Extração**: Apache Tika e Tesseract OCR ↓ - **Colaborador**: lê o texto e trabalha ↓ quando o OCR não chega - **Modelo de visão**: imagens da página: manuscritos, carimbos _O texto extraído é a leitura de referência; o modelo de visão é raciocínio adicional, nunca um substituto._ ## Portais web - **Browsers geridos** deixam os colaboradores navegar e ler portais livremente; o próprio browser bloqueia submissões e carregamentos fora das páginas de login. - **Ações com consequências** só correm por ferramentas guiadas de cada portal, com as mesmas regras de confirmação ou pré-aprovação do email. - **Logins automáticos** com credenciais guardadas e TOTP; as sessões são reutilizadas por conta. - **Login assistido**: quando um portal pede um código por SMS ou semelhante, um operador autorizado conclui-o numa vista ao vivo do browser dentro da aplicação. Nada do que escreve é gravado, e entrar na conta errada é recusado. ## Dentro da sua rede - **Runner**: um serviço Windows assinado (também para Linux) que só faz ligações de saída, com TLS mútuo. É registado em Definições, Runners; parar o serviço corta tudo. - **Pastas partilhadas**: leitura só dentro das pastas declaradas. - **Bases de dados e ERP**: consultas SQL declaradas, parametrizadas e só de leitura; nunca SQL livre. - **As credenciais** ficam na plataforma e são enviadas a cada pedido, nunca guardadas no runner. - **Portais só internos**: o mesmo browser gerido pode correr no runner, mantendo as sessões dentro da rede. *Diagrama: O runner liga para fora; nada na sua rede aceita ligações.* A sua rede - **Runner**: serviço Windows ou Linux assinado; pará-lo corta o acesso - **Pastas**: pastas declaradas - **Base de dados**: consultas de leitura - **Portais internos**: browser no runner ↓ pela sua firewall: só saída, TLS mútuo O seu ambiente Iterabase - **Motor de processos**: guarda as credenciais e envia-as a cada pedido; só consultas declaradas Nenhuma porta aberta para a sua rede. Se o runner desligar, o trabalho pausa e retoma quando voltar. _A sua equipa de TI não abre portas: o runner faz a única ligação, para fora, e só corre o que foi declarado para ele._ ## Aplicações de desktop (Em breve) Alguns sistemas, como o PHC ou o SAP GUI, não têm uma API prática. O runner trabalha com eles como uma pessoa faria, numa máquina reservada para isso. *Diagrama: O colaborador observa o ecrã; só ações guiadas alteram dados.* Máquina dedicada à automação, na sua rede - **PHC, SAP GUI**: ou outra aplicação Windows - **Runner**: capturas de ecrã e árvore de interface ↓ observa - **Colaborador**: lê o ecrã com o modelo de visão e decide ↓ decide agir - **Ação guiada**: escrita declarada, confirmada ou pré-aprovada, executada pelo runner VM ou sessão remota, nunca o PC de um colaborador. Indicador no ecrã, registo local de auditoria, sem direitos de administrador. _Aplicações de desktop através do runner_ - **Só máquinas dedicadas.** A automação corre numa VM com início de sessão automático ou numa sessão remota na sua rede, nunca no PC de um colaborador. - **Uma capacidade do runner, não um segundo agente.** O raciocínio fica no seu ambiente Iterabase. O colaborador observa através de capturas de ecrã e da árvore de interface da aplicação, lidas com o modelo de visão. - **As interfaces da própria aplicação, quando existem:** Windows UI Automation, SAP GUI Scripting e COM. - **O mesmo modelo de segurança dos browsers.** Ler e navegar é livre. Escritas, como lançar um documento ou gravar um registo, só passam por ações guiadas de cada aplicação, declaradas como escritas e confirmadas ou pré-aprovadas. - **Visível e fácil de parar.** Um indicador no ecrã mostra quando a automação tem o controlo, cada ação fica num registo local de auditoria, e parar o serviço do runner corta tudo. - **Privilégio mínimo.** A conta do runner não tem direitos de administrador do domínio nem direitos locais amplos, corre uma sessão por máquina, e os segredos nunca chegam ao modelo nem à evidência. ## Sofia, o seu braço direito - Uma conversa privada e contínua por pessoa, com uma persona a que o administrador dá nome. - Consulta com as permissões da própria pessoa, nunca mais do que isso. - Memória visível: a pessoa vê o que a Sofia guarda e pode editar ou apagar. - Inicia processos (com confirmação) e tarefas pontuais, acompanhadas como qualquer outro trabalho. Delega pesquisa a colaboradores auxiliares só de leitura. - Até 6 anexos por mensagem, mais referências a tarefas, processos e documentos. ## Criar colaboradores pedindo à Sofia (Em breve) Os administradores podem descrever um novo trabalho à Sofia e receber um colaborador pronto, feito com as mesmas peças que a equipa da Iterabase usa. *Diagrama: A Sofia prepara o processo; nada corre sem a sua aprovação.* - **Descreve**: o trabalho por palavras, com alguns exemplos ↓ - **A Sofia prepara**: um processo legível ↓ - **Revê**: passos, regras, o que envia, quando pergunta ↓ - **Aprovado**: nova versão, fica registada; altere quando quiser, a pedir Feito com as mesmas peças de qualquer colaborador - Gatilhos - Passos - Ferramentas - Skills - Credenciais - Confirmações _Criar um colaborador com a Sofia_ - **Explique como a alguém novo na equipa.** Descreva o trabalho por palavras simples, com alguns exemplos reais. A Sofia pergunta o que precisa de saber. - **Um processo legível.** A Sofia prepara o gatilho (caixa de correio, chat ou API), os passos, ramos em paralelo, esperas por respostas e prazos, e os pontos de controlo de onde um reinício retoma. - **Ferramentas da biblioteca.** Os passos usam as ferramentas de integração da versão e as ligações já configuradas: email, documentos, portais, o runner. Um trabalho que precise de uma ligação que ainda não existe é assinalado, nunca improvisado. - **As suas regras como Skills.** Margens, tom, limites e exceções tornam-se instruções escritas que o colaborador segue, visíveis na proposta. - **As credenciais só se escrevem.** A proposta declara as credenciais de que precisa; um administrador preenche-as em Definições. A Sofia nunca vê os valores. - **Consequências declaradas à partida.** Cada envio ou submissão é marcado como escrita e, por omissão, exige confirmação, ou é pré-aprovado só para os destinatários que indicar. - **Aprova, e só depois corre.** Nada corre até um administrador aprovar a proposta. Cada alteração é uma nova versão que revê, e a anterior fica guardada. ## Microsoft Teams - Cada colaborador e a Sofia são aplicações próprias do Teams, geradas para o cliente e instaladas pelo seu administrador do Teams. - Os utilizadores são ligados automaticamente pelo início de sessão único do Microsoft Entra. - Os colaboradores avisam e recebem respostas; os cartões de confirmação mostram o conteúdo exato que está a ser aprovado. - Uma mensagem direta à Sofia é a mesma conversa que na aplicação. ![A Sofia no Microsoft Teams, com um cartão de confirmação de cotação](https://www.iterabase.com/assets/screens/pt/teams.webp) _A Sofia no Teams: o resumo da noite e um cartão de confirmação com o email exato, aprovado na conversa._ ## A aplicação - **Hoje**, **Trabalho**, **Equipa**, **Sofia** e **Relatórios**, em inglês e português europeu, utilizável no telemóvel. - **Tempo devolvido**: as horas poupadas são estimadas a partir das execuções bem-sucedidas × uma referência por processo, visíveis para todos; a vista detalhada de valor é só para administradores. - **Plano e utilização**: os administradores veem o plano, os processos ativos e a utilização. ![Hoje: o resumo da manhã, o que precisa de si e o que ficou feito](https://www.iterabase.com/assets/screens/pt/today.webp) _Hoje: um resumo curto, as decisões à espera e as horas devolvidas até agora._ ![Trabalho: cada tarefa agrupada em A trabalhar, A aguardar, Precisa de si e Concluído](https://www.iterabase.com/assets/screens/pt/work.webp) _Trabalho: cada tarefa pelo seu estado. Uma pausa diz porquê e retoma sozinha; uma falha diz claramente que nada foi enviado._ ## APIs - **API de trabalho** com chaves pessoais e de automação, com conjuntos fixos de permissões. - **API de inferência compatível com OpenAI** para os sistemas do próprio cliente, com filtro de modelos e utilização medida. ## Confiança, segurança e dados Os seus dados ficam num ambiente que serve só a sua empresa, e só saem para pedidos aos modelos que nunca são guardados. | Área | O que fazemos | |---|---| | Isolamento | Um ambiente dedicado por cliente. Sem bases de dados nem processos partilhados. | | Modelos de IA | Modelos alojados na UE com retenção zero de dados, por escrito; não guardam nada e nada é treinado com os seus dados. Com visão. As chaves dos fornecedores ficam centralizadas; o seu ambiente liga-se com a sua própria identidade TLS mútua. Chaves próprias e modelos locais ficam dentro do seu ambiente. | | Acesso | Email e palavra-passe, ou início de sessão único com Microsoft Entra ID ou Google. Quem entra por SSO continua a precisar de um pedido de acesso aprovado; os administradores mantêm uma palavra-passe de emergência. | | Funções | Administrador e Operador. A Sofia e cada colaborador consultam com a autoridade que lhes foi dada, nunca mais. | | Segredos de integração | Introduzidos pelos administradores em campos declarados, guardados só para escrita e nunca mostrados, devolvidos ou registados. | | Acesso de suporte | SSH através do AWS Systems Manager: sem portas abertas, e cada sessão é gravada. | | Registos de utilização | Medidos e exportáveis sem qualquer conteúdo de mensagens ou documentos. | | Cópias de segurança | Envio contínuo dos registos da base de dados, cópias diárias e espelho contínuo dos documentos; reposição a qualquer momento dos últimos 30 dias. As credenciais estão incluídas, cifradas com uma chave de recuperação (AWS KMS no alojado; guardada por si na instalação própria). Depois de uma reposição, o trabalho que já tinha escrito fica retido para revisão. | | Saída | A remoção apaga todo o ambiente e prova-o com uma verificação de recursos. A mesma ferramenta de recuperação migra um ambiente alojado para instalação própria. | ## Instalação e compra A maioria dos clientes começa no alojado; a mesma versão pode correr no seu próprio hardware. | | Alojado | Instalação própria | |---|---|---| | Onde corre | Um ambiente AWS dedicado, gerido por nós, com HTTPS público | Um servidor do cliente (x86) | | Cópias de segurança | No nosso S3, cifradas com AWS KMS | No seu armazenamento compatível com S3, com a sua chave | | Condições | Desde 790 €/mêsDesde 990 $/mês, faturação anual | Licença única, definida na chamada | *Diagrama: Duas semanas da primeira chamada à decisão.* - **Dia 0: chamada**: 30 minutos, escolher o trabalho ↓ - **Dias 1 a 7: construímos, grátis**: Dá-nos acesso, exemplos reais e uma pessoa para validar ↓ - **Dia 7: começa a trabalhar**: no seu próprio ambiente ↓ - **Dias 8 a 14: uma semana de trabalho real**: Veja o que fez, o que perguntou e as horas que devolveu ↓ - **Dia 14: decide**: mantém alojado, instala em casa, ou para sem custos _As duas primeiras semanas_ **Como começar.** Construímos o seu primeiro processo gratuitamente e pomo-lo a trabalhar num ambiente dedicado em menos de uma semana; depois, corre sobre o seu trabalho real durante sete dias. Se continuar, o trabalho em pausa retoma onde parou. Se parar, nada de novo começa, não paga nada e apagamos os seus dados. Os planos crescem com a sua equipa. Dimensionamos o seu na chamada.