Google Antigravity와 함께 IronOCR을 사용하는 방법

Curtis Chau
Curtis Chau
업데이트됨: 2026년 10월 9일

많은 AI 코딩 도구들은 코드 컴파일에서 멈추고 코드가 작동하는지 확인하는 데 도움을 주지 않습니다. OCR에서 이러한 간극은 비용이 많이 들 수 있습니다. 예를 들어, 청구서 수입기는 오류 없이 데이터베이스를 구축하고 채울 수 있지만, 총계의 4분의 1이 오판된 숫자를 포함할 수 있으며 이는 빌드 출력에서 드러나지 않습니다.

Google Antigravity는 여러분의 검토를 위해 작업을 반환하는 에이전트를 통해 운영됩니다. IronOCR은 이미지를 .NET에서 로컬로 처리하여 텍스트, 바코드 및 표를 추출합니다. 에이전트가 테스트 페이지를 관리할 때, 페이지의 내용물을 알고, 각 페이지를 IronOCR로 읽고, 추출된 값을 알려진 값과 비교하며, 일치할 때까지 반복합니다.

이 글에서는 IronOCR에서 소프트웨어를 구축하는 데 도움을 주는 AI 코딩 도구를 다룹니다. IronOCR의 사진 및 필기 인식을 위한 자체적인 머신 러닝 기능은 별도의 주제로, 사진 읽기 가이드 및 필기 읽기 가이드가 있습니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronOcr

위 명령을 NuGet 패키지 관리자 콘솔에 입력하거나 NuGet 패키지 관리자에서 패키지를 검색하여 IronOCR를 설치하십시오.

Antigravity에서 프로젝트를 열고 예상 출력을 지정하십시오.

/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.
Text

계획은 IronOcr.Languages.German와 언어 할당을 명명해야 하며, 둘 중 하나라도 누락하면 오류입니다. 해당 언어 팩이 없으면 첫 번째 읽기에서 LanguagePackException이 발생하여 오류가 즉시 나타납니다.

라이선스 키 가이드는 IronOCR이 키를 확인하는 모든 위치를 자세히 설명합니다.



Google Antigravity가 무엇이고, 채팅 도구와 어떻게 다른가요?

정해진 목표를 가지고 Antigravity 에이전트는 계획을 수립하여 편집자, 터미널 및 브라우저에서 수행하고 채팅 수신 기록보다는 검토할 수 있는 아티팩트에서 작업 결과를 보고합니다.

지침 없이 캡처 파이프라인을 구축하는 에이전트는 찾은 첫 번째 OCR 접근 방식을 선택하거나 패키지 이름을 추측할 수 있습니다. 추측된 이름은 공격자가 해당 이름으로 사전에 게시한 counterfeit를 해결할 수 있는데, 이런 관행은 slopsquatting이라고 불립니다. Windows에는 IronOcr, Linux에는 IronOcr.Linux를 사용하세요.

AI 코딩 보조 가이드는 에이전트에게 줄 IronOCR 문서 링크를 나열하고, Antigravity에서 실행할 수 있는 단일 프롬프트 수락 테스트를 포함합니다.

에이전트는 무엇을 반환하며, 어떻게 검토하나요?

코드 이전에 구현 계획

계획은 파일, 언어 선택, 필터 및 대상 필드를 정의합니다. 범위를 확인하기 위해 검토합니다.

운영 중 코드를 차이점

코드 차이점은 계획이 어떻게 구현되었는지를 보여줍니다. 리더가 지정된 페이지를 로드하고, 약속된 필터가 적용되었으며, 사용된 모든 멤버가 API 레퍼런스에 있는지 확인하십시오.

운영 후 안내서

연습은 작업을 요약하여 변화와 결과 증거를 제공합니다.

증거는 어디서 나옵니까?

/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.
Text

하나의 스캔용 필터를 추가한 후 전체 테이블을 반복하여 다른 스캔에 영향을 주지 않았음을 확인합니다.

CLI에서, /browser 명령이 Chrome 서브에이전트를 시작했습니다.

유의 사항: Antigravity에서 생성된 스크린샷과 브라우저 녹화를 검토하세요. 에이전트가 업로드 양식을 건너뛰었다면 사용자의 워크플로우를 테스트하지 않은 것입니다.

오판된 항목, 예를 들어 자리 바뀐 숫자가 포함된 총계를 표시하려면 스크린샷에 주석을 달아야 합니다.

잘못된 OCR 값이나 누락된 값이 발생하는 원인은 무엇인가요?

대부분의 불일치는 몇 가지 공통적인 원인을 가지고 있습니다. 의심되는 원인을 지명하면 에이전트가 시행착오를 생략합니다.

  • 회전되거나 소음이 있는 페이지의 잘못된 숫자는 일반적으로 Deskew 및 DeNoise로 해결해야 합니다.
  • 텍스트를 반환하지만 바코드가 없는 경우 Configuration.ReadBarCodes를 켜야 합니다.
  • ConvertToSearchablePdf이 스캔 중에 예외를 던지면 읽기 결과에서 SaveAsSearchablePdf를 호출하세요.

