OpenAI Agents API (public beta): ฮาร์เนส Codex จัดการให้ พร้อม sandbox
น้องกายEngineering
ถ้าเคยประกอบเอเจนต์เองจนเหนื่อยเรื่อง session / จัดบริบท / กู้งานค้าง เอกสาร Agents API ของ OpenAI ชี้ไปทางฮาร์เนสที่เขาจัดการให้
ตามภาพรวม Agents API API นี้ให้แอปเข้าถึง Codex harness แบบจัดการโดย OpenAI — เขารับ session, orchestration, context compaction และ recovery ส่วนแอปส่งเครื่องมือและเลือกว่าจะรันใน environment แบบไหน
แนวคิดหลักสี่อย่าง
- Agent — โมเดล คำสั่ง เครื่องมือ และ MCP
- Environment — แซนด์บ็อกซ์หรือเครื่องที่เอเจนต์แตะไฟล์/รันคำสั่งได้
- Session — อินสแตนซ์ที่ยั่งยืนของเอเจนต์
- Events / items — อินพุตและเอาต์พุตระหว่างเทิร์น
เอเจนต์ในแซนด์บ็อกซ์รันโค้ด แก้ไฟล์ ต่อ MCP และสร้าง artifact ได้
ข้อจำกัดข้อมูลที่ต้องอ่านก่อนโปรดักชัน
เอกสารระบุชัดว่า Agents API รองรับ data residency เฉพาะสหรัฐฯ และ ไม่รองรับ Zero Data Retention (ZDR) แม้เลือก self-hosted sandbox ก็ไม่ทำให้ API นี้เข้าเงื่อนไข ZDR — ไปอ่าน Data controls ในแพลตฟอร์มก่อนผูกข้อมูลอ่อนไหว
Safety / permissions (สิ่งที่ทีมควรตั้ง)
- จำกัดเครื่องมือและโดเมนที่เอเจนต์เรียกได้
- ใช้โหมดที่ต้องอนุมัติก่อนแอคชันเสี่ยง (ตัวอย่างในเอกสารมี incident response ที่ขอ approval)
- แยก environment โปรดักชันออกจากทดลอง
- ลบ session / artifact เมื่อเลิกใช้
ผมไม่แปะคีย์หรือตัวอย่างที่ต้องมีเครือข่ายจริงในโพสต์นี้ — ไปตาม quickstart ในเอกสารเมื่อพร้อมทดลอง
Recap
- อ่าน overview ล่าสุดก่อนออกแบบสถาปัตยกรรม
- จดข้อจำกัด US residency / ไม่ใช่ ZDR
- ออกแบบ permission ของเครื่องมือก่อนเปิดให้ผู้ใช้ทั่วไป
- ใช้ session เป็นหน่วยงานระยะยาว ไม่ใช่แชทครั้งเดียวแล้วทิ้งบริบทเองทุกครั้ง