A Transpareo na era dos agentes de IA

Acabou de terminar o turno. A responsável pela conformidade exporta a lista de turnos do sistema de produção, coloca-a no seu assistente e escreve uma frase: «Publique os passaportes do produto para as células desta lista.»

O assistente lê 1240 números de série com os respetivos lotes, consulta a Transpareo para saber o que é necessário para o certificado deste produto, cria os certificados e submete-os a verificação em relação às regras do regulamento. Resposta: 1237 estão em conformidade, 3 não, porque numa das lotes falta a pegada de CO2. A empresa fornece o valor posteriormente, e o assistente publica-o. Dois dias depois, as células saem da fábrica, cada uma com um código QR, através do qual o respetivo certificado pode ser consultado.

Isto não é uma visão do futuro: com o Transpareo Connect, isso já é possível hoje. Um assistente realiza aqui uma tarefa de conformidade, desde a encomenda até ao passaporte assinado, e a Transpareo fornece-lhe ao longo do processo tudo o que ele precisa de saber para o efeito.

Experimente já

Tem uma conta no Claude, ChatGPT, Grok ou Gemini que permita ligar aplicações? Nesse caso, ligue-a à nossa demonstração aberta. Trata-se de um ambiente de teste: a cada hora, é reiniciada, e tudo o que fizer nela será apagado até lá.

1. Ligar. Crie junto do seu fornecedor de IA um novo servidor MCP com o endereço https://demo.transpareo.com/mcp . Dependendo do fornecedor, encontrará esta opção em «Connector», «Integration» ou «App».
2. Partilhar. Inicie sessão com tester e Tester@12345 - os dados de acesso constam aqui propositadamente. O ecrã que se segue indica cada autorização individualmente. Pode autorizar permanentemente os utilizadores com direitos de leitura; quanto aos que têm direitos de escrita, é preferível que os confirme individualmente.
3. Perguntas. De volta à janela de chat, faça a pergunta em linguagem coloquial, por exemplo : «Enumere os passaportes dos produtos.»

O que se pediu foi uma lista; o que se leu foi a situação.

O que recebe não é apenas o que solicitou, mas também em que estado se encontra. Isto é possível porque a interface fornece mais informação do que as próprias linhas: quantas são, onde se encontram no currículo, o que falta.

É essa a razão por detrás deste artigo. O resto explica por que razão funciona.

Dito e feito

Era necessário ligar exatamente uma parte: o assistente ao Transpareo, os três passos que acabámos de referir. A outra parte era um ficheiro que o sistema de produção já gera de qualquer forma. Ninguém definiu qual a coluna que corresponde a cada campo, ninguém mantém uma interface: O assistente leu a lista e criou os registos, e o que devia fazer estava descrito numa única frase. Se a lista se alterar, altera-se uma instrução para o assistente, não o código do programa.

O seu sistema não precisa de ter nenhuma funcionalidade específica para isso. Basta que apresente o que já apresenta de qualquer forma: o ficheiro de exportação, a lista do relatório, a tabela do fim do turno.

E não tem de ser necessariamente uma tabela. A ficha técnica de um fornecedor, um PDF, um histórico de e-mails: mesmo a partir destes, um assistente lê os valores e adapta-os ao formato exigido pela Transpareo. Pois a Transpareo especifica esse formato, em vez de deixar que se adivinhe. Os dados dos produtos raramente se encontram estruturados, mas sim em documentos, e extraí-los desses documentos foi, durante anos, o ponto fraco do processo.

Essa mesma lista também poderia ser introduzida manualmente. O importador no gestor da aplicação aceita tabelas, identifica as colunas que reconheceu, verifica o processo antes de qualquer ação ser executada e , se desejado, anula-o. O resultado teria sido o mesmo. A única diferença é que alguém teria de confirmar a atribuição, ler o relatório e preencher ele próprio os três valores em falta. Um assistente não altera o que é possível, mas sim o tempo que isso demora.

O trabalho de integração, que até agora marcava o início de cada projeto de conformidade, cabe hoje numa frase em linguagem corrente.

Essa é a verdadeira revolução. Desde que a plataforma do outro lado consiga indicar a um programa o que pretende.

Os programas sempre foram os principais leitores

