A Transpareo na era dos agentes de IA

É pouco depois do fim do 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: «Publicar os passaportes de 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 a ficha deste produto, cria as fichas e submete-as a verificação em conformidade com as regras do regulamento. Resposta: 1237 estão prontos, 3 não, porque num lote falta a pegada de CO2. Ela fornece o valor em falta e o assistente publica-os. Dois dias depois, as células saem da fábrica, cada uma com um código QR, através do qual o seu passaporte pode ser consultado.

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

Experimente agora

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

1. Ligar. Crie uma nova aplicação no seu assistente, introduza https://demo.transpareo.com/mcp como endereço e clique em «Ligar».
2. Partilhar. Inicie sessão com tester e DemoPass2027 - os dados de acesso estão aqui indicados propositadamente. O ecrã seguinte identifica cada autorização individualmente. As autorizações de leitura podem ser concedidas de forma permanente; quanto às de escrita, é preferível confirmá-las individualmente.
3. Perguntar. De volta à janela de chat, pergunte em linguagem coloquial, por exemplo : «Apresente a lista das fichas de produto.»

O que foi solicitado foi uma lista; o que foi lido foi o estado.

O que recebe de resposta 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 histórico, o que falta.

Essa é a razão deste artigo. O resto explica por que razão funciona.

Dito e feito

Havia exatamente uma página para integrar: o assistente no Transpareo, os três passos referidos anteriormente. A outra era um ficheiro que o sistema de produção já emite 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 escreveu as correspondências, e o que ele devia fazer estava descrito numa única frase. Se a lista mudar, muda uma instrução para o assistente, **sem qualquer código de programa **.

O seu sistema não precisa de ter nenhuma capacidade 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.

Essa mesma lista também poderia ser introduzida manualmente. O importador no Gestor de Aplicações recebe tabelas, nomeia as colunas que reconheceu, verifica o processo antes de se gerar qualquer resultado e , se desejado, anula-o. O resultado teria sido o mesmo. Apenas alguém teria de confirmar a atribuição, relatório e teria de 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 exige.

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 empresa de reciclagem, 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 com um programa.

Por isso, o Transpareo foi 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 verificação e criação, até à publicação e aos eventos relativos a uma única peça no terreno. E é versionada: quem hoje desenvolver algo com base nela 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 termina na criação. O mesmo tipo de frase aplica-se ao longo de todo o ciclo de vida:

• «Recupere todos os certificados da remessa B-2214.»
• «Atualize o novo valor de CO₂ para o lote 88.»
• «Mostre-me todos os passaportes que entraram para reparação este mês.»

Cada uma destas frases traduz-se nas mesmas chamadas que uma pessoa aciona no Gestor de Aplicações e deixa o mesmo rasto.

Um assistente tem de poder perguntar, não adivinhar

Um assistente é um colaborador muito rápido, sem conhecimento prévio sobre a vossa empresa. Ele faz o que lhe dizem 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 é necessário. Para cada produto e cada nível de detalhe, a plataforma indica quais os identificadores e características de que um passe necessária e quais deles já se encontram registados no produto. No caso de uma peça única, fica assim:

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

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

Tem de poder verificar sem ter de escrever. Uma verificaçã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 3, antes de qualquer coisa ter sido publicada.

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

PRODUCT_INVALID: Produto inválido
Corrija os atributos listados nos campos e reenvie o pedido.
  brand: A marca necessita de uma marca - não foi indicada nenhuma
  componentsInput: Falta a entrada dos componentes

Um assistente que leia isto completa dois dados e reenvia a solicitação. Alguém que receba apenas um código de erro vai tentando várias coisas. É o mesmo texto que uma pessoa vê na linha de comandos .

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

Cada acesso pode ser revogado

Quanto mais programas trabalharem com os seus dados, mais importante se torna determinar quem tem permissão para fazer o quê. Um acesso é criado no Gestor de Aplicações e revela a sua chave secreta uma única vez. Depois disso, o programa funciona com tokens que expiram ao fim de uma hora, e a chave secreta só é transmitida para o local que emite os tokens. Esta é armazenada no conjunto de chaves do sistema operativo, nunca num argumento de linha de comandos, que de outra forma constaria em qualquer lista de processos.

Cada acesso possui exatamente os direitos que lhe atribuir: a leitura é um, a escrita é outro, a publicação é um terceiro, e pode ser restringido até ao nível de produtos específicos. Operações irreversíveis exigem, adicionalmente, uma confirmação.

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

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

Os seus dados permanecem consigo

Por si só, o Transpareo não envia nada a um fornecedor de IA. O que chega a um fornecedor é aquilo que o senhor/a senhora acede através do seu assistente - e qual é esse assistente e se o processamento ocorre dentro da UE, é o senhor/a senhora quem decide, não nós. 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 nisso.

Para uma empresa europeia, este é o ponto crucial. A própria plataforma está alojada em centros de dados com certificação ISO 27001 na Alemanha; para onde mais os dados são enviados, depende exclusivamente da escolha do assistente. Pode optar por um que trate os dados na UE ou por um que nunca empresa: o transpareo mcp executa 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 consta, de facto, num passaporte do produto. Trata-se, 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, com o seu próprio endereço, por exemplo, https://dpp.example.com/mcp: os mesmos três passos, sem necessidade de instalar nada.

Quem preferir digitar ou transformar processos em scripts, pode utilizar a linha de comandos. O transpareo é um único programa cujos comandos são gerados a partir da descrição da interface: 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 «segredo» é lido pelo comando 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, ficaria na lista de processos e no histórico do shell. Em seguida, o mesmo ficheiro binário executa os seguintes passos:

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, uma linha adicional irá ligá-lo:

transpareo setup claude

Os mesmos processos ficam então disponíveis como ferramentas, com nomes correspondentes: dpp_requirements, validate_dpp, create_dpp, publish_dpp, tail_events. O que introduz na linha de comandos e o que um assistente invoca é 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 área de trabalho em /apidocs.

Um assistente não tem qualquer custo adicional

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

O trabalho começa antes de se tornar obrigatório

A partir de fevereiro de 2027, o passaporte do produto para baterias será obrigatório, seguindo-se outros grupos de produtos. O verdadeiro esforço não reside no passaporte, mas 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 os dados 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 certificados que parecem plausíveis mas que não resistem a uma verificação. Um assistente que pode fazer perguntas gera certificados que estão corretos. A diferença não reside no assistente. Reside na plataforma a que este recorre.