Context API ดึงบริบทแบบครบถ้วนจากหน้าเว็บใดก็ได้

ใช้ Perplexity Context API เพื่อมอบ Markdown ที่สะอาด ลิงก์ และข้อความส่วนที่เกี่ยวข้องจากหน้าเว็บที่แคชไว้หรือหน้าเว็บแบบเรียลไทม์ให้แก่เอเจนต์ AI

Context API artwork with a luminous mineral cross-section and geometric lines.

เมื่อมีคนถามคำถามกับแชทบอท เอเจนต์ AI อาจต้องอ่านหน้าเว็บหลายหน้าเพื่อตอบคำถามนั้น ผลการค้นหาทั่วไปมักให้มาเพียงข้อความตัดตอนสั้นๆ ส่วนการดึงหน้าเว็บโดยตรงอาจได้ HTML ดิบที่เต็มไปด้วยเมนูนำทาง แบนเนอร์คุกกี้ และโฆษณา เอเจนต์ต้องการบริบทของหน้าเว็บในรูปแบบที่โมเดลนำไปใช้ได้ ขณะที่นักพัฒนาต้องการวิธีควบคุมว่าบริบทนั้นต้องสดใหม่เพียงใด

วันนี้เราเปิดตัว Perplexity Context API ซึ่งอ่าน URL ได้สูงสุด 10 รายการ และส่งคืน Markdown ที่สะอาด HTML ลิงก์ และข้อความตัดตอนตามคำค้นหาสำหรับแต่ละหน้า ข้อมูลมาจากดัชนีเว็บขนาดใหญ่ของ Perplexity หรือจากการดึงข้อมูลแบบเรียลไทม์ เอเจนต์สามารถระบุความสดใหม่ของแต่ละคำขอ และตรวจสอบแหล่งที่มาของผลลัพธ์แต่ละรายการได้

Context API รองรับรูปแบบที่หลากหลาย

เอเจนต์สามารถเริ่มคำขอได้โดยระบุรายการ URL และกำหนดรูปแบบเอาต์พุต จากนั้น API จะส่งคืนผลลัพธ์สำหรับแต่ละ URL ตามลำดับเดียวกัน

Context API รองรับรูปแบบการตอบกลับที่หลากหลาย:

  • Markdown: เนื้อหาของหน้าในรูปแบบ Markdown ที่สะอาด พร้อมใส่ลงในบริบทของโมเดล
  • HTML: HTML ของหน้า สำหรับแอปพลิเคชันที่แยกวิเคราะห์ข้อมูลเอง
  • ลิงก์: ลิงก์ในหน้าในรูปแบบ URL แบบสมบูรณ์ (absolute URL) โดยไม่มีรายการซ้ำและเรียงตามลำดับในหน้า เพื่อให้เอเจนต์ตัดสินใจได้ว่าจะไปที่ใดต่อ
  • ข้อความตัดตอน: ข้อความส่วนต่างๆ ของหน้าที่เกี่ยวข้องกับคำค้นหาที่ระบุมากที่สุด ภายในขีดจำกัดโทเค็นที่นักพัฒนากำหนดไว้สำหรับแต่ละหน้า

Context API จะเลือกข้อความจากแต่ละหน้าที่เกี่ยวข้องกับคำค้นหา แทนที่จะสร้างบทสรุป ด้วยเหตุนี้ โมเดลจึงได้รับถ้อยคำต้นฉบับของหน้า แต่เฉพาะข้อความที่ถูกเลือกเท่านั้น จึงมีข้อความที่ต้องประมวลผลน้อยลง

ผลลัพธ์ที่สำเร็จทุกรายการยังมีเมทาดาทา เช่น ชื่อเรื่อง คำอธิบาย ภาษา ผู้เขียน และวันที่เผยแพร่ รวมถึงแท็ก Open Graph ของหน้า ในการสร้าง Markdown นั้น Context API จะแบ่งหน้าออกเป็นบล็อก และโมเดลจะให้คะแนนแต่ละบล็อกว่าเป็นเนื้อหาหลักหรือส่วนประกอบทั่วไปที่ซ้ำกันทุกหน้า (boilerplate) โดยจะเก็บไว้เฉพาะบล็อกที่เป็นเนื้อหาเท่านั้น