Antigravity가 작업할 수 있는 프로젝트를 어떻게 설정하나요?

프로젝트를 컴파일하여 에이전트에게 제공합니다. 그렇지 않으면 에이전트는 빌드 오류에 시간을 소비합니다.

설치를 에이전트에게 위임합니다.

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.
Text

후속 작업에서 보고된 버전 번호를 사용합니다.

상시 명령 파일 AGENTS.md 또는 GEMINI.md을 프로젝트 초기에 저장소 루트에 추가합니다. OCR이 IronOCR을 사용한다고 기록합니다.

/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.
Text

우리의 실행에서, 에이전트가 기존 명령 파일에 세 가지 규칙을 추가했습니다.

추출 및 마이그레이션 작업을 어떻게 위임할 수 있나요?

필드 추출이 필요한 경우 관련 있는 페이지와 리더가 포함될 파일을 명시하세요.

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.
Text

우리의 테스트에서 리더는 각 스캔을 PDF 입력으로 로드하고 각 페이지의 '총계' 줄을 검색했습니다.

마이그레이션은 길고 반복적이며 간과하기 쉬운 엣지 케이스가 많아 위임에 적합합니다. 현재 소스 코드로 에이전트를 지정합니다.

/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.
Text

데스크톱 앱은 검토할 계획을 보유하고 있습니다. CLI에서 계획의 작업 후 차이점을 검토합니다.

지원 링크가 없는 매핑은 더 철저하게 검토해야 합니다. 이미지 입력 가이드와 PDF 입력 가이드는 로딩을 설명하고, 결과 가이드는 출력을 설명합니다.

언제 한 에이전트 이상을 파견해야 하나요?

OCR 마이그레이션은 두 개의 병렬 작업으로 나눌 수 있습니다.

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.
Text
유의 사항: 데스크톱 앱에서 두 개의 에이전트를 실행할 때, 그들의 연습을 비교하세요. 두 번째 에이전트의 테스트는 첫 번째 에이전트가 생성한 코드에 대해 실행될 때만 유효합니다. 또한, 신뢰 테스트가 낮은 판독 값을 얻는 방법을 확인하세요. 우리의 테스트에서는 얼룩스러운 노트를 읽고 값과 플래그 모두를 단언했습니다.

Linux, Docker, Azure에서의 배포 실패를 어떻게 디버그하나요?

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.
Text

명확한 지침 없이 에이전트가 catch 블록에서 실패를 억제할 수 있습니다. Docker 가이드와 Azure 가이드를 가리키십시오.

실제 실행에서 프롬프트가 무엇을 생성했습니까?

붙여넣기 된 실패를 요구하지 않은 일곱 개의 프롬프트는 샘플 캡처 API에 대해 Antigravity CLI에 단일 세션으로 연속적으로 제출되었습니다. 응용 프로그램은 ASP.NET Core 앱이며, 레거시 Tesseract 리더와 이미 알려진 값이 포함된 열 장의 전달 노트(세 장의 회전, 두 장의 얼룩, 네 장의 QR 코드 포함), 열 장의 스캔된 샘플 청구서, 한 독일어 청구서로 구성됩니다. 라이선스 키는 환경 변수로 제공되었습니다. 실행 후에는 독립적인 빌드와 테스트 실행 및 각 전달 노트의 검증이 아래의 결과를 확인했습니다.

  • 알려진 노트는 레거시 리더와의 비교에서 10개 중 10개, IronOCR로의 이동 후 10개 중 10개와 일치하며, 신뢰도는 76.2에서 96.0까지입니다.
  • xUnit 테스트는 17개 중 17개 통과되었습니다.
  • 독일어 청구서에서 IronOCR은 95.5의 신뢰도로 3,271,07 EUR을 읽었습니다.
  • 샘플 청구서 총계는 10개 중 10개와 일치했습니다.
  • 빌드가 실패 없이 0개의 오류로 7개 중 7개 성공했습니다.
  • 계획 전용 프롬프트는 어쨌든 코드를 작성하고 아무도 승인하지 않은 승인을 보고했습니다.
  • 바코드 테스트는 조용히 얼룩진 QR 노트를 건너뛰며, 이 노트는 바코드를 반환하지 않습니다.
  • 페이지와 달리 세션은 --dangerously-skip-permissions로 무인으로 실행되었고, 두 에이전트 프롬프트는 하나의 에이전트로 작동했습니다.

Antigravity의 버전, 모델 및 타이밍, 테스트 머신은 허브의 실행 기록에 나열됩니다.


문제 해결


질문?

질문이 있으시면 support@ironsoftware.com으로 문의하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 6,394,824버전:2026.11방금 출시