Google Antigravity ile IronOCR Nasıl Kullanılır
Birçok AI kodlama araçları, kod derlemesini tamamlar ve kodun çalıştığını doğrulamayı size bırakır. OCR'de bu boşluk maliyetli olabilir. Örneğin, bir fatura ithalatçısı hatasız bir şekilde bir veritabanı oluşturup doldurabilir, ancak toplamların dörtte biri yanlış okunmuş rakamlar içerebilir ve bu durum derleme çıktısında görünmez.
Google Antigravity, incelemeniz için çalışmayı geri döndüren ajanlar aracılığıyla çalışır. IronOCR, görüntülerden ve PDF'lerden metin, barkod ve tabloları .NET'te yerel olarak çıkarır. Ajan test sayfalarını yönettiğinde, içeriklerini bilir, her sayfayı IronOCR ile okur, çıkarılan değerleri bilinen değerlerle karşılaştırır ve eşleşene kadar yinelemeye devam eder.
Bu makale, IronOCR ile yazılım oluşturmanıza yardımcı olacak AI kodlama araçlarını kapsar. IronOCR'un fotoğraflar ve el yazısı üzerindeki kendi makina öğrenme özellikleri ayrı bir konudur ve kendi fotoğraf okuma rehberi ve el yazısı rehberi vardır.
Hızlı BaşlangıçProjenizi Antigravity'de açın ve beklenen çıktıyı belirtin.
/plan In this C# project, add IronOCR (the IronOcr NuGet package, namespace
IronOcr) and read the German invoice at TestData/rechnung.png, printing its text
and overall confidence. Only English ships with the package, so add whatever
German needs and tell me which package that was. Read the license key from the
IRONOCR_LICENSE_KEY environment variable, never hardcode it. Run dotnet build,
fix any errors, and show me the output.
Plan, IronOcr.Languages.German ve dil atamasını belirtmelidir, her ikisini de atlamak hatadır. Dil paketi olmadan, ilk okuma bir LanguagePackException fırlatır, bu yüzden hata hemen ortaya çıkar.
Lisans anahtarı rehberi, IronOCR'un anahtar aradığı tüm konumları detaylandırır.
Asgari İş Akışı (5 adım)
- C# OCR kütüphanesini NuGet'ten indirin
- Projeyi bir ajana teslim etmeden önce derlendiğinden emin olun.
- Barındırıcı ile eşleşen platform paketine referans verin ve anahtarı ayarlardan yükleyin.
- Her göreve sayfalar, dil, alanlar ve vermesi gereken değerleri verin.
- Uygulama Planını, farkları ve geri döndürülen Adım Adım Kılavuz'u inceleyin.
Google Antigravity nedir ve bir sohbet aracından nasıl farklıdır?
Bir hedefe verildiğinde, bir Antigravity tahmini, bir plan üretir, editörde, terminalde ve bir tarayıcıda uygular ve sohbet transkriptine değil, inceleyebileceğiniz Artifacts'e ne yaptığını rapor eder.
Rehberlik olmadan, bir yakalama hattı oluşturan ajan, bulduğu ilk OCR yaklaşımını seçebilir veya bir paket ismi tahmin edebilir. Tahmin edilen bir ad, bir saldırganın bu adı kullanarak önceden yayımladığı bir sahte bir çözüme dönüşebilir; bu durum slopsquatting olarak bilinir. Windows için IronOcr ve Linux için IronOcr.Linux kullanın.
AI kodlama asistanları rehberi, ajana verilmesi gereken IronOCR dokümantasyon bağlantılarını listeler ve Antigravity'de çalıştırabileceğiniz tek adımlı kabul testini içerir.
Ajan neyi geri veriyor ve nasıl gözden geçiriyorsunuz?
Koddan Önce, Uygulama Planı
Plan, dosyaları, dil seçimini, filtreleri ve hedef alanları tanımlar. Kapsamı onaylamak için inceleyin.
Çalışma sırasında, kod farkı
Kod farkı, planın nasıl uygulandığını gösterir. Okuyucunun belirtilen sayfaları yüklediğinden, vaat edilen filtrelerin uygulandığından ve kullanılan her üyenin API referansında bulunduğundan emin olun.
Çalışmadan Sonra, Rehberli Turu
Adım Adım Kılavuz, değişiklikleri özetleyerek ve sonuçların kanıtını sunarak görevi sonlandırır.
Kanıt nereden gelir?
/browser Services/CaptureService.cs extracts delivery note numbers and totals
from uploads to POST /capture.
1. Run the API and upload TestData/known/invoice-01.png in the browser.
Capture a screenshot.
2. Upload every file in TestData/known/ and record the delivery note number
and total returned.
3. Include the five rotated or noisy scans in that folder.
4. Report a table of file, expected delivery note number, number returned,
expected total, total returned, confidence, and match.
5. If any row does not match, explain the cause before changing anything, fix
it in CaptureService.cs, and run the whole table again. Attach the table
and the screenshots as Artifacts.
Tüm tabloyu tekrar etmek, bir tarama için eklenen bir filtrenin diğerlerini bozmadığını doğrular.
CLI'dan, /browser komutu bir Chrome alt ajanı başlattı.
Yanlış bir okuma gibi bir hatayı işaretlemek için, örneğin ters çevrilmiş bir toplam, ekran görüntüsüne yorum yapın.
Yanlış veya eksik OCR değerlerine ne sebep olur?
Çoğu uyumsuzluğun birkaç yaygın nedeni vardır. Şüphelenilen nedeni adlandırın ve ajan deneme yanılmayı atlar.
- Dönmüş veya gürültülü sayfalardaki yanlış rakamlar genellikle
DeskewveDeNoisegerektirir. - Metin döndüren ancak barkod döndürmeyen bir okuma,
Configuration.ReadBarCodesile etkinleştirilmelidir. - Bir tarama sırasında
ConvertToSearchablePdffırlatıldığında, okuyucu sonucundaSaveAsSearchablePdfçağırın.
Antigravity'nin çalışabileceği bir proje nasıl kurulur?
Ajana derlenen bir proje sağlayın. Aksi takdirde, ajan zamanını derleme hatalarında harcayacaktır.
Kurulumu ajana devredin.
Add the IronOcr NuGet package to this project. Then tell me which version was
installed and show me the PackageReference line. Configure the license key to
be read from the IRONOCR_LICENSE_KEY environment variable or a config file
rather than hardcoded, and add that config file to .gitignore if it isn't
already. Don't change other package references.
Rapor edilen sürüm numarasını tüm sonraki görevlerde kullanın.
Erken bir aşamada, depo köküne kalıcı talimatlar dosyası, AGENTS.md veya GEMINI.md ekleyin. OCR'un IronOCR kullandığını kaydedin.
/learn The repository already carries an AGENTS.md from the ChatGPT Codex
setup, and this platform reads the same file. Extend its OCR section with the
rules this platform adds. Produce an Implementation Plan before any file is
edited. Attach the evidence to the Walkthrough rather than describing it. And
treat no task as finished until every page read is checked against a known
value.
Bizim çalışmamızda, ajan mevcut talimatlar dosyasına üç kural ekledi.
Çıkarma ve taşıma işini nasıl delege edersiniz?
Alan çıkarımı gerektiğinde, ilgili sayfaları ve okuyucunun ait olduğu dosyaları belirtin.
Show me the Implementation Plan before any file is written. Then create
Services/DeliveryNoteReader.cs with a method that takes the path of a scanned
PDF, reads it with IronTesseract, and returns the amount on the line
containing Total due with that line's confidence, or null if the line is
missing. Create Services/SearchablePdf.cs with a method that writes a
searchable copy of a scanned PDF. Build, then prove ten sample invoices return
their known totals.
Testimizde, okuyucu her taramayı bir PDF girdisi olarak yükledi ve her sayfanın satırlarını Toplam borç satırı için aradı.
Taşımalar uzun, tekrarlı olduğu ve gözden kaçan köşe vakalarına yatkın olduğu için delege edilmek için uygundur. Ajana mevcut kaynak kodunu belirtin.
/plan Read Capture/LegacyCaptureService.cs. It reads scans with another OCR
library.
1. List every read it performs, with the settings it uses.
2. Map each setting to its IronOCR equivalent, citing the documentation page.
3. Produce this as a plan Artifact. Do not write code yet.
Masaüstü uygulaması incelemeniz için planı barındırır. CLI'dan, bir plan görevi sonrasında farkları inceleyin.
Destekleyici bir bağlantı olmadan yapılan her türlü eşlemenin daha yakından incelenmesi gerekir. Görüntü girişi rehberi ve PDF girişi rehberi yüklemeyi ele alırken, sonuçlar rehberi çıktıyı açıklar.
Ne zaman birden fazla ajan gönderilmeli?
OCR taşımaları iki paralel göreve bölünebilir.
Agent A: migrate Capture/LegacyCaptureService.cs to IronOCR per the approved
plan. Keep the public method signatures unchanged.
Agent B: write xUnit tests for the migrated service. Assert that every page in
TestData/known/ returns its expected delivery note number and total, that
barcodes are returned when enabled, that a page without a total returns null,
and that reads below 80 confidence are flagged. Do not assert on full page
text.
Linux, Docker veya Azure'da dağıtım arızalarını nasıl ayıklarsınız?
Attach the terminal output to the Walkthrough when you are done. Reading
invoices works locally on Windows but fails in our Linux container with:
[PASTE FULL EXCEPTION AND STACK TRACE HERE]
Check which IronOCR package the project references, whether the container has
the native dependencies IronOCR needs, and whether IRONOCR_LICENSE_KEY reaches
the container. Explain the cause, then propose the change. Don't modify C#
code unless the cause is there.
Açık talimatlar olmadan, bir ajan bir catch bloğunda hataları baskılayabilir. Docker rehberi ve Azure rehberine yönlendirin.
Gerçek bir çalıştırmada istemler ne üretti?
Yapıştırılmış hataların gerekmediği yedi yönlendirme, tek bir oturumda ve bir örnek yakalama API'sine karşı Antigravity CLI'ya sırasıyla gönderildi. Uygulama bir ASP.NET Core uygulamasıdır ve bir eski Tesseract okuyucu, bilinen değerlere sahip on teslimat notu (üç dönmüş, iki benekli ve dört QR kodlu dahil), on taranmış örnek fatura ve bir Alman faturası içerir. Lisans anahtarı bir ortam değişkeni aracılığıyla sağlandı. Yürütmeden sonra, bağımsız bir yapı, test çalıştırma ve her teslimat notunun doğrulanması aşağıdaki sonuçları doğruladı.
- Bilinen notlar eski okuyucu ile 10'da 10 ve IronOCR'a geçişten sonra 10'da 10 eşleşti ve güven 76,2 ila 96,0 oldu.
- xUnit testleri 17'de 17 başarıyla geçti.
- Alman faturasında, IronOCR 3.271,07 EUR'yu 95,5 güvenle okudu.
- Örnek fatura toplamları 10'da 10 eşleşti.
- Yapılar 7'de 7 başarıyla tamamlandı, 0 hata ve hiçbir insan düzenlemesi olmadan.
- Sadece plan yönlendirmesi yine de kod yazdı ve hiç kimsenin vermediği bir onayı bildirdi.
- Barkod testleri, barkod dönmeyen benekli QR notunu sessizce atlar.
- Sayfanın aksine, oturum
--dangerously-skip-permissionsile gözetimsiz çalıştı ve iki ajansının yönlendirmesi tek bir ajan olarak çalıştı.
Antigravity'nin versiyonu, modeli ve zamanlaması ile test makinesinin, merkezin çalıştırma kaydında listelendiği gibi.
Hata Ayıklama
- Üretilen kod LicensingException fırlatırsa, IronOCR'da Lisans Anahtarı Uygula
- Bir sayfadan okunan değerler yanlışsa, OCR Doğruluğunu Artır
- Metin döndüren bir okumada barkodlar eksikse, IronOCR ile Barkodları Oku
- Linux kapsayıcısında okuma çalışmıyorsa ancak yerel olarak çalışıyorsa, Docker'da IronOCR
Sorular?
Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın
Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.