Um passaporte do produto raramente é lido manualmente. É digitalizado, consultado, verificado, transmitido e arquivado, e a maior parte desse processo é realizada por software: a caixa registadora do comerciante, o sistema da reciclador, a ferramenta de verificação de uma autoridade, o importador que pretende saber se um lote está em conformidade. A maioria dos seus leitores não o lê, portanto, com os olhos, mas sim através de um programa.

O Transpareo foi, por isso, concebido em torno da sua interface. Cada passaporte publicado é um documento assinado e legível por máquina, e a interface abrange todo o ciclo de vida: desde os tipos de características de um produto, passando pela validação e criação, até à publicação e aos eventos relativos a cada unidade no terreno. E é versionada: quem hoje desenvolve algo para ela não está a construir sobre areia. O que é novo, portanto, não é o facto de os programas trabalharem com passaportes. O que é novo são os programas em si.

E é por isso que o trabalho de um assistente não se limita à criação. Este mesmo tipo de frase repete-se ao longo do resto do currículo:

• «Retire todos os passaportes do lote B-2214.»
• «Registe o novo valor de CO₂ para o lote 88.»
• «Mostre-me todos os passaportes que foram enviados para reparação este mês.»

Cada uma destas instruções corresponde às mesmas chamadas que um utilizador efectua no gestor da aplicação e deixa o mesmo registo no registo de auditoria.

Um assistente deve saber perguntar, não adivinhar

Um assistente é um colaborador muito rápido, sem conhecimentos prévios sobre a vossa empresa. Ele faz o que lhe mandam e preenche as lacunas com suposições, caso não lhe sejam dadas respostas. Quatro aspetos transformam as suposições em trabalho.

Tem de poder perguntar o que é exigido. Para cada produto e cada nível de detalhe, a plataforma indica quais os identificadores e características de que um passe é necessário e quais deles já se encontram registados no produto. No caso de uma peça única, o processo é o seguinte:

{
  "identifiers": {
    "batchIdentifier": { "required": true },
    "modelIdentifier": { "required": true, "source": "product", "value": "4006381333931" },
    "serialIdentifier": { "required": true }
  }
}

O assistente tem de obter dois dos três códigos; o terceiro já consta do produto. Trata-se de uma instrução de trabalho, não de uma sessão de adivinhação.

Tem de poder verificar sem escrever. Uma validação realiza as mesmas verificações que uma publicação e não cria nada. Foi precisamente por isso que, acima, o número 1237 passou a ser 3, antes de qualquer coisa ter sido publicada.

Ele tem de compreender por que razão algo foi rejeitado. Uma rejeição indica o campo em questão e indica o que deve ser feito:

PRODUCT_INVALID: Product invalid
Correct the attributes listed under fields and resend the request.
  brand: Brand needs a brand - none was given
  componentsInput: Components input missing

Um assistente que ler isto acrescenta dois dados e reenvia. Outro, que recebe apenas um número de erro, tenta várias opções. Trata-se do mesmo texto que uma pessoa vê na linha de comandos.

Não pode contar mal. Se uma ligação for interrompida e o assistente tentar novamente, mesmo assim só será criada uma passagem, e não duas. As chamadas de escrita incluem uma chave, através da qual a plataforma reconhece uma repetição como tal.

Qualquer acesso pode ser revogado

Quanto mais programas trabalharem com os seus dados, tanto mais importante se torna determinar quem tem permissão para fazer o quê. É criada uma autorização no gestor da aplicação, que revela a sua chave secreta uma única vez. Posteriormente, o programa funciona com tokens que expiram ao fim de uma hora, e a chave secreta só é transmitida ao local que emite os tokens. É armazenada no conjunto de chaves do sistema operativo, nunca num argumento da linha de comandos, que, de outra forma, constaria em qualquer lista de processos.

Cada acesso dispõe exatamente dos direitos que lhe atribuir: a leitura é um, a escrita é outro, a publicação é um terceiro, e pode ser restringido a produtos específicos. As operações irreversíveis exigem, além disso, uma confirmação.

Quando um assistente estabelece ligação no navegador, surge, antes da autorização, um ecrã que indica cada uma das autorizações que este solicita. Se a autorização for concedida, a ligação fica registada na página de acessos, com o nome e a data da pessoa que a concedeu, e é também aí que é desativada.

Um acesso que não se pode retirar não é um acesso, mas sim uma chave debaixo do capacho.

Os seus dados permanecem na sua posse

