ภาพรวม

Agents API เปิดให้ใช้งานในรุ่นเบต้าแล้ว นักพัฒนาสามารถใช้ API นี้สร้างแอปพลิเคชันที่มีเอเจนต์ Codex ซึ่งจัดการโดย OpenAI โดยเอเจนต์สามารถทำงานหลายขั้นตอนและทำงานต่อในเซสชันเดิมได้

แอปพลิเคชันของคุณเป็นผู้กำหนดงาน เครื่องมือ และการตั้งค่า OpenAI จัดการเซสชันของเอเจนต์และประสานการทำงานระหว่างโมเดลกับเครื่องมือของเอเจนต์

เอเจนต์ทำอะไรได้บ้าง

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

ดูความสามารถที่รองรับและตัวอย่างได้ที่ภาพรวมของ Agents API

ฉันจะเริ่มต้นใช้งานได้อย่างไร

1. สร้างคีย์ API สำหรับแอปพลิเคชันในโปรเจกต์ OpenAI Platform ของคุณ ให้สิทธิ์ api.agents.read และ api.agents.write สำหรับเซสชัน พร้อมทั้ง api.responses.write สำหรับคำขอที่ส่งไปยังโมเดล

2. ทำตามคู่มือเริ่มต้นฉบับย่อเพื่อกำหนดค่าเอเจนต์ สร้างเซสชัน และส่งงาน

3. ติดตามเหตุการณ์ในเซสชันเพื่อตรวจสอบความคืบหน้าและผลลัพธ์ บันทึก ID เซสชันไว้หากคุณต้องการทำงานต่อ

เก็บคีย์ API ของคุณไว้นอกแซนด์บ็อกซ์ของเอเจนต์ คำขอต้องมีส่วนหัว OpenAI-Beta: agents=v1 SDK ของ OpenAI จะเพิ่มส่วนหัวนี้โดยอัตโนมัติ

เอเจนต์ของฉันจำเป็นต้องใช้แซนด์บ็อกซ์หรือไม่

เลือกสภาพแวดล้อมที่เหมาะกับงาน:

• ไม่ใช้สภาพแวดล้อม: เอเจนต์ตอบคำถามหรือใช้เครื่องมือภายนอกโดยไม่จำเป็นต้องใช้คำสั่งเชลล์ในตัวหรือไฟล์ในพื้นที่ทำงาน

• แซนด์บ็อกซ์ที่โฮสต์โดย OpenAI: เอเจนต์จำเป็นต้องรันสคริปต์หรือทำงานกับไฟล์ และคุณต้องการให้ OpenAI จัดการแซนด์บ็อกซ์ให้

• แซนด์บ็อกซ์ที่โฮสต์เอง: คุณจำเป็นต้องใช้โครงสร้างพื้นฐาน ซอฟต์แวร์ หรือเครือข่ายส่วนตัวของคุณเอง แอปพลิเคชันของคุณจะจัดการวงจรชีวิตของสภาพแวดล้อม

ดูรายละเอียดการกำหนดค่าได้ที่สถาปัตยกรรม Agents API

ฉันจะตรวจสอบเซสชันได้ที่ไหน

เปิดบันทึกในแดชบอร์ด Platform เลือก เอเจนต์ แล้วค้นหา ID เซสชัน คุณสามารถตรวจสอบรอบการโต้ตอบ การเรียกใช้เครื่องมือ และกิจกรรมของเอเจนต์ย่อยได้

คู่มือการสังเกตการณ์ระบบยังอธิบายวิธีตรวจสอบปริมาณการใช้ Token ที่บันทึกไว้ด้วย

หากสตรีมเหตุการณ์ขาดการเชื่อมต่อควรทำอย่างไร

ดึงข้อมูลเซสชันเดิมและรายการที่บันทึกไว้ในเซสชันนั้นก่อนลองอีกครั้ง วิธีนี้ช่วยให้คุณตรวจสอบสิ่งที่เกิดขึ้นก่อนส่งงานเพิ่มเติม

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

คิดค่าบริการการใช้งานอย่างไร

คำขอที่ส่งไปยังโมเดลจะคิดค่าบริการตามอัตรา API ของโมเดลที่เลือก เครื่องมือของ OpenAI และแซนด์บ็อกซ์ที่โฮสต์โดย OpenAI จะคิดค่าบริการตามอัตราของเครื่องมือและคอนเทนเนอร์นั้นๆ

ดูอัตราปัจจุบันได้ที่ราคาการใช้งาน API

ข้อมูลเซสชันและไฟล์ได้รับการจัดการอย่างไร

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

ขณะนี้ Agents API รองรับถิ่นที่อยู่ของข้อมูลในสหรัฐอเมริกาเท่านั้น ยังไม่รองรับการไม่เก็บข้อมูล แม้จะใช้แซนด์บ็อกซ์ที่โฮสต์เองก็ตาม ดูรายละเอียดการควบคุมข้อมูลได้ที่เอกสาร Agents API