IronPDF를 GitHub Copilot과 함께 사용하는 방법

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

AI 지원 코딩에 대한 대부분의 가이드들은 여러분이 에디터를 변경할 의향이 있다고 가정합니다. .NET 작업의 경우 이런 가정은 종종 틀립니다. Visual Studio에서 작업하는 IronPDF 프로젝트는 프로젝트 참조, NuGet 구성, 그리고 빌드 파이프라인을 포함한 솔루션 내에 있으며, 이들이 보조기능을 시도해 보기 위해 옮겨가길 원하는 사람은 없다.

GitHub Copilot은 이러한 프로젝트가 이미 존재하는 곳, 즉 Visual Studio, VS Code 및 JetBrains IDE에서 실행되므로 이 워크플로우에는 마이그레이션이 필요 없습니다. 또한, 이는 단순한 에디터 전용 도우미로는 할 수 없는 일을 수행합니다: GitHub 자체 내에서 실행됩니다. PDF 문제를 문제로 설명하고 이것을 Copilot의 클라우드 에이전트에게 할당하면 풀 요청을 받을 수 있습니다. IronPDF는 HTML, CSS, 그리고 JavaScript를 내장된 Chromium 엔진을 통해 PDF로 렌더링하며, 두 제품 간에는 통합이 없습니다. 이들을 연결하는 것은 저장소이며, 여기 커밋 한 규칙들입니다.

먼저 구분해야 할 한 가지는 두 가지 유사한 주제가 경쟁하고 있다는 것입니다. 이 가이드는 IronPDF와 함께 소프트웨어를 구축하는 AI 코딩 도우미 사용에 관한 것입니다. AI 모델을 사용해 PDF 콘텐츠를 읽거나 분석하는 것이 아니라는 점은 AI 기반 PDF 처리 튜토리얼에서 따로 다루고 있습니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronPdf

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

이미 존재하는 IDE에서 솔루션을 열고 문서를 요청하세요:

In this C# console project, create Program.cs that uses IronPDF to render
"<h1>Hello from IronPDF</h1>" to hello.pdf. Read the license key from the
IRONPDF_LICENSE_KEY environment variable, never inline. Then build and fix
any errors.
Text

Copilot은 중요한 몇 줄을 작성하여 ChromePdfRenderer을 구성하고, RenderHtmlAsPdf을 호출하며, SaveAs로 결과를 저장합니다. 이 부분은 주목할 만한 것이 아니며, 이 가이드가 존재하는 이유가 아닙니다. 다음이 중요합니다: 같은 도우미가 아무도 보지 않는 상태에서, 브랜치에서, 풀 리퀘스트로 이 작업을 수행하며, 이는 설정해야 할 것을 변화시킵니다.

안전 주의사항 두 가지, 모두 짧습니다. 라이선스 키는 프롬프트나 커밋에 인라인으로 포함되지 않습니다; 이는 구성에서 살고 있으며, 라이선스 키 가이드에 설명되어 있거나 환경 변수 또는 저장소 비밀로 존재합니다. 저장소 쓰기 권한이 있는 에이전트는 실제 풀 리퀘스트를 열기 때문에, 브랜치 보호와 사람의 검토가 중요합니다.



Copilot이 Visual Studio에 이미 있는 프로젝트에 맞는 곳은 어디입니까?

Copilot은 세 가지 범위에서 작동하며, 적절한 범위를 선택하면 다른 프롬프트 기술보다 더 많은 시간을 절약합니다.

인라인 완료 및 채팅은 한 문장으로 설명할 수 있으며, 단일 파일 내에서 실행되는 모든 작업을 처리합니다: 여백 조정, 기존 렌더러 호출에 푸터 추가, 헬퍼 이름 바꾸기 등을 처리합니다. 변경 사항을 설명하면, 차이점을 얻고, 수락하거나 거절할 수 있습니다.

에이전트 모드는 여러 파일에 걸친 작업을 처리하며, Copilot이 어떤 파일을 편집할지 결정하고, 터미널 명령을 실행하며, 출력을 읽고, 오류에 대해 반복합니다. 이는 마이그레이션이나 리팩터링을 위한 올바른 범위입니다.

GitHub의 클라우드 에이전트는 전혀 감독이 필요 없는 작업을 처리합니다. 이슈를 할당하고, 계획을 세우고, 브랜치를 푸시하고, 풀 리퀘스트를 엽니다. 이것이 Copilot이 에디터에만 종속된 도우미와 다른 점이며, 본 가이드에서 나머지 부분을 다룰 것입니다.