O que chega a um fornecedor de IA é aquilo que o senhor/a senhora obtém através do seu assistente - e quem é esse assistente e se o processamento é efetuado dentro da UE, é o senhor/a senhora que decide, não nós. Um serviço de tradução só recebe um valor proveniente dos dados do seu produto nos casos em que ativou a tradução e, mesmo assim, apenas para si próprio. A ferramenta que estabelece a ligação funciona no seu próprio computador e o seu código-fonte é aberto: o seu departamento de segurança pode verificar o que ela faz, em vez de ter de acreditar nela.

Para uma empresa europeia, este é o ponto decisivo. A própria plataforma está alojada em centros de dados com certificação ISO 27001 na Alemanha; para onde os dados são posteriormente encaminhados, depende exclusivamente da escolha do assistente. Pode optar por um que efetue o tratamento na UE ou por um que nunca saia da sua empresa: o transpareo mcp hospeda o protocolo no seu próprio computador, e o modelo que está por trás disso é da sua responsabilidade.

A isto acrescenta-se o que, de facto, consta num passaporte do produto. Trata-se, em regra geral, de dados do produto: números de série, lotes, materiais, valores de medição. Sempre que houver uma referência a pessoas, são as suas próprias regras que determinam quem pode aceder a essa informação, e a autorização pode ser adaptada exatamente a isso: apenas leitura, apenas determinados produtos, desativável a qualquer momento.

A configuração demora apenas alguns minutos

O mesmo se aplica ao seu próprio espaço de trabalho, na sua própria morada, por exemplo, https://dpp.example.com/mcp: os mesmos três passos, não é necessário instalar nada.

Quem prefere escrever ou transformar processos em scripts, recorre à linha de comandos. O transpareo é um único programa cujos comandos são gerados a partir da descrição da interface: tudo o que a plataforma consegue fazer, a ferramenta também consegue, sem que seja necessário que alguém ajuste ambas manualmente. É de código aberto e está disponível no GitHub. Três linhas: instalar, iniciar sessão, verificar quais são os direitos de acesso.

curl -fsSL https://transpareo.com/cli/install.sh | sh
transpareo auth login --host dpp.example.com --client-id <id>
transpareo me

O «Geheimnis» lê auth login a partir da entrada padrão ou de uma variável de ambiente, nunca a partir de um argumento, que, de outra forma, constaria na lista de processos e no histórico do shell. Em seguida, o mesmo ficheiro binário executa os processos:

transpareo dpps requirements --product-id 8 --granularity item
transpareo dpps validate --file passport.json
transpareo dpps create --file passport.json
transpareo dpps publish <code>
transpareo events tail --follow

Se estiver a ser executado um assistente no seu próprio computador, há uma outra linha que o liga:

transpareo setup claude

Essas mesmas operações estão então disponíveis como ferramentas, com nomes correspondentes: dpp_requirements, validate_dpp,create_dpp, publish_dpp, tail_events. O que digitar na linha de comandos e o que um assistente acede é a mesma coisa. A isto acrescenta-se um manual para assistentes, que descreve os processos habituais, para que ninguém tenha de aprender a sequência por tentativa e erro. E quem preferir programar diretamente, encontrará a descrição completa da interface em cada espaço de trabalho em /apidocs.

Um assistente não implica qualquer custo adicional

Nada mais. Um assistente liga-se como utilizador da API, e o acesso para programas está incluído em todos os planos do Transpareo. O que é contabilizado são os passaportes publicados, e não o número de pessoas ou programas que neles trabalham. Quem automatizar o seu trabalho de conformidade não deve receber qualquer fatura por isso.

O trabalho começa antes do dever

A partir de fevereiro de 2027, o passaporte do produto para baterias passará a ser obrigatório, seguindo-se outros grupos de produtos. O verdadeiro esforço não reside no passaporte, mas sim na organização dos dados do produto, e é precisamente este trabalho é que as empresas estão atualmente a delegar aos assistentes: reunir campos, identificar lacunas, verificar as informações dos fornecedores, verificar e repetir. A forma como estes dados chegam ao passaporte é descrita em «Uma corrente, uma direção»; quanto à configuração de uma ligação própria para o efeito, consulte o guia de ligação ao ERP.

Um assistente que tem de adivinhar gera documentos que parecem plausíveis, mas que não resistem a uma verificação. Um assistente que pode fazer perguntas gera documentos que estão corretos. A diferença não reside no assistente. Reside na plataforma a que ele recorre.