ตำราการใช้งาน Connect

Recipes / guides land here as upstream repositories ship. This page is a routing index for content authored in the source repositories (nextpdf, nextpdf-Laravel, nextpdf-Symfony, and the other ecosystem packages). For documentation available today, see Insider_ (35 articles, all 17 locales) or Choose an integration.

NextPDF Connect ช่วยให้ผู้เรียกใช้ระยะไกลและระบบปัญญาประดิษฐ์ (AI) เข้าถึงเอนจิน NextPDF ผ่าน Model Context Protocol (MCP), API แบบ Representational State Transfer (REST) และบริการ gRPC ตำราการใช้งาน Connect รวบรวมตำราการใช้งานสำหรับงานบนพื้นผิวดังกล่าว และหน้านี้ทำหน้าที่เป็นดัชนีของตำราเหล่านั้น หน้านี้บันทึก slug ของตำราการใช้งานแต่ละรายการ ระดับที่ตำรานั้นอยู่ และขอบเขตการขนส่งที่ใช้ เนื่องจากหน้านี้เป็นดัชนี จึงไม่กล่าวอ้างพฤติกรรมใดของตำราการใช้งานแต่ละรายการ หน้าตำราการใช้งานแต่ละรายการเขียนขึ้นในที่เก็บ nextpdf/server ภายใต้ docs/public/ เป็นผู้รับผิดชอบการกล่าวอ้างของตนเอง และถูกตัวรวบรวมดึงเข้าสู่ไซต์นี้พร้อมข้อมูลที่มาของแหล่งต้นทางอย่างครบถ้วน

หากต้องการดูสัญญาที่ตำราการใช้งาน Connect ทุกรายการปฏิบัติตาม โปรดอ่าน ข้อกำหนดของตำราการใช้งาน หากต้องการดูภาพรวมการผสานรวมของระบบนิเวศทั้งหมด โปรดอ่าน ตำราการผสานรวม

ระดับมีผลต่อสิ่งที่เรียกใช้ได้อย่างไร

การปรับใช้ Connect จะคำนวณชุดเครื่องมือของตนเองระหว่างเริ่มทำงาน ไม่ได้กำหนดไว้ล่วงหน้า รีจิสทรีเครื่องมือของเซิร์ฟเวอร์จะลงทะเบียนเครื่องมือหลักเสมอ จากนั้นตรวจหาผู้ให้บริการ Pro และ Enterprise ด้วย class_exists() และลงทะเบียนเครื่องมือของผู้ให้บริการเหล่านั้นเฉพาะเมื่อมีการติดตั้ง nextpdf/premium ควบคู่กับเซิร์ฟเวอร์ ตำราการใช้งานที่ขึ้นอยู่กับเครื่องมือ Pro หรือ Enterprise จะทำงานได้เฉพาะบนการปรับใช้ที่มีเครื่องมือดังกล่าวพร้อมใช้งานแล้วเท่านั้น บนการติดตั้งที่มีเฉพาะโอเพนซอร์ส เครื่องมือดังกล่าวจะไม่มีอยู่ และการเรียกใช้จะส่งกลับข้อผิดพลาดแบบไม่รู้จักเครื่องมือ แทนที่จะลดทอนการทำงานลงอย่างเงียบๆ ตำราการใช้งานแต่ละรายการระบุระดับของตน และดัชนีนี้จัดกลุ่มตำราการใช้งานตามระดับ เพื่อให้เห็นได้ทันทีว่าการปรับใช้รองรับสิ่งใดบ้าง

จำนวนเครื่องมือทั้งหมดเป็นคุณสมบัติ ณ ขณะรันไทม์ของการปรับใช้ ไม่มีตำราการใช้งานหรือแถวใดในดัชนีนี้ยืนยันตัวเลขคงที่ แคตตาล็อกที่ใช้เป็นหลักฐานคือแคตตาล็อกเครื่องมือของเซิร์ฟเวอร์เอง ซึ่งตำราการใช้งานแต่ละรายการลิงก์ไปถึง

การขนส่งและแบบจำลองข้อผิดพลาด

