ตำราการใช้งาน Connect
ตำราการใช้งาน Connect
หัวข้อที่มีชื่อว่า “ตำราการใช้งาน Connect”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 ของตำราการใช้งาน
หัวข้อที่มีชื่อว่า “แผนผัง slug ของตำราการใช้งาน”ตำราการใช้งานแต่ละรายการอยู่ที่ /cookbook/connect/<recipe>/ ตารางนี้บันทึก slug ระดับของตำราการใช้งาน และขอบเขตแบบหนึ่งบรรทัด หน้าตำราการใช้งานเขียนขึ้นใน nextpdf/serverdocs/public/ แล้วนำมารวบรวมไว้ที่นี่ ตราบใดที่หน้ายังไม่ได้เผยแพร่ ลิงก์ของหน้านั้นจะเป็นการอ้างอิงล่วงหน้า
| ตำราการใช้งาน | ระดับ | ขอบเขต |
|---|---|---|
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 |
output-approval (วางแผนไว้ที่ต้นทาง) | Core | จุดตรวจอนุมัติเอาต์พุตแบบมีมนุษย์ร่วมในกระบวนการ |
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 เป็นบริการเครือข่าย