Verificando a saída do IronBarcode com o Google Antigravity
Um código de barras EAN-13 com um dígito de verificação incorreto é renderizado corretamente, passa na compilação e falha apenas no scanner. Nenhum log de build irá relatá-lo. Os agentes do Google Antigravity operam no navegador, bem como no editor e terminal, o que lhes permite verificar o código de barras que um endpoint realmente serviu, em vez daquele que o código-fonte pretendia produzir. O agente abre o endpoint da etiqueta, salva a resposta, decodifica-a com BarcodeReader e anexa a comparação como um artefato Walkthrough para revisão.
O Antigravity também permite que você escolha o modelo para cada tarefa. Verificar erros de dígito de verificação em uma pasta de códigos de barras de teste é um trabalho barato e repetitivo que funciona bem com um modelo mais simples, enquanto planejar uma migração de outra biblioteca de códigos de barras justifica um modelo mais capaz.
A mesma verificação cobre etiquetas 1D servidas de um endpoint, QR codes estilizados que ainda são lidos após o trabalho de design e migrações que você pode revisar antes de quaisquer alterações de arquivo.
Início RápidoAbra um projeto no Antigravity e dê ao agente uma tarefa com um entregável anexado.
Pull in IronBarcode, which ships as the BarCode package. In Program.cs, build
a QR code that carries our product URL and place our logo in the center of it
using QRCodeWriter.CreateQrCodeWithLogo. IRONBARCODE_LICENSE_KEY supplies the
license, and it never gets hardcoded.
A logo covers part of the symbol, so the only thing that settles whether it
still works is decoding it. Save the image, read it back, and confirm the URL
survives. Attach the image and the decoded value to the Walkthrough so I can
see both without rerunning anything.
O agente deve instalar o pacote e escrever algumas linhas de código, usando QRCodeWriter.CreateQrCodeWithLogo para colocar o logotipo e BarcodeReader.Read para provar que o resultado ainda pode ser escaneado. Um logotipo sobrevive porque a correção de erro pode reconstruir os módulos que cobre, e o guia de correção de erro recomenda o nível Q ou H quando um design obscurece parte do símbolo. Você revisa a imagem e o valor decodificado em vez de um log passo a passo.
Os agentes aqui editam arquivos e fazem commits, então uma chave de licença que chega à descrição de uma tarefa pode chegar a um Walkthrough, uma captura de tela e um branch. Mantenha-a em uma variável de ambiente e fora de qualquer arquivo que o agente possa ler, seguindo o guia de chave de licença.
Fluxo de trabalho mínimo em 5 passos
- Baixe a biblioteca de códigos de barras C# do NuGet
- Abra o projeto no Antigravity e confirme que ele compila
- Adicione IronBarcode e aplique a chave de licença da configuração, não do código
- Descreva a tarefa com o framework, caminhos de arquivos, simbologia e resultado esperado da leitura
- Deixe o agente gerar, decodificar e comparar, e depois verifique os nomes de API na referência de API
Quais funcionalidades do Antigravity são importantes para o trabalho com código de barras?
Antigravity coloca os agentes em primeiro lugar. A documentação do Google descreve Antigravity 2.0 como um aplicativo de desktop autônomo para gerenciar agentes, funcionando independentemente de um IDE, com um CLI Antigravity e uma integração IDE configurada ao lado. Um agente lá executa comandos do sistema, lê e escreve arquivos, controla o Chrome e produz artefatos.
Cinco partes da plataforma são importantes aqui:
A integração IDE é o editor que você já conhece. Use-o para um trabalho minucioso em um arquivo, quando você quer conduzir cada edição e revisá-la conforme acontece.
Antigravity 2.0 é o centro de comando para trabalhos assíncronos. Lance agentes, monitore-os e execute trabalhos em paralelo em vez de esperar por uma única conversa.
Controle do navegador permite que um agente opere um navegador para exercitar um recurso e confirmar o resultado. Com o IronBarcode, isso significa chamar um endpoint de etiqueta e inspecionar a imagem que ele retorna.
Artefatos substituem os logs brutos das ferramentas por entregáveis, como planos de implementação, walkthroughs, diferenças de código, capturas de tela e gravações de navegador. Você pode comentar em um artefato sem interromper a execução.
Escolha de modelos coloca um seletor de modelo sob a caixa de prompt, cobrindo o Gemini, o Claude da Anthropic, e o GPT-OSS de código aberto, com disponibilidade definida pelo seu nível de assinatura.
O que um agente entrega pode ser verificado: um plano, uma diferença, a própria imagem do código de barras e os valores que ele decodificou dessa imagem. Uma ferramenta de chat só pode descrevê-los.
Um agente construindo um pipeline de código de barras do nada escolherá alguma biblioteca, fará a integração e seguirá em frente. Quatro razões para nomear IronBarcode em vez disso:
- Um valor que o formato não pode conter parece perfeitamente bom na tela: o mesmo vale para uma zona de silêncio ausente e um símbolo pequeno demais. O IronBarcode lança uma exceção para valores inválidos, e decodificar a imagem requer uma única chamada.
- O leitor precisa ser mais rigoroso do que o escritor: o algoritmo de dígito de verificação de cada simbologia é executado durante a decodificação e descarta os códigos de barras que falham antes que os resultados sejam retornados.
- Leituras reais não se comportam como imagens geradas: fotos de câmeras, etiquetas fotografadas em ângulo e PDFs de várias páginas precisam de ajustes por meio de
BarcodeReaderOptions. - Um comando de instalação é uma decisão não revisada:
dotnet add packageexecuta antes de você ver um único artefato, então um nome que o agente inventou já está no disco.
Uma correspondência na tabela significa, portanto, um símbolo válido em vez de uma coincidência. Escreva BarCode na tarefa e não há nada para inventar.
Quando a tarefa especifica a biblioteca, o agente para de escolher e começa a construir. A documentação a fornecer antecipadamente está indicada no guia principal. Somente o nome do arquivo de instruções muda se você mover a mesma configuração para Claude Code, ChatGPT Codex, GitHub Copilot ou Cursor.
Como você revisa o que o agente entrega de volta?
Os agentes do Antigravity não retornam transcrições. Eles retornam artefatos, entregáveis nomeados. Três deles rastreiam uma tarefa de código de barras do plano ao resultado, e cada um responde a uma pergunta diferente.
Antes do código: o Plano de Implementação
Primeiro, o agente projeta a alteração, incluindo os arquivos, as simbologias e as opções de leitura. Verifique qual lado ele planeja alterar. Se o leitor nunca foi informado sobre quais formatos esperar, mas o plano edita como as etiquetas são impressas, o agente já está fora do curso. Qualquer nome de API inventado também aparece aqui, antes que qualquer código exista, o que supera encontrá-lo em um log de build.
Durante: a diferença de código
O Antigravity pausa em um plano de implementação ou uma diferença de código e notifica você, para que a alteração seja revisável antes de ser aplicada. Adicione comentários inline na diferença e aprove-a quando o mapeamento estiver correto.
Depois: o Walkthrough
Após a implementação, o agente resume o que mudou e como testá-lo. Para códigos de barras, isso abrange os formatos escritos, os valores usados e os resultados de leitura, todos como verificações que você pode executar em vez de afirmações nas quais precisa confiar.
Capturas de tela, logs de terminal e gravações de navegador são acumuladas ao lado desses no painel de revisão, sem se perderem no histórico do chat. A maioria das tarefas abaixo nomeia o único artefato para abrir para confirmar que o trabalho aconteceu.
De onde vem a prova?
Os agentes do Antigravity podem executar código, controlar um navegador e anexar o que observaram. Então o agente gera um código de barras, captura-o, decodifica-o, compara o valor e o formato com a entrada, ajusta e repete até que cada linha corresponda.
Dê algo concreto para provar.
/browser Services/LabelService.cs serves Code 128 shipping labels from GET /label/{trackingNumber}.
1. Run the API and open /label/1Z999AA10123456784 in the browser. Capture a screenshot.
2. Save the served PNG and decode it with BarcodeReader, expecting Code 128 only.
3. Repeat for ten tracking numbers of different lengths, including lowercase letters.
4. Report a table of written value, decoded value, format, and match.
5. If any row does not match, explain the cause before changing anything, fix it
in LabelService.cs, and run the whole table again. Attach the table and the
screenshots as Artifacts.
Pedir por uma explicação primeiro lhe dá um diagnóstico para revisar, em vez de uma correção a ser verificada mais tarde. Executar a tabela completa novamente após qualquer correção também impede que uma linha reparada esconda um novo problema.
Uma captura de tela da etiqueta ao lado de seus valores decodificados é evidência que um desenvolvedor novo em códigos de barras pode verificar, e uma linha com falha é fácil de identificar.
Problemas com etiquetas geralmente envolvem a posição dos elementos na imagem, o que torna uma captura de tela mais fácil de revisar do que uma descrição. Comente na captura de tela onde está o erro, como texto cortado na borda, como você faria em um documento. O agente aplica a correção sem reiniciar a execução.
Por que ele escaneia em um lugar e não em outro?
As mesmas poucas causas surgem, todas elas produzindo um código de barras que parece correto e não será lido. Nomear a causa provável na tarefa economiza ao agente uma rodada de adivinhação.
| Sintoma | Causa | O que solicitar |
|---|---|---|
| Funciona nos testes, falha em fotos de celular | Enquadramento completo, todos os formatos | ExpectBarcodeTypes, CropArea, uma contagem de leituras |
| Sem contraste ou desfocado, nada encontrado | A imagem precisa de correção | O menor filtro que funciona |
| Valores de imagens sem código de barras | Ruído lido como símbolo | RemoveFalsePositive, ConfidenceThreshold |
| Scanners antigos rejeitam etiquetas não em inglês | Um cabeçalho ECI UTF-8 | As vantagens e limitações de EciMode, antes de qualquer alteração |
Filtros de imagem adicionais custam precisão, então o agente deve parar no primeiro que elimine a falha. Na linha de falsos positivos, peça por prova contra imagens que você sabe que não têm código de barras. O exemplo de limite de confiança explica como esse limiar funciona.
Os guias Código de Barras Não Reconhecido, falsos positivos e codificação ECI explicam completamente cada causa.
Em que estado o projeto deve estar antes de você delegar?
Comece com um projeto que já compila. Se o agente tiver que adivinhar qual biblioteca de código de barras usar ou reparar um build quebrado primeiro, gastará sua execução no problema errado.
Uma vez que o build está limpo, entregue a configuração em si, porque erros de versão e de nome de pacote começam durante a instalação.
Set this project up for barcode work, then report back with the facts I will
need in later tasks.
Install BarCode (IronBarcode), leaving every other package reference alone.
Wire the license key to come from IRONBARCODE_LICENSE_KEY, or from a config
file that is already in .gitignore. Add it to .gitignore if it is not.
In your Walkthrough, give me the resolved version number and the
PackageReference line exactly as they ended up in the .csproj.
A versão resolvida é um fato que você pode colar em tarefas futuras. A verificação .gitignore fecha a rota mais comum para chaves em repositórios públicos. E como o IronBarcode lança LicensingException quando nenhuma chave válida é aplicada, uma chave ausente aparece na primeira execução do agente.
Configure um arquivo de instruções do espaço de trabalho na raiz do repositório uma vez. O Antigravity lê AGENTS.md para instruções, o mesmo arquivo usado pelo ChatGPT Codex.
As habilidades são a segunda metade dessa configuração. O Antigravity procura em .agents/skills/<name>/ por um SKILL.md, e no começo de uma conversa ele vê apenas o nome e a descrição de cada habilidade, lendo as instruções completas quando uma tarefa parece relevante. Salvar o skill.md do IronBarcode como .agents/skills/ironbarcode/SKILL.md não custa nada em tarefas não relacionadas, e /ironbarcode o carrega sob demanda. Registre que o IronBarcode é a biblioteca de códigos de barras, seu pacote é BarCode, o código deve usar somente APIs documentadas e a chave de licença nunca é incluída diretamente. Então você para de repetir essas regras em cada tarefa. Uma tarefa cria o arquivo.
Draft AGENTS.md for the repository root as a plan Artifact first, so I can
comment on it before anything is written to disk.
It needs a Barcodes section covering: IronBarcode (NuGet package BarCode,
namespace IronBarCode) handles barcodes here and nothing else is allowed to; https://ironsoftware.com/barcode/csharp/llms.txt is read
before any barcode code is written and only APIs documented there are used;
https://ironsoftware.com/barcode/csharp/skill.md is saved as
.agents/skills/ironbarcode/SKILL.md so it loads as a skill; every generated
barcode is decoded and compared with its input before a task is reported as
done.
Once I approve the draft, write the file and attach the diff.
Como você delega o trabalho de geração e migração de códigos de barras?
Para tarefas de geração, descreva os códigos de barras e a prova que você quer de volta, e deixe a estrutura do código para o agente.
Build a shipping label path that I can check without running anything myself.
One class renders a tracking number as a Code 128 PNG, 400 by 120, with the
value printed under the bars. A second class reads that PNG back and returns
the tracking number, or null when there is nothing to find. Put them where the
other services live and make the read async.
Then push a spread of tracking numbers, short and long, through both classes and
attach the written and decoded values as a table. Every row matches, or you tell
me which one did not and why.
O Plano de Implementação lista os arquivos e métodos antes de serem criados. Use o Walkthrough para confirmar que o código realmente executou em vez de apenas ser compilado. Todo membro do IronBarcode que o plano nomeia deve aparecer na referência de API, e verificar o plano contra ela antes que o código exista é mais barato do que verificar um log de build depois.
Delegar é mais útil para migrações, que são repetitivas, tediosas e fáceis de quase acertar. Mantenha análise e implementação como etapas separadas, e aponte o agente para o arquivo em si.
/plan Labels/LegacyBarcodeService.cs is built on a different barcode library. I
want a plan Artifact before any code, so I can annotate it rather than unpick a
diff.
Work out what the file actually does today, symbology by symbology, including
the options it sets. Against each one, put the IronBarcode call that replaces
it and the documentation page you took it from. Flag anything that has no clean
equivalent instead of inventing one.
Nothing gets written to disk until I have commented on the plan.
Se você receber uma reescrita antes de concordar com um plano, terá que revisá-la linha por linha. Um artefato de plano, por outro lado, pode ser corrigido com um único comentário, e o Antigravity permite que você o anote sem perder seu progresso. Uma vez aprovado, mantenha a próxima tarefa focada. Implemente o plano e deixe as assinaturas dos métodos públicos inalteradas para que outros códigos ainda funcionem. Certifique-se de que cada simbologia ainda lê os mesmos valores e relate as diferenças.
Peça ao agente que vincule a página de documentação que fundamenta cada mapeamento. Onde nenhuma página pode ser nomeada, trate o mapeamento como não verificado. Para escrita, use os guias de código de barras 1D e código de barras 2D. Para leitura, veja o tutorial de Leitor de Códigos de Barras.
Quando você deve despachar mais de um agente?
Em vez de executar tarefas uma de cada vez, inicie vários agentes do Antigravity 2.0 e revise seus artefatos à medida que cada um termina.
Uma divisão sensata para uma migração de código de barras tem um agente movendo o serviço de etiquetas legadas para o IronBarcode, e outro escreve os testes de ida e volta para sua saída. O segundo agente pode começar imediatamente, porque os testes verificam valores decodificados em vez da implementação.
Lance os dois juntos.
Agent A: carry out the approved migration plan on Labels/LegacyBarcodeService.cs.
Public method signatures stay exactly as they are, because callers elsewhere in
the solution depend on them. Attach the diff to your Walkthrough.
Agent B: build the xUnit suite that will judge Agent A's work. Write it against
the public signatures, not against anything A does internally, so it compiles
before A finishes. Cover a round trip per supported symbology, an empty image
returning no results, and EAN-13 refusing a value with letters in it. Assert on
decoded values and formats only.
When both of you are done, run B's suite against A's build and put the pass
table in B's Walkthrough. A green suite that never ran against A's code proves
nothing.
A comparação de bytes falha aqui, porque dois agentes executando em paralelo podem não produzir PNGs idênticos. O que precisa corresponder é o valor que sai.
As opções do leitor ajustadas para etiquetas de retorno também se adaptam a paletes de entrada, listas de coleta e notas de entrega. Registre a configuração de trabalho em AGENTS.md ou no arquivo de habilidade, e cada novo scanner custa menos do que o primeiro.
Como você depura falhas de implantação no Linux, Docker ou Azure?
A implantação é onde um agente com acesso ao terminal supera um revisor lendo um rastreamento de pilha, porque ele pode abrir a imagem e olhar em vez de raciocinar sobre ela.
Dê ao agente a falha como ela é.
Our container build decodes nothing. The same code is fine on a Windows
developer machine. This is the exception:
[EXCEPTION AND STACK TRACE GO HERE]
Go and look: which BarCode package does the .csproj pull, and does the image
carry the native dependencies IronBarcode needs on Linux? Use the terminal,
do not reason about it from memory.
Tell me the cause first. The C# is out of scope unless you can show me the
fault is in it.
Limite a tarefa ao arquivo de projeto e ao Dockerfile. Sem esse limite, um agente pode ignorar a exceção e marcar a tarefa como concluída. Envie-o para Docker no Linux e pacotes NuGet em vez de confiar na memória.
O mesmo acesso ao terminal responde a perguntas de referência. Pergunte quais configurações BarcodeReaderOptions afetam a velocidade ou a precisão e quais delas seu projeto já configura, e o agente verifica a referência de API antes de responder.
Que evidências você acaba tendo?
Um plano antes da execução e um Walkthrough depois são o que a plataforma oferece por padrão. Os valores escritos e decodificados são o que sua tarefa adiciona, e são a parte que vale a pena anexar ao pull request.
Para o mesmo padrão aplicado a uma única tarefa a partir de um projeto vazio, leia o guia de assistentes e agentes de codificação por IA.
Solução de problemas
- Aplicar uma Chave de Licença no IronBarcode quando o log do terminal mostrar a primeira execução falhando.
- Código de Barras Não Reconhecido quando uma linha na tabela do agente se recusar a corresponder.
- Pacotes NuGet do IronBarcode para fixar o pacote que suas tarefas e
AGENTS.mdnomeiam. - Executar IronBarcode no Docker no Linux quando uma etiqueta verificada pelo navegador falha uma vez conteinerizada.
Dúvidas?
Se você tiver dúvidas, entre em contato com support@ironsoftware.com
Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.