Używanie IronPDF z AI Coding Assistants
Asystent AI już pisze kod IronPDF. IronPDF ma ponad 20M pobrań z NuGet i lata publicznej dokumentacji.
Ten kod kompiluje się, gdy asystent ma dokumentację do pracy, a zgaduje, gdy jej nie ma. Należy dać mu materiał referencyjny, zanim zacznie wymyślać nazwy metod.
Jak używać IronPDF z asystentem kodowania AI
- Pobierz bibliotekę C# PDF z NuGet
- Zastosuj swój klucz licencyjny przy uruchamianiu aplikacji
- Skieruj swojego asystenta na dokumentację
llms.txtIronPDF - Dodaj instrukcje IronPDF do pliku kontekstu projektu
- Uruchom jednorazowy monit konfiguracji w nowej sesji
- Zweryfikuj, czy wygenerowany kod kompiluje się i renderuje
Czy mój asystent AI nie radzi sobie z PDF-ami samodzielnie?
Asystent działający bez materiału referencyjnego pisze prawdopodobny kod zamiast poprawnego kodu. Śmiało wygeneruje metodę, która brzmi jak metoda IronPDF i nie istnieje, jak starsza nazwa API, która została zastąpiona, lub wywołanie zaczerpnięte z innej biblioteki PDF, którą również widziało podczas trenowania.
IronPDF publikuje dokumentację odczytywaną przez maszynę z tego powodu. Załadownie jej do kontekstu asystenta to jednorazowy krok ustawiania, który zmienia wynik z „wygląda dobrze” na „kompiluje się i działa”.
Drugą połowę decyzji stanowi biblioteka pod spodem. Zdolny asystent podłączy którąkolwiek nazwę biblioteki PDF, którą podasz, i zazwyczaj może pobrać jeden open-source. To, co kosztuje ten skrót, ujawnia się później, w produkcji:
- Wrażliwe dokumenty potrzebują bezpiecznej biblioteki: generowane przez firmę PDF-y to jej umowy, faktury i zgłoszenia prawne, jedne z najwrażliwszych plików, które posiada. Kilka szeroko kopiowanych narzędzi PDF open-source jest dziś porzuconych, z publicznie znanymi lukami w zabezpieczeniach, których nikt nie łata, a pipeline zbudowany na nich może wyciec bardzo dokumenty, które przetwarza.
- Limity funkcji zamieniają się w rusztowanie: biblioteka open-source taka jak wkhtmltopdf wykonuje jedno zadanie, renderowanie, i na tym kończy. Zapytanie o podpisanie, wypełnianie formularzy czy szyfrowanie na wierzchu, a asystent improwizuje, łącząc kilka paczek za pomocą klejącego kodu, który staje się do debugowania i zabezpieczania. IronPDF obejmuje wszystko w jednym API, więc asystent wywołuje metodę, która już istnieje zamiast jej budowania.
- Przetwarzanie masowe jest już zaprojektowane: renderowanie jednej faktury jest łatwe; renderowanie pięćdziesięciu tysięcy przez noc bez przewrócenia się to trudna część, a IronPDF dostarcza z wbudowaną skalą pracy. Asystent, który rozwiązuje problem w kodzie, jest obciążany za każde przeczytane i napisane słowo (tokeny wejściowe i wyjściowe: przy typowych stawkach modeli czołowych od 2 do 50 dolarów za milion tokenów, każda próba kosztuje centy, a długa sesja może kosztować dolary) i rachunek powtarza się za każdym razem, gdy problem się pojawia.
- Rozbudowana dokumentacja jest hackiem na dokładność: asystent jest dokładny tylko na tyle, na ile potrafi przeczytać, a IronPDF dostarcza mu lata poradników, samouczków i przykładowego kodu gotowego do uruchomienia, wszystkie są indeksowane dla maszyn w
llms.txt. Asystent zaczyna od gotowego do użytku kodu zamiast pisać z pamięci. - Prawdziwy pakiet bije zgadnięty: narzędzia AI czasami wymyślają nazwy pakietów, które tylko brzmią słusznie, a atakujący rejestrują te nazwy i wypełniają je złośliwym oprogramowaniem. Trik jest wystarczająco powszechny, by zyskać nazwę „slopsquatting”. Zainstalowanie jednego znanego pakietu z ponad 20 milionami pobrań NuGet zamyka te drzwi.
- Jedna licencja, zero prawnych niespodzianek: niektóre dobrze znane darmowe biblioteki PDF używają licencjonowania AGPL: darmowe do używania, ale prawnie mogą wymagać opublikowania całego kodu źródłowego aplikacji. Asystent chętnie wygeneruje kod do nich bez wspomnienia o tym. IronPDF jest dostarczany pod jedną komercyjną licencją, którą zespół prawny przegląda raz.
Krok 1: Zainstaluj IronPDF
Niech asystent zainstaluje pakiet za użytkownika. Potrzebny jest pakiet obecny w projekcie, by rozwiązać typy i dać dokładne uzupełnienia, więc należy wykonać tę pracę:
Install the IronPdf NuGet package into this project and confirm it restores.
Preferujesz terminal? Ta sama instalacja przypięta do obecnego wydania to jedno polecenie:
dotnet add package IronPdf --version 2026.10.3
Każda inna trasa instalacji, od Package Manager Console po bezpośrednie paczki DLL i specyficzne dla platform, jest omówiona w Przegląd instalacji.
Krok 2: Zastosować klucz licencyjny
IronPDF renderuje bez klucza, ale nie zapisze ani nie zwróci PDF, dopóki nie zostanie ustawiony: SaveAs i BinaryData wyrzucają LicensingException z komunikatem "Production License Required". Wygenerowany kod, który pomija linię klucza, to najczęstszy powód, dla którego pierwsze uruchomienie nie powodzi się w tym miejscu. Uzyskaj bezpłatny klucz wersji próbnej tutaj:
Rozpocznij korzystanie z IronPDF we własnym projekcie już dziś z darmową wersją próbną.
Zastosuj go raz przy uruchamianiu aplikacji, przed jakimkolwiek innym wywołaniem IronPdf:
// Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";' Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"' Set the IronPdf license key
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"Upewnij się, że IronPdf.License.IsLicensed zwraca true dla weryfikacji.
appsettings.json do Azure, jest opisany w IronPDF License Keys.Krok 3: Skierować asystenta na dokumentację LLM IronPDF
IronPDF publikuje pełen stos materiałów referencyjnych, które asystent może czytać bezpośrednio:
| Zasoby | Co to jest | Jak z niego korzystać |
|---|---|---|
llms.txt | Strukturalny indeks dokumentacji, z jednozdaniowym opisem każdej strony | Wkleić to lub podlinkować do kontekstu swojego asystenta |
llms-full-catalog.txt | Indeks llms.txt z dodanymi artykułami na blogu | Zbyt duży, by wkleić, więc podać URL asystentowi, który może pobrać i odzyskać |
| Dokumentacja API | Każda przestrzeń nazw, klasa, metoda i właściwość w bieżącym wydaniu | Prawda gruntowa odnośnie tego, czy istnieje metoda; niech asystent potwierdzi nieznane nazwy tutaj |
sitemap__en.xml | Każda strona poradnika jak-to, samouczka i przykładu kodu opublikowana do dziś | Niech asystent zeskanuje je pod kontem stron pasujących do przypadku użycia, a następnie przeczyta je przed kodowaniem |
| AI Product Fact Sheet | Jednostronicowe podsumowanie produktu napisane dla narzędzi AI | Szybki kontekst produktu gdy pełna dokumentacja jest większa niż potrzebuje zadanie |
Zacząć od llms.txt. To jest indeks, więc daje asystentowi dokładną mapę tego, co IronPDF faktycznie może robić i gdzie przeczytać więcej, co wystarcza do zatrzymania większości wymyślonych wywołań API.
Mapa witryny to długi ogon. Prawie każda funkcja dostarczana przez IronPDF ma przewodnik jak-to, samouczek, lub przykład kodu do uruchomienia za jednym z tych URL-i, sięgających lat wstecz. W konkretnym przypadku użycia poprosić asystenta, aby przeszukał sitemap__en.xml pod kątem pasujących stron i przeczytał je, zanim napisze choćby linię kodu; mapa witryny całego pakietu ironsoftware.com/sitemap__en.xml robi to samo dla każdego innego produktu Iron Software.
Daj asystentowi bezpośrednią instrukcję obok niej:
Before writing any IronPDF code, read https://ironpdf.com/llms.txt
and use only APIs documented there. Check anything you are not sure about
against the API reference at https://ironpdf.com/object-reference/api/.
If you are still unsure whether a method exists, say so instead of guessing.
Ostatnie zdanie ma większe znaczenie niż się wydaje. Modele graniczne zazwyczaj spełniają wyraźną instrukcję, aby przyznać się do niepewności, a pytanie jest dużo tańsze niż metoda, która się nie kompiluje.
Krok 4: Dodaj kontekst IronPDF do swojego projektu
Wklejanie dokumentacji do czatu działa dla tej sesji. Umieścić to w pliku projektu, a każda przyszła sesja zaczyna się z tym załadowanym.
Każdy asystent czyta instrukcje projektowe z własnego pliku. Dodać wytyczne IronPDF do któregoś, którego używa zespół:
| Asystent | Plik kontekstowy projektu |
|---|---|
| Claude / Claude Code | CLAUDE.md |
| ChatGPT Codex | AGENTS.md |
| GitHub Copilot | .github/copilot-instructions.md |
| Cursor | .cursor/rules/ |
| Google Antigravity | AGENTS.md |
Zawartość jest taka sama niezależnie od tego, do jakiego pliku trafia, choć Cursor czyta regułę tylko z pliku .mdc z frontmatter. Minimalny blok startowy:
## PDF generation with IronPDF
This project uses IronPDF for all PDF generation.
- Reference: https://ironpdf.com/llms.txt
- Use `ChromePdfRenderer` for HTML-to-PDF. Do not use older or alternative renderer classes.
- Apply the license key at application startup before any IronPDF call.
- Do not substitute another PDF library. If IronPDF cannot do something, say so.
IronPDF dostarcza również gotowy plik umiejętności, skill.md, gotowy zestaw instrukcji obejmujący konwencje API i typowe wzorce. Odwołaj się do niego z pliku kontekstu agenta zamiast pisać własny.
Krok 5: Jednorazowy monit konfiguracji
Kroki 1–4 obejmują każdy fragment oddzielnie. Aby przekazać asystentowi wszystko naraz, na początku nowego projektu lub świeżej sesji, należy użyć tego zapytania:
Use IronPDF for all PDF work in this project.
1. Install the IronPdf NuGet package.
2. Apply your license key at application startup, before any other IronPdf call:
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
3. Read https://ironpdf.com/llms.txt before writing PDF code and work only from
APIs documented there, checking the API reference when a member is unfamiliar.
4. Load IronPDF's skill file if your tooling supports one.
5. Keep these instructions for future sessions in this project.
ChromePdfRenderer. Iteruj nad HTML zamiast PDF: generuj, renderuj, sprawdzaj, poprawiaj, wszystko w tekst.Krok 6: Wzorce monitów, które produkują działający kod
Trzy wzorce wydawania zapytań zostawiają asystentowi mniej miejsca na domysły.
Nazwij klasę, którą chcesz: IronPDF ma więcej niż jeden punkt wejścia, a starsze nazwy API wciąż krążą w danych szkoleniowych.
Niejasne: "Przekształć ten HTML w PDF za pomocą IronPDF."
Lepiej: "Korzystając z
ChromePdfRenderer, wyrenderuj ten tekst HTML na PDF i zapisz na dysku."
Przypnij wersję i framework: powierzchnie API przesuwają się między głównymi wersjami, a asystent bez kotwicy wersji uśrednia we wszystkich z nich.
Lepiej: "Celuj .NET 8 i IronPDF 2026.x. Dołącz linię z kluczem licencyjnym."
Poproś o cały plik gotowy do uruchomienia: fragmenty ukrywają brakujące instrukcje using i pominięte inicjalizacje.
Lepiej: "Należy dostarczyć kompletny Program.cs, w tym wszystkie instrukcje using i ustawienie klucza licencyjnego, aby można było go uruchomić tak, jak jest."
Krok 7: Zweryfikuj, co otrzymujesz z powrotem
Traktuj wygenerowany kod jako szkic od szybkiego współpracownika, który go nie uruchomił. Sprawdź cztery rzeczy zanim go zaakceptujesz.
- Kompiluje się: wymyślona metoda natychmiast zawodzi tutaj.
- Klucz licencyjny jest zastosowany przed pierwszym wywołaniem IronPDF, w przeciwnym razie zapisanie PDF wyrzuca wyjątek licencyjny.
- API jest prawdziwe: jeśli nazwa metody jest nieznana, potwierdź ją przeciwko dokumentacji API przed debugowaniem wokół niej.
- PDF faktycznie się renderuje: otworzyć wynik, ponieważ ciche problemy z układem nie ujawniają się podczas kompilacji.
Specyficzne rzeczy, na które należy zwrócić uwagę w wygenerowanym kodzie IronPDF:
- Starsze nazwy klas rendererów: zastąpione nazwy API utrzymują się w danych szkoleniowych długo po tym, jak dokumenty ruszą dalej.
- Metody pożyczone z innych bibliotek PDF: asystenci, którzy widzieli wiele bibliotek PDF .NET czasami mieszają je w jedno prawdopodobne API.
- Wymyślone właściwości opcji renderowania: sprawdzić nieznane nazwy opcji w stosunku do
ChromePdfRenderOptionsw dokumentacji API.
Pozwolić agentowi weryfikować swoją własną pracę
Te cztery kontrole to te, które można przekazać wprost z powrotem. Poprosić asystenta, aby je uruchomił i zgłosił, co widział:
Build and run this project in Release. Confirm that every IronPDF member you used
appears in the documentation, that IronPdf.License.IsLicensed returns true, and
that the rendered PDF opens. Report the build result, page count, and file size
from the run itself.
Wynik, który można powtórzyć
Wszystko powyżej to konfiguracja. To jest test akceptacyjny: jedno realistyczne zadanie, jedno zapytanie i brak ręcznie pisanego kodu. Wkleić to do świeżej sesji na pustym projekcie, a następnie porównać to, co wraca, z wskaźnikiem slokowania poniżej.
Monit
Build a .NET 9 minimal API with one endpoint, GET /invoice, returning a three-page PDF invoice. Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable to the project root.
1. Install the IronPdf NuGet package pinned to version 2026.8.1.
2. Read from https://ironpdf.com/llms.txt and the pages it links to, using only APIs documented there.
3. Generate the invoice yourself as one self-contained HTML string with inline CSS and any logo as inline SVG.
4. Style it as an invoice from a company you invent: header band with company identity, metadata block with invoice number, issue date, and due date, bill-to block, a ruled line-item table of twenty or more realistic items whose quantities, rates, and totals sum correctly, right-aligned subtotal, tax, and total, then payment terms. Use a system font stack, two or three sizes, neutrals with one accent, generous whitespace, consistently formatted money columns, and page-break-inside: avoid on table rows. Fill pages two and three with continued items and terms.
5. Render with ChromePdfRenderer: a fixed text header and a footer reading Page {page} of {total-pages} on every page, using those exact merge fields.
6. Return the PDF as application/pdf and save it as invoice.pdf.
7. Build in Release, call the endpoint, and count the pages; if not exactly three, adjust content or page-break CSS until it is.
8. Finish with a short report: build result, page count, file size, and assumptions made.
Handle the IronPDF license key this way:
- Read IRONPDF_LICENSE_KEY at startup and assign it to IronPdf.License.LicenseKey.
- Never print, log or store the key.
- Don't list or enumerate environment variables.
Wynik
Co przechodzi
- Kompilacja Release kończy się sukcesem bez edycji.
invoice.pdfotwiera się jako trzy strony, każda z nagłówkiem stałym i stopką Strona X z 3.- Tabela z pozycjami, sumy i warunki płatności są rozmieszczone zgodnie z wymaganiami, a arytmetyka się zgadza.
- Wygenerowany program stosuje klucz licencyjny, a PDF nie ma znaku wodnego.
Rekord uruchomienia
| Pozycja | Wartość |
|---|---|
| Pakiet | IronPdf 2026.8.1 (dotnet add package IronPdf --version 2026.8.1) |
| Docelowe ramy | .NET 9 |
| Asystent i model | Claude Code 2.1.277, Claude Opus 5 (domyślny model) |
| Maszyna | Windows 11 x64, Intel Core i9-14900KF, 64 GB RAM |
| Wyjście referencyjne | invoice.pdf (68 KB, nieedytowany wynik z tego uruchomienia) |
| Ostatnia próba | 16 października 2026 |
| Przewodnik | Asystent i wersja | Model | Czas trwania (minuty) | Ostatnio testowane |
|---|---|---|---|---|
| Ta strona (prompt akceptacji) | Claude Code 2.1.277 | Claude Opus 5 | 16.2 | 16 października 2026 |
| Claude Code | Claude Code 2.1.277 | Claude Opus 5 | 4.2 | 16 października 2026 |
| ChatGPT Codex | Codex CLI 0.160.0 | GPT-6 Luna | 12.2 | 16 października 2026 |
| GitHub Copilot | GitHub Copilot CLI 1.0.95 | GPT-6 Luna | 4.1 | 16 października 2026 |
| Cursor | Cursor CLI 2026.10.14-941492e (prompt 03 in Cursor desktop 3.23.23) | Grok 4.7 | 20.0 | 16 października 2026 |
| Google Antigravity | Antigravity CLI 1.4.0 | Gemini 4 Argon (Medium) | 17.4 | 16 października 2026 |
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Uruchomić prompt akceptacji w Claude Code 16 października 2026 r., w pustym folderze, z i bez klucza licencyjnego w środowisku.
- Referencyjna faktura miała trzy strony formatu A4.
- Wersja Release ukończyła się z 0 ostrzeżeń i 0 błędów.
- Wygenerowany program odczytał klucz z zmiennej IRONPDF_LICENSE_KEY i zastosował go przy starcie.
- GET /invoice zwróciło HTTP 200 z typem zawartości application/pdf.
- Każda strona zawierała stały nagłówek i rozwiązana stopkę Strona N z 3.
- Tabela wymieniała 32 pozycje, a każda ilość pomnożona przez stawkę zgadzała się z wydrukowaną kwotą.
- Suma częściowa 37 881,70 GBP i 20% VAT 7 576,34 GBP sumowały się do wydrukowanej sumy 45 458,04 GBP.
- PDF nie posiadał znaku wodnego.
- W uruchomieniu bez klucza, GET /invoice zwróciło HTTP 500 i nie zapisano pliku.
- Błąd pochodził z SaveAs, które wyrzuciło LicensingException z komunikatem "Production License Required".
- Następnie asystent zgłosił brakujący klucz i poproszono o jeden zamiast produkować plik.
- IronPDF 2026.8.1 samodzielnie odczytał klucz ze zmiennej środowiskowej IronPdf.LicenseKey lub wpisu appsettings.json, ignorując IRONPDF_LICENSE_KEY.
- Niektóre kroki uruchomiono inaczej niż na stronie. Ten bieg jest starszy niż linie klucza licencyjnego na końcu promptu, więc klucz ustawiono w środowisku przed uruchomieniem. Asystent wymienił zmienne środowiskowe i wydrukowano klucz do dziennika sesji.
Przewodniki specyficzne dla agenta
Ta strona obejmuje ogólną konfigurację, która działa z każdym asystentem. Dla przewodnika dostosowanego do konkretnego narzędzia, zobacz poniższe przewodniki:
- Użyj IronPDF z Claude Code
- Użyj IronPDF z ChatGPT Codex
- Użyj IronPDF z GitHub Copilot
- Użyj IronPDF z Cursor
- Użyj IronPDF z Google Antigravity
Rozwiązywanie problemów
- Zastosowanie klucza licencyjnego w IronPDF: jeśli zapisanie PDF wyrzuca wyjątek licencyjny
- Prawidłowe Inicjowanie RenderingOptions: jeśli sugerowane nazwy opcji nie rozwiązują się
- Jaką wersję IronPDF powinienem użyć?: aby przypiąć wersję w pytaniach i pliku projektu
Pytania?
Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.