ตำราการใช้งานทุกรายการเรียกใช้ได้ด้วยวิธีเดียวกันบนการขนส่งทั้งสามแบบ ได้แก่ MCP tools/call ปลายทางเครื่องมือแบบ REST หรือบริการ gRPC การขนส่งทั้งสามใช้ตัวดำเนินการเครื่องมือร่วมกันหนึ่งตัว ตำราการใช้งานที่เข้าถึงบริการระยะไกลผ่าน Hypertext Transfer Protocol (HTTP) ถือว่าความล้มเหลวในการขนส่งและสถานะ HTTP ที่ไม่สำเร็จเป็นคนละกรณี ไคลเอนต์ PSR-18 จะทำให้เกิดข้อยกเว้นฝั่งไคลเอนต์แบบระบุชนิดก็ต่อเมื่อไม่สามารถส่งคำขอได้เลยเท่านั้น ตามที่อธิบายไว้ใน PSR-18 §4 การตอบกลับแบบ 4xx หรือ 5xx เป็นอีกกรณีหนึ่ง โดยเป็นค่าส่งกลับปกติที่ผู้เรียกใช้ตรวจสอบ ไม่ใช่ข้อยกเว้น ตามที่อธิบายไว้ใน PSR-18 §4

แผนผัง slug ของตำราการใช้งาน

ตำราการใช้งานแต่ละรายการอยู่ที่ /cookbook/connect/<recipe>/ ตารางนี้บันทึก slug ระดับของตำราการใช้งาน และขอบเขตแบบหนึ่งบรรทัด หน้าตำราการใช้งานเขียนขึ้นในทรี docs/public/ ของที่เก็บ nextpdf/server แล้วนำมาเผยแพร่บนไซต์นี้ผ่านตัวรวบรวม

ตำราการใช้งาน	ระดับ	ขอบเขต
hello-world	Core	การเรียกใช้ Connect ครั้งแรก: สร้าง เพิ่มเนื้อหา ส่งออก
multi-page	Core	เอกสารหลายหน้าผ่าน Connect
image-embedding	Core	ฝังรูปภาพผ่าน Connect
html-table	Core	เรนเดอร์ตาราง HTML ผ่าน Connect
font-typography	Core	ฟอนต์และการจัดวางตัวอักษรผ่าน Connect
exception-aware	Core	การเรียกใช้เครื่องมือที่รับรู้ข้อยกเว้น
environment-diagnostics	Core	เครื่องมือวินิจฉัยสภาพแวดล้อม
layout-inspection	Core	ตรวจสอบเค้าโครงโดยไม่ต้องเรนเดอร์
worker-safe	Core	การใช้งานแบบกลุ่มที่ปลอดภัยต่อ worker
batch-pdf-generation-with-progress-tracking	Core	สร้าง PDF แบบกลุ่มพร้อมการติดตามความคืบหน้าแบบอะซิงโครนัส
rest-invoice-end-to-end	Core	ใบแจ้งหนี้หนึ่งใบผ่าน REST: ส่ง สำรวจสถานะ ดาวน์โหลด และตรวจสอบในเครื่อง
output-approval	Core	จุดตรวจอนุมัติเอาต์พุตแบบมีมนุษย์ร่วมในกระบวนการ
mcp-agent-session	Core	เซสชันเอเจนต์ MCP ที่บันทึกไว้พร้อมรอบการอนุมัติ
event-hooks	Core	ฮุกเหตุการณ์ตลอดวงจรชีวิต
fill-pdf-form	Pro	กรอกฟอร์ม PDF ผ่าน Connect
extract-text-content	Pro	แยกเนื้อหาข้อความผ่าน Connect
digital-signature	Pro	ลงลายเซ็น PDF (PAdES B-B และ B-T) ผ่าน Connect
accessibility-check	Pro	การตรวจสอบการช่วยสำหรับการเข้าถึง PDF/UA
pii-redaction	Enterprise	ลบข้อมูลส่วนบุคคลที่ตรวจพบออกจากชั้นข้อความ (เป็นการทำลายข้อมูล)
aria-tagged-pdf	Pro	จับคู่บทบาท landmark ของ ARIA เข้ากับโครงสร้างที่มีแท็ก
figure-caption	Pro	Figure ที่เข้าถึงได้พร้อม Caption ที่ซ้อนอยู่ภายใน
aria-noteref-pattern	Pro	รูปแบบการอ้างอิงเชิงอรรถและเนื้อความ
compliance-check	Enterprise	เรียกใช้การตรวจสอบตามมาตรฐานที่ระบุชื่อ
forensic-analysis	Enterprise	การวิเคราะห์เชิงนิติวิทยาศาสตร์ของ PDF ที่ลงลายเซ็นแล้ว
ltv-health-check	Enterprise	การตรวจสุขภาพ LTV (B-LT/B-LTA เฉพาะ Enterprise เท่านั้น)
batch-compliance	Enterprise	การตรวจสอบมาตรฐานแบบกลุ่ม
ai-ready-certification	Enterprise	การตรวจสอบความพร้อมด้าน AI (ไม่ใช่การรับรอง)
page-artifacts	Enterprise	ทำเครื่องหมายองค์ประกอบตกแต่งของการแบ่งหน้าให้เป็น artifact
conformance-mode	Enterprise	เลือกโหมดความสอดคล้อง (มุ่งหมายให้สอดคล้อง โดยตัวตรวจสอบเป็นผู้ตัดสิน)
cjk-vertical-writing	Enterprise	เมตริกการเขียนแนวตั้งของ CJK
opentelemetry	Core	สังเกตการณ์ Connect ด้วย OpenTelemetry
tagged-pdf-tutorial	Core	บทแนะนำ Tagged PDF (มุ่งหมายให้สอดคล้อง โดย veraPDF เป็นผู้ตัดสิน)