Copilot은 합리적인 독자이기도 합니다. 렌더링 옵션 유형을 설명하고 현재 프로젝트가 설정한 옵션을 묻는 것은 API 레퍼런스를 스크롤하지 않고 쿼리할 수 있는 것으로 바꿉니다.

세 가지 범위는 각각 다른 폭발 반경을 가집니다.

유의 사항: 인라인 수정은 반영되기 전에 검토되고, 에이전트 모드는 차이점으로 검토되며, 클라우드 에이전트의 작업은 당일 아무도 읽기 전에 풀 요청으로 도착할 수 있습니다. 범위가 종료될 때 얼마나 많이 보유하고 싶은지 범위를 맞추십시오.

모든 표면이 따르는 관례는 어떻게 커밋합니까?

저장소의 사용자 지정 지침이 저장소에 커밋되면, 이는 IDE 채팅과 에이전트가 아무도 보지 않는 상황에서도 동일하게 통치합니다. 한 번만 작성하고 프롬프트에서 반복하지 마세요.

파일은 .github/copilot-instructions.md입니다. .NET 팀에게는 이것이 표준화할 가치가 있는 형식입니다. 이는 Visual Studio가 문서화하고 있는 방식이기 때문이며, VS Code, JetBrains, 클라우드 에이전트 및 Copilot 코드 리뷰와 함께 제공합니다. Copilot은 AGENTS.md 등 다른 지침 파일도 읽지만, 이는 사용 환경별 지원이 각 릴리스마다 달라지므로 Visual Studio 상점의 안전한 기본 설정은 제품 이름으로 된 파일입니다.

# Copilot instructions

## PDF generation

- Use IronPDF for all PDF generation. Use ChromePdfRenderer for HTML conversion.
- Target the IronPDF version pinned in Directory.Packages.props. Do not upgrade
  it as part of an unrelated change.
- Never inline a license key. Read it from configuration or the
  IRONPDF_LICENSE_KEY environment variable.
- Prefer the shared PdfDocumentService helper over constructing a renderer per
  call. A ChromePdfRenderer instance is reusable.
- Use the async rendering methods in web request paths.
- Do not invent IronPDF API names. If a method is uncertain, say so and cite the
  documentation rather than guessing.

## Testing

- Assert on extracted text, page count and the %PDF- signature.
- Never use golden-file byte comparisons; rendering output is not byte-stable.
Text

불확실성을 인정하는 줄은 그 자리를 얻습니다. 모델의 기본값은 격차를 인정하기보다는 믿을 만한 형태를 생성하는 것이며, renderer.ConvertHtmlToPdfDocument()을 발명하는 것은 컴파일러가 불동의할 때까지 잘 이해됩니다. 멈추도록 허락하는 것은 비용이 적게 들고 효과가 있습니다.

.github/instructions/**/*.instructions.md에 있는 경로별 지침은 매칭 파일에 대한 지침을 제공하여 PDF와 관련 없는 요청에서 PDF 규칙을 제외시킵니다.

에이전트가 실제로 작용할 수 있는 이슈는 무엇입니까?

여기서 중요한 기술은 프롬프트 작성이 아닙니다. 이는 문제 작성입니다. GitHub에 따르면, 에이전트는 문제의 제목, 설명 및 기존 댓글에서 작업하며, 할당 후 추가된 댓글을 보지 않습니다. 이를 명확히 할 사람이 없습니다.

약한 이슈는 이와 같이 보입니다:

Title: PDF looks wrong

The invoice PDF doesn't look right. Can we fix the layout?
Text

에이전트는 열 파일이 없고, 여러 PDFs 중 어느 것을 의미하는지 모르게 되며, 올바른 출력에 대한 설명이 없고, 작업할 수 있는 오류도 없습니다. 탐색하고, 추측하고, 전혀 잘못된 것을 다룰 수 있는 풀 리퀘스트를 생성할지도 모릅니다.

강력한 이슈에는 동료가 필요로 할 모든 것이 담겨 있습니다:

Title: Invoice PDF splits table rows across pages and drops the logo

**Files:** Services/InvoiceRenderer.cs, Templates/invoice.html
**IronPDF version:** as pinned in Directory.Packages.props
**Framework:** .NET 8

