ข้ามไปยังเนื้อหา
NextPDF

NextPDF Connect

ภาพรวมโดยย่อ

หัวข้อที่มีชื่อว่า “ภาพรวมโดยย่อ”

NextPDF Connect คือแพ็กเกจ nextpdf/server ซึ่งทำงานเป็นบริการระยะยาวที่เปิดให้เอเจนต์ปัญญาประดิษฐ์ (AI) และไคลเอนต์ Hypertext Transfer Protocol (HTTP) เข้าถึงเอนจิน NextPDF PDF 2.0 ได้ รีจิสทรีเครื่องมือชุดเดียวกันนี้พร้อมใช้งานผ่านทรานสปอร์ตสามแบบ ได้แก่ Model Context Protocol (MCP) บนอินพุตและเอาต์พุตมาตรฐาน, Representational State Transfer (REST) Application Programming Interface (API) ที่อธิบายด้วยเอกสาร OpenAPI 3.1 และ gRPC ที่กำหนดโดยแพ็กเกจ Protocol Buffers ชื่อ nextpdf.connect.v1 เครื่องมือแต่ละตัวประกาศระดับความเสี่ยง เครื่องมือในระดับสูงสุดต้องผ่านเกตการยืนยันแบบมีมนุษย์อยู่ในวงจร (HITL) ก่อนจึงจะรันได้

ใช้ส่วนนี้เมื่อจำเป็นต้องดำเนินงานหรือผสานรวมเซิร์ฟเวอร์ เริ่มต้นที่ ภาพรวม เพื่อทำความเข้าใจสถาปัตยกรรม เลือกทรานสปอร์ต จากนั้นใช้ เอกสารอ้างอิง API เพื่อดูสัญลักษณ์ที่แน่นอนของเครื่องมือและบริการ

แผนผังส่วนต่างๆ

หัวข้อที่มีชื่อว่า “แผนผังส่วนต่างๆ”

หน้าเหล่านี้ครอบคลุมแนวคิด การกำหนดค่า และการดำเนินงานของเซิร์ฟเวอร์

หน้าใช้สำหรับ
ภาพรวมขอบเขตของแพ็กเกจ ทรานสปอร์ตสามแบบ และเหตุใดจำนวนเครื่องมือจึงเป็นคุณสมบัติที่กำหนดระหว่างรันไทม์
เริ่มต้นด่วนการทำ MCP handshake ครั้งแรกที่รันได้จริง และคำขอเรนเดอร์ REST ที่สอดคล้องกัน
การกำหนดค่าไฟล์ YAML ของ MCP, ตัวแปรสภาพแวดล้อม NEXTPDF_* และการแทนที่ระดับความเสี่ยงที่ทำได้เฉพาะการยกระดับ
การบูตและการค้นพบวิธีที่ทรานสปอร์ตแต่ละแบบเชื่อมต่อกับเซิร์ฟเวอร์และค้นพบเครื่องมือและไทเออร์ระหว่างการบูต
แคตาล็อกเครื่องมือชุดเครื่องมือหลักที่ผ่านการตรวจสอบและพร้อมใช้งานตลอดเวลา และวิธีที่รันไทม์คำนวณจำนวนรวม
ไทเออร์ความเสี่ยง HITLโมเดลความเสี่ยงสี่ระดับและคำท้าทายสำหรับการยืนยันเครื่องมือที่ต้องได้รับการอนุมัติ
การปรับใช้โปรไฟล์เวิร์กเกอร์ของ RoadRunner, Docker, สโตร์ที่ใช้ Redis เป็นพื้นฐาน และ gRPC mutual Transport Layer Security (TLS)
ความปลอดภัยและการดำเนินการการพิสูจน์ตัวตน ความปลอดภัยของทรานสปอร์ต โมเดลภัยคุกคาม และจุดยืนด้านถิ่นที่อยู่ของข้อมูล

ทรานสปอร์ตแต่ละแบบมีหน้าอ้างอิงของตนเอง

หน้าทรานสปอร์ตใช้สำหรับ
ทรานสปอร์ต MCPการจัดเฟรม JavaScript Object Notation Remote Procedure Call (JSON-RPC) 2.0 บน stdio และเมธอด initialize / tools/list / tools/call
ทรานสปอร์ต RESTไปป์ไลน์ PSR-15 ของ RoadRunner, สัญญา OpenAPI 3.1, การพิสูจน์ตัวตนแบบ bearer และเส้นทางที่ควบคุมตามไทเออร์
ทรานสปอร์ต gRPCบริการ nextpdf.connect.v1.NextPDFConnect, RPC แบบสตรีมจากเซิร์ฟเวอร์ และการพิสูจน์ตัวตนผ่านเมทาดาทา

API หลัก

หัวข้อที่มีชื่อว่า “API หลัก”

ใช้สองหน้านี้เมื่อพัฒนาโดยอ้างอิงเซิร์ฟเวอร์

หน้าบทบาท
เอกสารอ้างอิง APIเครื่องมือที่ลงทะเบียนทุกตัวแยกตามชื่อและคลาส, สัญลักษณ์ของบริการและข้อความ gRPC, โมเดลข้อผิดพลาด และขีดจำกัดอัตรา
คู่มือสำหรับนักพัฒนาขอบเขตสถาปัตยกรรม วงจรชีวิตของรันไทม์ การกำหนดไทเออร์ เกตการยืนยัน จุดต่อขยาย และเช็กลิสต์การทดสอบ

ดูเพิ่มเติม

หัวข้อที่มีชื่อว่า “ดูเพิ่มเติม”