จำเป็นสำหรับงานที่ต้องเห็นภาพรวมทั้งหมด

การค้นหาหน้าที่เกี่ยวข้องอาจไม่เพียงพอเสมอไปสำหรับการทำงานให้สำเร็จ ด้วย Context API เอเจนต์สามารถดึงเนื้อหาที่ต้องการจาก URL ที่เลือกเพื่อทำงานที่ซับซ้อนให้สำเร็จได้

  • การพัฒนาการผสานรวม API: ผลการค้นหาอาจระบุเอกสารที่ถูกต้องได้ แต่ไม่มีพารามิเตอร์ที่จำเป็น คำแนะนำในการยืนยันตัวตน หรือกรณีข้อผิดพลาด Context API ช่วยให้เอเจนต์เขียนโค้ดดึงเอกสารและเอกสารอ้างอิง API มาใช้เขียนการผสานรวมตามรายละเอียดเหล่านั้นได้
  • การเปรียบเทียบราคาปัจจุบัน: ราคาที่แสดงไว้อาจขึ้นอยู่กับขีดจำกัดการใช้งาน เงื่อนไขการเรียกเก็บเงิน หรือเงื่อนไขคุณสมบัติที่ไม่ปรากฏในข้อความตัดตอนจากผลการค้นหา เอเจนต์สามารถขอให้ดึงหน้าราคาที่เลือกแบบเรียลไทม์ และอ่านเงื่อนไขเหล่านั้นก่อนทำการเปรียบเทียบ
  • การตอบคำถามเกี่ยวกับนโยบาย: ข้อความตัดตอนของนโยบายการคืนสินค้าอาจระบุระยะเวลาการคืนสินค้ามาตรฐาน แต่ละเว้นข้อยกเว้นสำหรับผลิตภัณฑ์หรือภูมิภาคบางแห่ง เอเจนต์ฝ่ายสนับสนุนสามารถดึงหน้านโยบายมาเพื่อให้คำตอบครอบคลุมข้อยกเว้นเหล่านั้น
  • การวิจัยจากหลายแหล่งข้อมูล: ข้อความตัดตอนจากผลการค้นหาอาจแสดงข้อค้นพบโดยไม่มีระเบียบวิธี ข้อจำกัด หรือข้อโต้แย้งแวดล้อม เอเจนต์การวิจัยสามารถดึงบทความและรายงานที่เลือก แล้วเปรียบเทียบหลักฐานแทนที่จะอาศัยเพียงข้อความตัดตอน

ควบคุมความสดใหม่และจัดการ URL ได้อย่างเชื่อถือได้

โดยค่าเริ่มต้น Context API จะตรวจสอบดัชนีเว็บของ Perplexity ก่อนว่ามีสำเนาของหน้าที่ดึงมาภายในสองวันที่ผ่านมาหรือไม่ หากไม่มี ระบบจะดึงหน้านั้นแบบเรียลไทม์ นักพัฒนาสามารถเปลี่ยน max_age_seconds เป็น 0 เพื่ออ่านหน้าเว็บแบบเรียลไทม์เสมอ สำหรับราคา ผลการแข่งขัน และข่าวด่วน ส่วนเนื้อหาอ้างอิงที่แทบไม่เปลี่ยนแปลง ก็สามารถเพิ่มค่านี้ได้ ตั้งค่า cache_only เป็น true สำหรับเวิร์กโหลดที่ไม่ควรเรียกใช้คำขอแบบเรียลไทม์เลย

ผลลัพธ์แต่ละรายการจะบันทึกว่าเนื้อหามาจากสำเนาที่จัดเก็บไว้หรือจากการดึงข้อมูลแบบเรียลไทม์ และดึงมาเมื่อใด

