Saltar para o conteúdo

Implementação interna

Auditoria da implementação de AI feita pela sua equipa

Alguém na empresa criou um agente no Claude Code, n8n ou Make. Funciona enquanto funciona. Verificamos o que acontece quando deixa de funcionar e o que deve ser mantido ou reformulado.

  • Passos: 4
  • Tempo de leitura: 5 min
  • Perguntas: 4

Não recomendamos que deite fora o que já têm. Uma implementação feita internamente é um bom ponto de partida: a empresa já sabe o que pretende e tem um protótipo funcional. A avaliação responde às perguntas que ninguém colocou durante a construção, porque não eram necessárias nessa fase.

Dos 344 incidentes de IA em empresas verificados entre 2023 e 2026, em 188 o próprio sistema causou danos, sem qualquer atacante. O padrão repete-se: durante a fase de desenvolvimento, foi concedido ao agente acesso de escrita à base de dados e ninguém lho retirou durante a operação.

Em julho de 2026, um agente de programação ligado à base de dados de produção executou uma migração em produção ao fim de dez minutos. Noutro caso documentado, a eliminação da base de dados e das cópias de segurança demorou nove segundos.

O que corre mal nas implementações autónomas

As permissões da fase de construção mantêm-se na fase de operação

O agente tem acesso total de escrita à base de dados, à caixa de correio ou ao CRM, porque era mais prático durante os testes. Retirar esse acesso e introduzir a aprovação humana é, geralmente, a primeira correção.

Uma cópia de segurança que ninguém restaurou

Existe uma cópia nas definições. Ninguém verificou se é possível restaurá-la nem quanto tempo demora.

Chaves de API no código, numa folha de cálculo ou no chat

A chave do modelo e do sistema de contabilidade num único ficheiro, visível para todos os que têm acesso ao repositório.

Sem logótipo

Ninguém sabe dizer o que o sistema enviou na terça-feira passada nem a quem. Sem essa informação, não é possível tratar uma reclamação ou queixa.

«Funciona» significa «funcionou em três exemplos»

Sem um conjunto de testes, cada alteração do prompt ou da versão do modelo é testada em direto, com os clientes.

Chatbot sem indicação de que é IA

A partir de 2 de agosto de 2026, obrigação prevista no artigo 50.º do AI Act. Aplica-se a bots no site, voicebots e assistentes na caixa de entrada, quando respondem aos clientes.

Fornecedor de modelo fora do registo de tratamento

Os dados dos clientes são enviados para uma API externa, mas o registo das atividades de tratamento e os contratos de subcontratação não fazem qualquer referência a isso.

Close-up of brass gears, one tooth cracked, a fine golden fissure
Seguinte, passo 02 Como funciona a análise

Como funciona a análise

  1. Dia 1: reunião e acesso à configuração Quem o construiu, o que deve fazer, onde está alojado e que chaves utiliza. Acesso à configuração, não aos dados dos clientes.
  2. Dias 2–3: revisão segundo uma lista de doze pontos A mesma lista que publicamos abaixo. Cada ponto recebe uma de três avaliações: manter, corrigir, reformular.
  3. Dia 4: relatório com o custo de cada item O que fica, o que melhoramos, o que será reformulado e quanto custa cada item. O relatório é vosso, independentemente de quem faça as correções.
  4. Dias 5–10: ajustes (opcional) Normalmente, definem-se permissões, segredos, cópias de segurança, registos e um conjunto de testes. A documentação é criada de raiz, porque não existe em implementações autónomas.
Uma grande lupa sobre um plano de pequena automatização desenhado com linhas douradas, com vários pontos fracos assinalados a laranja
Seguinte, passo 03 Lista de verificação que podem preencher por conta própria

Lista de verificação que podem preencher por conta própria