**Expected:** A4 portrait, 20mm margins. Line-item table rows stay intact
across page breaks. Company logo renders in the header.

**Actual:** A table row splits between pages 1 and 2. The logo area is blank
in the PDF but renders correctly when Templates/invoice.html is opened in
Chrome. No exception is thrown.

**Constraints:** Fix page-break behavior in CSS, not in C#. Keep the public
signature of InvoiceRenderer.RenderAsync unchanged. No new packages.

**Acceptance:** Existing tests pass, plus a new test asserting page count for
the fixture in TestData/invoice-12-items.json.
Text

두 번째와 첫 번째를 구분하는 여섯 가지가 있습니다: 명명된 파일, 프레임워크 및 라이브러리 버전, 구체적으로 진술된 예상 출력, 발생하지 않는 실제 동작, 강한 제약사항, 완료 정의입니다.

예외가 던져지지 않는다는 디테일은 실제로 작업을 수행합니다. 이는 이 문제가 충돌이 아니라 렌더링 문제임을 에이전트에게 알려주며, 이는 시작하기 전에 전체 조사의 범주를 제외합니다. Chrome에서 로고가 렌더링되지만 PDF에서는 그렇지 않다는 관찰은 이를 더욱 구체적으로 만듭니다. HTML 문자열은 문서 위치를 담고 있지 않기 때문에, 상대 이미지 경로는 템플릿의 폴더 대신 작업 디렉토리를 기준으로 해결되며, 브라우저는 페이지의 출처를 압니다.

지정된 후에 에이전트는 계획하고, 브랜치를 푸시하고, 풀 리퀘스트를 열고, 검토를 요청합니다. 작업을 보는 대신 차이점을 검토하세요.

왜 에이전트의 테스트가 IronPDF 프로젝트에서 실패합니까?

일반 Copilot 가이드에서는 작성되지 않을 섹션이며, 특히 오후를 절약하는 데 가장 도움이 되는 섹션입니다.

클라우드 에이전트는 자체 휘발성 환경에서 빌드하고 테스트합니다. 대부분의 프로젝트는 소스 플러스 패키지 복구만으로 충분합니다. IronPDF 프로젝트는 더 많은 것이 필요합니다, 왜냐하면 렌더링은 네이티브 플랫폼 종속성을 가진 Chromium 엔진에 의존하기 때문입니다. 에이전트의 Linux 러너에서 부재하면, PDF를 렌더링하는 모든 테스트는 실패합니다, 이는 에이전트가 방금 작성한 코드와 관련이 없는 이유로.

결과는 붉은색 빌드보다 나쁩니다. 의존성을 찾아 설치하는 것을 자체적으로 처리하려면 에이전트는 시도와 오류에 따라 작동하며, 이 방법은 GitHub의 문서에 따르면 느리고 신뢰할 수 없습니다.

이는 환경을 .github/workflows/copilot-setup-steps.yml으로 미리 구성하는 것입니다. 이는 일반 GitHub Actions 워크플로우처럼 보이지만 두 가지 쉽게 놓칠 수 있는 규칙이 있습니다: 작업 이름은 copilot-setup-steps이어야 하고, 파일은 저장소의 기본 브랜치에 존재하지 않으면 전혀 실행되지 않습니다.

name: "Copilot Setup Steps"
on:
  workflow_dispatch:
  push:
    paths:
      - .github/workflows/copilot-setup-steps.yml
  pull_request:
    paths:
      - .github/workflows/copilot-setup-steps.yml

jobs:
  # The job MUST be called `copilot-setup-steps` or Copilot will not pick it up.
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        with:
          dotnet-version: '8.0.x'
      # Install the native dependencies IronPDF's Chromium engine needs on
      # Debian-based images. Take the current package list from the Docker
      # and Linux deployment guide rather than copying one from anywhere else,
      # because it changes between releases.
      - name: Install IronPDF native dependencies
        run: |
          sudo apt-get update
          sudo apt-get install -y <packages from the IronPDF Linux guide>
      - run: dotnet restore
Text

이것이 작동하는지에 대한 두 가지 세부사항이 결정합니다.

첫째, 라이선스 키는 에이전트에게 자동으로 제공되지 않습니다. GitHub Actions, Codespaces 및 Dependabot 비밀은 에이전트 세션에서 사용할 수 없으므로, 키를 저장소 또는 조직 설정에서 에이전트 비밀로 별도로 추가해야 합니다.

