Cloudflare Agents SDK เพิ่ม web_fetch อ่านเว็บ PDF และเอกสารให้ Agent

Cloudflare เพิ่มเครื่องมือ web_fetch ใน Agents SDK ตามประกาศวันที่ 12 ตุลาคม 2026 เครื่องมือนี้เปิดให้ agent อ่านหน้าเว็บ PDF และเอกสาร Office ที่รองรับ แล้วแปลงเนื้อหาเป็นข้อความที่โมเดลประมวลผลได้ โดยใช้ Workers AI Markdown Conversion ในกรณีที่เว็บไซต์ส่ง Markdown สำหรับ agent อยู่แล้ว เครื่องมือจะขอรูปแบบนั้นโดยตรง ส่วน JSON จะถูกจัดรูปแบบให้อ่านง่าย ประเด็นที่น่าสนใจจึงไม่ใช่แค่ “เปิด URL ได้” แต่เป็นการเชื่อมการดึงข้อมูลเข้ากับขอบเขตและผลลัพธ์ที่ตรวจสอบได้

agent ได้ข้อมูลอะไรกลับมา

เมื่อ model เรียก web_fetch มันส่ง URL แล้วรับทั้งเนื้อหา final URL หลัง redirect, HTTP status และ content type กลับมา ข้อมูลประกอบเหล่านี้ช่วยให้ระบบแยกหน้า 404 จากบทความที่อ่านได้จริง และรู้ว่าการ redirect พาไปที่ไหน หน้าเว็บยาวถูกแบ่งเป็นช่วง พร้อม offset ให้ agent ขอส่วนต่อไป แทนการยัดเอกสารทั้งหมดลงใน context ครั้งเดียว วิธีนี้ช่วยควบคุมปริมาณ token และลดการตัดเนื้อหาเงียบ ๆ ที่อาจทำให้คำตอบผิด

นักพัฒนาควบคุม host ที่อนุญาต ขนาด response, timeout และ redirect ได้ สิ่งเหล่านี้ต้องเป็นนโยบายของแอป ไม่ใช่ปล่อยให้ prompt ของผู้ใช้กำหนดเองทั้งหมด หาก agent อ่าน URL ภายนอกโดยไม่มี allowlist อาจถูกชักนำให้เรียก service ภายในหรืออ่านข้อมูลจากปลายทางที่ไม่เกี่ยวกับงาน สำหรับระบบที่เปิดให้ผู้ใช้ส่ง URL ควรทดสอบลิงก์เปลี่ยนปลายทางและตรวจ final URL ด้วยทุกครั้ง

เชื่อมกับการค้นหาอย่างไร

Cloudflare บอกว่าเมื่อให้ agent ใช้ web_search ควบคู่กัน ระบบจะบอกโมเดลให้ใช้ web_fetch อ่านหน้าที่ค้นพบด้วย นั่นช่วยลดพฤติกรรมตอบจาก snippet สั้น ๆ แต่ไม่ได้รับประกันว่าข้อความในหน้าเว็บถูกต้องหรือปลอดภัย เนื้อหาจากเว็บไซต์เป็นข้อมูลที่ไม่เชื่อถือ ควรแยกจากคำสั่งของระบบอย่างชัดเจน และควรให้คำตอบอ้างอิง URL ต้นทางจริง ไม่ใช่อ้างผลค้นหาเพียงหัวข้อ การบันทึก HTTP status และ final URL ช่วยตรวจย้อนหลังได้ว่า agent อ่านอะไรในช่วงที่สร้างคำตอบ

เงื่อนไขการใช้งาน

ประกาศระบุให้ใช้ Agents SDK 0.28.0 ขึ้นไป แล้วเพิ่ม webFetchTool ใน extension registry ของ Pi Durable ก่อนเปิด harness ตัวอย่างของ Cloudflare ใช้ AI binding สำหรับการแปลงเอกสาร SDK ยังรองรับ AI SDK และ TanStack AI adapters ด้วย หากต้องการดึงหน้าโดยไม่เรียกโมเดล สามารถใช้ fetchWeb(), windowWebFetchPage() หรือ renderWebFetchPage() จาก agents/webfetch และกรณีนี้ไม่ต้องใช้ Durable Object หรือ browser เสมอไป

การเลือก API ควรขึ้นกับงาน: agent ที่ค้นหาและสรุปหลายหน้าอาจเหมาะกับ tool ส่วน pipeline ที่รู้ URL ล่วงหน้าและแค่แปลงเอกสารอาจเรียกฟังก์ชันโดยตรง ควรกำหนดเพดานขนาดไฟล์และเวลารอให้เหมาะกับ SLA ตรวจชนิดไฟล์จริงหลังโหลด และวางแผนเมื่อ PDF สแกนเป็นภาพหรือเอกสารมีตารางซับซ้อน เพราะการแปลงเป็น Markdown อาจสูญเสียความสัมพันธ์บางส่วน การตรวจตัวอย่างเอกสารจริงสำคัญกว่าการทดสอบกับหน้าเว็บตัวอย่างเพียงหน้าเดียว

วิธีทดลองกับข้อมูลจริง

เริ่มจากชุด URL ที่มีหน้า HTML, PDF, JSON, redirect และ error จากนั้นตรวจ content type, final URL, ความครบของเนื้อหาและ offset ในแต่ละกรณี วัดจำนวน token ที่ใช้ต่อคำตอบและเวลาตอบสนอง เทียบกับวิธีดึงข้อมูลเดิม ถ้าจะใช้ใน production ให้ log metadata ที่จำเป็นต่อการสอบกลับ แต่ระวังอย่าเก็บเนื้อหาเอกสารส่วนตัวหรือ credential ลง log โดยไม่จำเป็น การมีเครื่องมืออ่านเว็บใน SDK ทำให้ต่อระบบได้ง่ายขึ้น ทว่าความน่าเชื่อถือของคำตอบยังขึ้นกับการเลือกแหล่งข้อมูลและการตรวจข้อเท็จจริงของแอป

อ่านประกาศต้นทางวันที่ 12 ตุลาคม 2026: Cloudflare Changelog — New web_fetch tool in the Agents SDK