Doze perguntas. Se a resposta a mais de três for «não sei», é necessária uma análise. Se a resposta a todas for «sim», não é necessária e não faz sentido pagar por ela.

  1. O agente tem uma conta própria com permissões mínimas? Não a conta do funcionário que o configurou.
  2. O registo em produção requer aprovação humana? Envio de um e-mail, emissão de uma fatura, alteração no CRM, eliminação de qualquer coisa.
  3. Alguém restaurou uma cópia de segurança no último mês? Reproduziu, não «ligou».
  4. Onde ficam as chaves da API e quem tem acesso a elas? Se a resposta começar por «no ficheiro», então é a resposta.
  5. Todas as ações do sistema são registadas no log? Com a data e o conteúdo, para ser possível responder a uma reclamação da semana passada.
  6. Quem executa o conjunto de testes após cada alteração? Pelo menos trinta casos, incluindo casos difíceis.
  7. O que acontece quando o fornecedor altera a versão do modelo? As versões são descontinuadas de poucos em poucos meses. Quem sabe disso e quem verifica o resultado após a alteração?
  8. O interlocutor sabe que está a falar com IA? Cliente ou trabalhador. Art. 50.º do AI Act, a partir de 2 de agosto de 2026.
  9. O fornecedor do modelo consta do registo de atividades? Em conjunto com o contrato de subcontratação. Aplica-se a todas as API externas para as quais são enviados dados pessoais.
  10. Quem intervém quando algo falha às sete da manhã? Nome e apelido da pessoa responsável pelo sistema, não do «departamento de TI».
  11. As pessoas que utilizam a ferramenta concluíram uma formação documentada? Art. 4.º do AI Act: plano, lista de participantes, materiais.
  12. Quanto custa o sistema por mês e quem vê a fatura? Os aumentos inesperados na fatura da API são a surpresa mais comum após o terceiro mês.
Tapete com doze campos, quatro assinalados com um visto dourado, ao lado uma chave e um cadeado
Seguinte, passo 04 O que costuma ficar e o que é refeito

O que costuma ficar e o que é refeito

FicaMelhoramosCriado de raiz
Lógica do processo e seleção da ferramentaPermissões e contas separadasPolítica de utilização de IA
Prompts e configuração, após os testesEspaço para chaves e segredosRegisto de sistemas de IA na empresa
Integrações que funcionamCópias de segurança com teste de restauroKit de teste
A pessoa que o desenvolveu, como responsável pelo processoRegistos de atividadeTextos de divulgação nos termos do artigo 50.º
Três caixas na passadeira: uma selada com uma fita dourada, uma aberta com ferramentas e uma desmontada em peças
São todos os passos Perguntas frequentes e passos seguintes

Perguntas e respostas

Perguntas frequentes

Criámos um agente no Claude Code e funciona. Para que precisamos de uma revisão?

Para verificar o que acontece se deixar de funcionar ou fizer algo que ninguém pretendia. A revisão avalia permissões, cópias de segurança, chaves, registos, conjunto de testes e documentação, não o protótipo. Se responderem «sim» às doze perguntas da lista, a revisão não é necessária.

Uma revisão implica reconstruir tudo de raiz?

Não. A lógica do processo, os prompts e as integrações funcionais costumam manter-se. É necessário rever as permissões, os segredos, as cópias de segurança e os registos. A documentação é criada de raiz, porque normalmente não existe nas implementações autónomas.

Quanto tempo demora a análise e quanto custa?

Quatro dias úteis até ao relatório: uma conversa, dois dias de análise com base numa lista de doze pontos e um dia para preparar o relatório com o custo de cada correção. Orçamento após a primeira conversa, dependendo do número de sistemas. O relatório é seu, independentemente de quem fizer as correções.

Temos de vos dar acesso aos dados dos clientes?

Não. A revisão exige acesso à configuração, às permissões e aos registos, não ao conteúdo dos dados. Quando é necessário testar o funcionamento com exemplos, trabalhamos com uma cópia ou com dados anonimizados.

Outros caminhos

Próximos passos

Conversa sem compromisso

Análise em quatro dias úteis

Uma conversa, dois dias a percorrer a lista de doze pontos e um relatório com o custo de cada correção. Comecemos com trinta minutos para nos explicarem o que está bloqueado e onde.