Tariffiq: Ensinando um Agente de IA a Calcular Seus Tarifas de Importação

Os proprietários de pequenas empresas que importam mercadorias muitas vezes não descobrem o custo real de uma remessa, tarifas, impostos e o impacto em suas margens até depois de já terem feito o pedido. Eu construí Tariffiq para responder a isso instantaneamente, e para o Desafio OpenAI WebMCP, eu dei a ele algo a mais: a capacidade de um agente de IA executar essa mesma análise diretamente, sem tocar na minha interface de usuário.

O que o Tariffiq faz

Insira um produto, seu país de origem, quantidade e preço unitário, e o Tariffiq calcula:

• O custo total após tarifas de importação
• O impacto em suas margens de lucro
• Alternativas de fornecimento mais baratas de outros países, com potenciais economias

Por que WebMCP

WebMCP permite que um aplicativo web exponha ferramentas reais e chamáveis a um agente, não apenas uma página que ele tem que adivinhar como navegar. Essa é exatamente a tarefa que a análise de tarifas representa: verificar um custo, comparar alguns países, decidir sobre um fornecedor. Um agente deve ser capaz de fazer isso em nome de alguém.

Como funciona

Eu usei document.modelContext.registerTool para expor duas ferramentas:

• analyze_tariff — executa uma análise completa para um produto, país de origem, quantidade e preço unitário
• switch_origin_country — re-executa a última análise com um país de origem diferente, para que um agente possa comparar opções de fornecimento sem reentrar tudo o que foi preenchido anteriormente

Ambas chamam diretamente a lógica de análise existente do aplicativo, então, quando um agente invoca uma ferramenta, o resultado é renderizado ao vivo na mesma página que um humano estaria olhando.

A jornada de depuração

A parte mais complicada não foi escrever as ferramentas, mas sim provar que elas funcionavam. O ChatGPT não estava descobrindo de forma confiável minhas ferramentas registradas, o que inicialmente me deixou preocupado que a implementação em si estivesse quebrada. Relendo as regras de perto, percebi que os juízes poderiam testar via ou o navegador in-app do ChatGPT ou Chrome com o WebMCP habilitado, então mudei para verificar tudo através do painel de Ferramentas de Desenvolvedor do WebMCP do Chrome, invocando analyze_tariff diretamente e observando o site de produção ao vivo atualizar em tempo real.

Ao longo do caminho, também encontrei uma peculiaridade do React StrictMode que estava silenciosamente registrando cada ferramenta em duplicidade durante o desenvolvimento, corrigido com uma simples proteção.

Experimente

• Aplicativo ao vivo: tariffiq-gamma.vercel.app
• Código: github.com/Terese678/tariffiq

Construído para o Desafio OpenAI WebMCP feedback é bem-vindo!