Chuyển đến nội dung chính
Quay lại danh sách bài viết

Cloudflare Agents SDK เปลี่ยน Agent Skills เป็นไฟล์ใน Workspace ต้องตรวจโค้ดเดิมก่อนอัปเกรด

Cloudflare Agents SDK v0.32.0 ให้ skills เป็นไฟล์ใน Workspace, R2 หรือโค้ด และถอด API เดิมหลายตัว ผู้พัฒนาควรตรวจ breaking changes

Cloudflare Agents SDK เปลี่ยน Agent Skills เป็นไฟล์ใน Workspace ต้องตรวจโค้ดเดิมก่อนอัปเกรด

Cloudflare Agents SDK เปลี่ยน Agent Skills เป็นไฟล์ใน Workspace ต้องตรวจโค้ดเดิมก่อนอัปเกรด

Cloudflare ประกาศวันที่ 29 ตุลาคม 2026 ว่า Agent Skills ใน Agents SDK เปลี่ยนมาใช้ไฟล์ใน Workspace ของ agent ผู้พัฒนาสร้างโฟลเดอร์ที่มี SKILL.md ใต้ /workspace/.agents/skills/ แล้ว agent จะเห็น skill ในเทิร์นถัดไป ไม่ต้อง build หรือ deploy ใหม่ทุกครั้งที่เพิ่มคำแนะนำ การเปลี่ยนนี้ทำให้ทีมจัดการความสามารถของ agent เหมือนไฟล์งานที่แก้ไขและตรวจสอบได้ แต่ Cloudflare ระบุว่าเป็น breaking change สำหรับโค้ดที่เรียก agents/skills แบบเก่า จึงต้องวางแผนอัปเกรดอย่างระมัดระวัง

รุ่นใหม่นี้รองรับแหล่ง skills สามแบบ คือ Workspace, R2 bucket และ skills ที่อยู่ในโค้ด Think จะรวบรวมรายการจากแหล่งเหล่านี้ใหม่ก่อนทุกเทิร์น จึงเห็นไฟล์ที่เพิ่มหรือแก้ระหว่างการสนทนาได้ การเลือกแหล่งควรตามลักษณะงาน: Workspace เหมาะกับ skill ที่ agent หรือผู้ใช้แก้ในสภาพแวดล้อมการทำงาน, R2 เหมาะกับชุดที่แชร์หรือจัดการจากส่วนกลาง ส่วน skills ในโค้ดเหมาะกับความสามารถที่ต้องผูกกับรุ่นแอปและผ่านการทดสอบก่อน deploy

รูปแบบไฟล์และการตรวจสอบ

Cloudflare ระบุว่า SKILL.md ทุกไฟล์ถูกตรวจตาม Agent Skills specification หากไฟล์ผิดกฎบางข้อ ระบบยังโหลดได้แต่บันทึกคำเตือน ผู้พัฒนาสามารถใช้ parseSkill() ตรวจไฟล์ก่อนเขียนหรือใช้งานจริง เรื่องนี้มีนัยต่อทีมที่ให้ agent สร้าง skill ของตนเอง เพราะการโหลดสำเร็จไม่ได้แปลว่าเนื้อหาเป็นไปตามรูปแบบที่ตั้งใจ ควรตรวจ warning และทดสอบว่า agent เรียกใช้ skill ถูกสถานการณ์ ก่อนนำไปใช้กับงานที่มีสิทธิ์แก้ข้อมูลหรือเรียกบริการภายนอก

สคริปต์ที่มากับ skill ใน Workspace เป็นไฟล์ใน Workspace เช่นกัน และ agent เรียกผ่านเครื่องมือ exec ของ Workspace ทีมที่เคยเก็บสคริปต์ไว้ในแพ็กเกจที่ build ล่วงหน้าจึงควรตรวจ path, สิทธิ์ไฟล์ และขอบเขตคำสั่งใหม่ การทำให้ skill เขียนได้ระหว่างรันเพิ่มความยืดหยุ่น แต่ควรวางนโยบายว่าใครเปลี่ยน instruction ได้ เก็บเวอร์ชันอย่างไร และจะย้อนกลับเมื่อ skill ใหม่ทำให้ผลลัพธ์ผิดไปได้อย่างไร

จุดที่โค้ดเดิมอาจพัง

ประกาศระบุว่า agents:skills Vite import, agents/skills/compile, SkillRegistry และ skillWorkspace ของ Think ถูกนำออก ขณะที่ runner() ย้ายไป agents/skills/runner ผู้ที่ใช้ API เหล่านี้ต้องแก้ import และวิธีประกอบระบบก่อนอัปเกรด Cloudflare แนะนำ Agents SDK v0.32.0 และ Think v0.23.0 หรือใหม่กว่า พร้อมตัวอย่าง computer-skills และ r2-skills การอัปเกรดแพ็กเกจโดยไม่ค้นการอ้างอิง API เดิมใน repository อาจทำให้ build หรือตัว agent ที่รันอยู่ล้มเหลว

สำหรับทีมที่ใช้ harness ต่างกัน Cloudflare ระบุว่าเครื่องมือ activate_skill และ read_skill_resource ใช้ร่วมกันได้ใน Think, Pi Durable และ AI SDK ข้อดีคือแนวทางเรียก skill สอดคล้องกันมากขึ้น แต่ควรทดสอบว่าการค้นพบ skill ในแต่ละ harness ให้ผลเหมือนที่คาด โดยเฉพาะเมื่อมี skill ชื่อซ้ำหลายแหล่งหรือมีการแก้ไฟล์ระหว่างบทสนทนา การตรวจลำดับแหล่งและผลการเปิดใช้งานจริงมีค่ามากกว่าดูเพียงว่าไฟล์อยู่ในโฟลเดอร์ถูกต้อง

Cloudflare ยังระบุว่าเมื่อ skill เปลี่ยนระหว่างสนทนา Think จะส่ง catalog ใหม่เป็น reminder แทนการสร้าง system prompt ที่ cache ไว้ขึ้นใหม่ แนวทางนี้อาจช่วยรักษาประสิทธิภาพของ prompt cache และทำให้ agent เห็นการเปลี่ยนแปลงโดยไม่เริ่ม session ใหม่ อย่างไรก็ดีผู้พัฒนาควรทดสอบว่า skill ใหม่เริ่มมีผลตั้งแต่เทิร์นใด และเก็บบันทึกเวอร์ชัน skill ที่ใช้เมื่อจำเป็นต้องอธิบายผลลัพธ์ย้อนหลัง

ก่อน deploy รุ่นใหม่ ทีมควรค้น import ที่ถูกถอดออก ปรับโค้ดตาม migration guide สร้าง skill ตัวอย่างใน Workspace และทดสอบสามกรณี: เพิ่ม skill ระหว่าง session, เปลี่ยน skill แล้วเรียกใช้อีกเทิร์น, และรันสคริปต์จาก skill ภายใต้สิทธิ์ที่กำหนด หากใช้ R2 ให้ทดสอบการอ่านและการเปลี่ยนเวอร์ชันด้วย ฟีเจอร์นี้เปิดทางให้ agent มีทักษะที่เปลี่ยนได้เร็ว แต่ความยืดหยุ่นจะปลอดภัยและดูแลได้ต่อเมื่อมีการตรวจรูปแบบ ควบคุมสิทธิ์ และทดสอบเส้นทางอัปเกรดจริง

แหล่งข่าว: Cloudflare Changelog, 29 ตุลาคม 2026

Chia sẻ bài viết:
Xem thêm bài viết