slug ใช้แสดงวัตถุประสงค์ของตำราการใช้งานในรูปแบบ kebab-case พร้อมเครื่องหมายทับท้ายเพียงตัวเดียว: ไม่มีคำนำหน้าที่เป็นตัวเลข ไม่มีหมายเลขเวอร์ชัน และไม่มีนามสกุลไฟล์ slug ของตำราการใช้งานจะไม่เปลี่ยนหลังเผยแพร่ และ slug ที่ย้ายแล้วจะมีการเปลี่ยนเส้นทางกำกับไว้

ขอบเขตของความสอดคล้องและการรับรอง

ตำราการใช้งานหลายรายการเกี่ยวข้องกับมาตรฐาน (PDF/UA-2, PDF/A-4, PAdES) ตำราการใช้งาน Connect ถือว่าการรองรับมาตรฐานเป็นเพียงการรองรับเท่านั้น ไม่ใช่ความสอดคล้องหรือการรับรอง เอนจินสร้างเอาต์พุตที่ มุ่งหมายให้สอดคล้อง และตัวตรวจสอบอิสระ (เช่น veraPDF) เป็นผู้ตัดสินความสอดคล้อง ตำราการใช้งานความพร้อมด้าน AI เป็นการตรวจสอบความพร้อม ไม่ใช่การรับรอง ข้อมูลการตรวจสอบความถูกต้องระยะยาวในตำราการใช้งาน LTV เป็นความสามารถเฉพาะ Enterprise เท่านั้น การมีอยู่ของข้อมูลนี้ในเอกสารเป็นความสามารถที่อยู่ในตัวเอกสาร ไม่ใช่การรับประกันความถูกต้องของลายเซ็นอย่างไม่มีกำหนด ตำราการใช้งานที่เกี่ยวข้องแต่ละรายการกล่าวถึงขอบเขตเหล่านี้ซ้ำอย่างครบถ้วน ดัชนีนี้เพียงระบุว่าขอบเขตเหล่านี้มีอยู่และชี้ไปยังแหล่งที่มา แทนที่จะอนุมานขึ้นใหม่ที่นี่

ดูเพิ่มเติม

• ข้อกำหนดของตำราการใช้งาน — สัญญาที่ตำราการใช้งาน Connect ทุกรายการปฏิบัติตาม
• ตำราการผสานรวม — เอกสารอ้างอิงแพ็กเกจและการผสานรวมทั่วทั้งระบบนิเวศ โดย Connect เป็นบริการเครือข่าย