둘째, 그리고 이는 혼란스러운 증상을 만들어 내는 것입니다: 설정 단계가 실패하면 Copilot은 멈추지 않습니다. 남은 단계를 건너뛰고 환경의 상태대로 작업하기 시작합니다. 조용히 실패한 종속성 설치는 결과적으로 코드 문제와 정확히 같아 보입니다. 의존하기 전에 작업 탭에서 워크플로우를 한 번 수동으로 실행하세요.

팁: 실용적인 규칙: IronPDF 프로젝트에서 클라우드 에이전트의 풀 요청이 실패하는 렌더 테스트를 가지고 있을 때는 환경을 확인하십시오; 변경 사항이 잘못되었다고 가정하기 전에. Docker 배포 가이드는 릴리스마다 변경되는 종속성을 문서화하므로 기억하는 것이 아니라 읽어야 합니다.

병합 전에 무엇을 확인해야 합니까?

풀 리퀘스트는 검토 표면이며, 다른 동료의 브랜치와 동일한 표준이 적용됩니다. Copilot 자체의 코드 리뷰는 에이전트의 출력을 신고하는 2차 과정으로 작동할 수 있으며, 사람이 차이점을 읽기 전에 기계적 문제를 잡습니다.

IronPDF 변경사항에 대해 특히 중요한 세 가지 검사사항:

  1. 모든 API 이름이 문서에 나타납니까, 아니면 그럴듯한 것이 누락되었습니까?
  2. 생성된 PDF가 실제로 올바르게 보이나요? 클린 빌드는 레이아웃에 대해 아무것도 나타내지 않습니다.
  3. 변경 사항이 문제에서 설정한 제약조건 내에 머물렀나요?

동일한 풀 리퀘스트에 테스트를 요청하는 것은 표준으로 만드는 가치가 있습니다:

Add xUnit tests for this change: output is non-empty, begins with the %PDF-
signature, extracted text contains the bound company name, and page count
matches the fixture. No golden-file byte comparisons.
Text

바이트 비교를 배제하는 것은 두 개의 별도 프로세스에서 동일한 HTML을 두 번 렌더링할 때 타임스탬프나 문서 ID가 달라서 망가지는 클래스를 예방할 수 있습니다.

코드 때문인가요, 컨테이너 때문인가요?

브라우저와 PDF 간의 렌더링 차이의 문서화된 세 가지 원인은 인쇄 미디어가 아닌 스크린을 위해 작성된 스타일시트, 레이아웃이 계산될 때 로드되지 않은 웹 폰트, 너무 일찍 캡처된 JavaScript 생성 콘텐츠입니다. 이 모든 것은 코드 측에 있으며, 요청에 명명할 가치가 있습니다:

Templates/report.html renders correctly in Chrome but the PDF splits a table
row across pages and the totals block lands on the next page alone.

Explain the cause before changing anything, then fix it in the CSS using page
break properties. Do not modify ReportRenderer.cs.
Text

변경 전 진단을 요청하면 여러분은 역설계할 수 있는 수정이 아닌 평가할 수 있는 무언가를 얻습니다. 페이지 차단 행동은 스타일시트에 있어야 하며, 페이지 차단 가이드가 관련 속성을 다룹니다. 변경을 CSS에 제한하면 에이전트가 C#를 재구성하여 레이아웃 문제를 해결하지 않도록 합니다.

질문의 다른 절반은 이전 섹션이 대답한 것입니다: 같은 코드가 로컬에서 렌더링되고 컨테이너 또는 러너에서 실패하는 경우, 일반적으로 코드 때문이 아닙니다. 예외 전체를 붙여넣어 구문해석을 하지 말고, 애플리케이션이 아닌 Dockerfile을 요청에 지적하세요. 누락된 공유 라이브러리는 C# 문제와 관련이 없습니다.

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