URL ในคำขอจะถูกดึงแบบขนาน โดยแต่ละรายการมีกรอบเวลาและสถานะของตนเอง หน้าที่ช้าหรือเสียหนึ่งหน้าจะไม่ทำให้หน้าอื่นล้มเหลวไปด้วย สถานะจะระบุว่าเกิดอะไรขึ้นกับแต่ละ URL เพื่อให้เอเจนต์ลองใหม่เฉพาะหน้าที่หมดเวลา และเก็บผลลัพธ์ส่วนที่เหลือไว้

Context API ส่งคืนเนื้อหาที่ใช้งานได้และครบถ้วน

เราทดสอบ Context API เทียบกับ Firecrawl, Exa, Parallel, Keenable และ Context.dev บน URL จำนวน 1,000 รายการที่สุ่มตัวอย่างจากคำขอดึงข้อมูลจริงของเอเจนต์ ชุดข้อมูลนี้ครอบคลุม 715 เว็บไซต์ รวมถึงแหล่งข้อมูลจากภาครัฐและสถาบันการศึกษา ตลอดจนหน้าเว็บที่ไม่ใช่ภาษาอังกฤษ จากนั้นโมเดลผู้ตัดสินที่แยกต่างหากจะให้คะแนนเอาต์พุตโดยไม่ทราบว่าผู้ให้บริการรายใดเป็นผู้สร้างเอาต์พุตแต่ละรายการ

แผนภูมินี้วัดประสิทธิภาพตามเกณฑ์สามข้อ:

  • ใช้งานได้: สัดส่วนของ URL ที่ส่งคืนเนื้อหาจริงของหน้า ไม่ใช่หน้าข้อผิดพลาดหรือผลลัพธ์ว่างเปล่า
  • ความครบถ้วนของข้อเท็จจริง: ผู้ตัดสินจะรวบรวมข้อเท็จจริงสำคัญที่พบในหน้าจากผู้ให้บริการทั้งหมด แล้วตรวจสอบว่าเอาต์พุตแต่ละรายการมีข้อเท็จจริงใดบ้าง การดึงข้อมูลที่ล้มเหลวจะได้คะแนนเป็นศูนย์
  • ความแม่นยำของเนื้อหา: สัดส่วนของข้อความที่ส่งกลับมาซึ่งเป็นเนื้อหาของหน้าเว็บจริง ไม่ใช่ประกาศเกี่ยวกับคุกกี้ เมนูนำทาง หรือโฆษณา โดยคำนวณค่าเฉลี่ยจาก URL ทั้งหมด การดึงข้อมูลที่ล้มเหลวจะได้คะแนนเป็นศูนย์

ในการประเมินนี้ Context API ส่งกลับเนื้อหาที่ใช้งานได้สำหรับ 92.3% ของ URL ทั้งหมด ดึงข้อเท็จจริงสำคัญกลับมาได้ 87.9% และได้คะแนนความแม่นยำของเนื้อหาที่ 80.3%

ราคา

Context API มีค่าบริการ $1 ต่อการดึงข้อมูลทุกๆ 1,000 URL นักพัฒนาจะชำระเงินสำหรับแต่ละ URL ที่ส่งคืนสถานะ ok ส่วน URL ที่ล้มเหลวจะไม่ถูกเรียกเก็บเงิน

เริ่มต้นใช้งาน

bash
curl --request POST https://api.perplexity.ai/v1/context \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"], "formats": ["markdown"] }'

ผลลัพธ์แต่ละรายการจะส่งคืนพร้อม Markdown ของหน้า ข้อความที่ตรงกับคำค้นหา เมทาดาทาของหน้า และสถานะ โปรดตรวจสอบสถานะของผลลัพธ์แต่ละรายการก่อนนำเนื้อหาไปใช้

อ่านเอกสาร Context API หรือดูเอกสารอ้างอิง API

  1. Orchestrator: API เดียวสำหรับการอนุมานที่เชื่อถือได้นักพัฒนา17 พ.ย. 2569
  2. ขอแนะนำ Monitor API ของ Perplexityนักพัฒนา16 พ.ย. 2569