이 페이지의 세 가지 프롬프트와 두 개의 문제 내용이 순서대로, 무인 상태에서, GitHub Copilot CLI 1.0.95로 실행되었으며, 이는 모든 회전을 GPT-6 Luna에게로 라우팅했습니다. 지침 파일과 설정 단계 워크플로우는 작성된 대로 커밋되었습니다. 다음 그림은 실행이 남긴 파일들에 대한 독립적인 체크에서 가져왔습니다.

  • 빠른 시작 프롬프트는 IRONPDF_LICENSE_KEY에서 키를 읽고 오류나 경고 없이 빌드된 13줄짜리 Program.cs를 생성했습니다.
  • 에이전트는 프로그램을 실행하지 않았습니다.
  • 키를 사용하여 실행한 프로그램은 17,385 바이트의 한 페이지짜리 hello.pdf를 저장했습니다.
  • 문제들이 실행되기 전에 청구서는 1페이지와 2페이지 사이에 한 항목이 나뉘었고, 이미지가 없었습니다.
  • 강한 문제는 모든 항목이 온전히 보이는 두 페이지짜리 청구서를 생성했고, 로고는 1페이지에 있었습니다.
  • 에이전트는 C#에서 로고를 데이터 URI로 내장하고 CSS의 페이지 구분을 수정했습니다.
  • InvoiceRenderer.RenderAsync의 공개 서명은 변경되지 않았고, 패키지는 추가되지 않았습니다.
  • 새로운 테스트는 12개 항목 픽스처에 대해서 두 페이지를 주장했으며, 모든 테스트가 통과했습니다.
  • 에이전트는 테이블 헤더를 반복하라는 규칙을 추가했고, 이를 보고했습니다. 렌더링된 청구서의 2페이지에는 헤더 행이 포함되어 있지 않았습니다.
  • 약한 문제도 두 가지 결함을 수정했습니다. 비록 파일 이름이나 특정 증상은 언급되지 않았지만 말입니다.
  • 동일한 변경 사항이 스타일시트를 전체적으로 다시 작성하고 본문 텍스트를 13픽셀에서 11픽셀로 줄였습니다.
  • 테스트 프롬프트는 빈 체크와 회사 이름 체크를 기존 테스트에 추가하여, 수는 여전히 3개로 유지되었고, 바이트 비교는 전혀 이루어지지 않았습니다.
  • 보고서 프롬프트는 CSS를 수정하기 전에 합계 앞의 강제 페이지 구분과 누락된 행 규칙을 작성했습니다.
  • 수정된 보고서는 3페이지 대신 2페이지에 적합하게 되어, 분할 행이 없고 총합은 마지막 네 사이트 아래에 있었습니다. ReportRenderer.cs는 변경되지 않았습니다.
  • 에이전트는 환경 변수를 결코 나열하지 않았으며, 키는 아무 대본, 커밋 및 Copilot 세션 파일에서도 나타나지 않았습니다.
  • 일부 단계는 페이지와 달리 작동했습니다. 저장소는 GitHub 원격이 없어서 CLI가 클라우드 에이전트를 대신했으며, 각 문제는 새로운 세션을 시작했습니다. 테스트 요청은 풀 요청 댓글 대신 강한 문제의 세션으로 갔습니다. 설정 단계 워크플로우는 이 기기에 GitHub Actions 러너 및 Linux 환경이 없기 때문에 실행되지 않았습니다.

강한 문제후 청구서는 실행의 InvoiceRenderer에 의해 12개 항목 픽스처에서 렌더링되었습니다.

보고서 프롬프트의 CSS 수정 후 보고서는 실행의 ReportRenderer에 의해 렌더링되었습니다.

이 실행을 위한 Copilot CLI 버전, 모델 및 타이밍은 실행 기록에 나열되어 있습니다.

아무도 지켜보지 않을 때 무엇이 계속 작동합니까?

두 가지, 그리고 이들은 먼저 설정할 가치가 있는 두 가지입니다. .github/copilot-instructions.md에 커밋된 지침은 자정에 있는 브랜치의 에이전트를 정오의 IDE와 동일하게 통치합니다. IronPDF의 기본 종속성을 설치하는 copilot-setup-steps.yml은 그 동일한 에이전트를 시도와 오류를 통해 종속성을 찾고 설치하는 것으로부터 구합니다. 다른 모든 것은 그 두 가지가 존재할 때 더 잘 작동하는 일반적인 도우미 사용법입니다.

확인 습관은 범위에 따라 달라지지 않습니다: 일찍 빌드하고, PDF를 열고, 문서에 대한 API 이름을.ship 전에 확인하세요. 그 검사의 재현 가능한 버전은 출판된 결과와 함께 처음부터 끝까지 실행되며, AI 코딩 도우미 가이드에, Claude Code, ChatGPT Codex 및 Cursor에 대한 가이드와 함께 포함되어 있습니다.


문제 해결


질문?

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

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

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 22,198,312버전:2026.11방금 출시