หากโครงการนำ AI Agent API มาใช้เลือก OpenAI Agents API ไม่จำเป็นต้องเขียน RFP สำหรับ AI agent ใหม่ทั้งหมด ข้อกำหนดทั่วไปเรื่องนิยามงานเสร็จ การอนุมัติ การจัดชั้นข้อมูล และ KPI ยังใช้ได้ สิ่งที่ต้องเพิ่มคือส่วนต่างเฉพาะของ Agents API ได้แก่การเก็บ session/turn, การกู้หลัง stream หลุด, การรอ input-time connection สูงสุด 5 นาที, environment lifecycle, hosted/self-hosted executor, การแยก key, filesystem ที่ subagents ใช้ร่วมกัน, concurrency และข้อจำกัดของ trace API
OpenAI ประกาศ Agents API แบบ public beta เมื่อ 10 กันยายน 2026 โดยนำ harness ของ Codex มาใช้กับ session ระยะยาว context, tools, subagents และ environment แบบ hosted หรือ self-hosted ระบบช่วยจัดการ agent loop จำนวนมาก แต่ไม่ได้รับรอง exactly-once ของธุรกิจหรือ recovery อัตโนมัติ เอกสารทางการระบุว่า completed turn ไม่ได้แปลว่าทุก tool สำเร็จ event ที่พลาดตอน stream หลุดจะไม่ replay และผู้ใช้ self-hosted ต้องรับผิดชอบ reconnect, shutdown และไฟล์ที่ต้องคงอยู่
สำหรับการตัดสินใจทั่วไป โปรดอ่าน การนำ AI Agent มาใช้ปี 2026 เรื่อง approval/governance ดู ธรรมาภิบาลเวิร์กโฟลว์ AI Agent และงานวิเคราะห์ดู Data Agent สำหรับการผลิต บทความนี้กล่าวเฉพาะข้อกำหนด Agents API ที่ต้องเติมในแบบเดิม
ฐาน AI Agent: องค์ประกอบเฉพาะที่ Agents API เพิ่มเข้ามา
ให้แยก application, harness ของ OpenAI, session, environment, executor และ tool connection ออกจากกัน เมื่อ environment.type: none harness เรียก remote MCP และ function tool ได้ แต่ไม่มี built-in shell, workspace file และ executor MCP แบบ openai_hosted OpenAI provision sandbox และ harness รัน command ในนั้น ส่วน self_hosted องค์กร provision compute และรัน codex exec-server ซึ่งเชื่อมออกไปยัง Agents API ผ่าน WebSocket
| องค์ประกอบ | สิ่งที่ platform ให้ | สิ่งที่โครงการต้องเพิ่ม |
|---|---|---|
| Session | เก็บ session, turn, item | ผูก business ID และกำหนด retention |
| Stream | ส่ง live event | ตรวจ disconnect และสร้างสถานะจาก saved item |
| Hosted environment | Provision sandbox/execute | Network policy, input file, artifact retrieval |
| Self-hosted | Protocol harness-executor | Compute, startup, reconnect, shutdown, persistence |
| Subagents | Delegation, event, concurrency | แบ่งงาน, shared file, cost ceiling |
| Trace | Dashboard ของ turn/tool/subagent | Correlation กับธุรกิจและ telemetry ทดแทน |
หากเฝ้าระบบแบบ request/response อย่างเดียว จะพลาดกรณี session ยังอยู่แต่ executor หลุด, turn completed แต่ tool ล้มเหลว หรือ client หลุดขณะที่งานยังดำเนินต่อ
แยก session, turn, item และ business ID
Session รวมการสนทนาและงานหลาย turn ส่วน turn คือรอบงานของ input หนึ่งครั้ง และ item บันทึก model response, tool call, command และ subagent coordination ความคงทนของ session ไม่ใช่ database transaction
แยก session_id, turn_id, business_execution_id และ side_effect_id งานหนึ่งอาจมีหลาย turn หรือย้ายไป session ใหม่ จึงห้ามใช้ session ID เป็น business ID เก็บ mapping ใน ledger ขององค์กร และใช้ side-effect ID เป็น idempotency key หรือ query ระบบปลายทางก่อน retry write
Context compaction ช่วยงานยาว แต่ไม่ควรใช้ข้อความที่ถูกย่อเป็นข้อมูลหลัก ให้เก็บ checkpoint แบบมีโครงสร้าง: เวอร์ชัน input/policy, step ที่เสร็จและค้าง, artifact hash, external record ID, approval state และ safe resume point
เอกสาร hosted sandbox เตือนว่า completed turn ไม่รับรองว่าทุก tool สำเร็จ ตัวตรวจ business completion จึงต้องดู required tool item, artifact และ external record ก่อนแสดง “เสร็จสมบูรณ์”
กู้คืนหลัง stream หลุด
Event ที่พลาดระหว่าง disconnect จะไม่ replay อัตโนมัติ ห้ามส่ง input เดิมซ้ำทันที เพราะ turn เดิมอาจยังทำงานอยู่
ขั้นตอน recovery คือ 1) เปลี่ยนหน้าจอเป็นกำลัง sync ไม่ใช่ failed 2) retrieve session 3) list saved turns/items เพื่อหา tool, command และ artifact ล่าสุด 4) query side effect ที่ไม่แน่ชัดจากระบบภายนอก 5) ส่ง resume input เป็น turn ใหม่เมื่อยืนยันว่า turn เดิมจบและรู้ step ที่ค้างแล้วเท่านั้น
พฤติกรรม input-time connection สูงสุด 5 นาที
หากส่ง input ขณะ self-hosted environment offline, API สามารถร้องขอ environment connection และรอได้สูงสุด 5 นาที เมื่อเกินกำหนด submission จะ fail และ initial input อาจทำให้ session เปลี่ยนเป็น failed แบบ asynchronous ระหว่างรอห้ามส่ง input เดิมซ้ำ Executor ที่เชื่อมต่อช้าในภายหลังจะไม่ replay input ที่ timeout แล้ว ต้อง retrieve session และ saved items ยืนยันว่า input เดิมไม่ได้รัน แล้วจึง submit เป็น turn ใหม่
ตัวเลขสูงสุด 5 นาทีเป็นพฤติกรรมผลิตภัณฑ์ในเอกสารทางการ ไม่ใช่ SLA ของระบบองค์กร ต้องกำหนดเวลา alert, escalation, manual fallback และ recovery แยกต่างหาก
| สถานะ | การตอบสนองที่ไม่ปลอดภัย | สิ่งที่ต้องตรวจ |
|---|---|---|
| Stream หลุด | Resend input ทันที | Retrieve session และ saved items |
| รอ environment | Submit ซ้ำก่อน 5 นาที | Connection event และ turn creation |
| Timeout 5 นาที | คิดว่า late connection replay งาน | ยืนยันว่าไม่รัน แล้วสร้าง turn ใหม่ |
| Turn completed | ปิดเป็นสำเร็จทั้งหมด | Tool item และ external record |
| Tool result ไม่ชัด | Retry write โดยไม่ตรวจ | Reconcile ด้วย side-effect ID |
| Policy version เปลี่ยน | ทำต่อด้วยกฎหลายเวอร์ชัน | Stop, checkpoint, เริ่มด้วยเวอร์ชันที่อนุมัติ |
แยก environment lifecycle จาก session lifecycle
Session อาจมีอยู่ขณะ self-hosted compute offline และ executor อาจ connected โดยไม่มี active turn ให้ติดตาม event connected, disconnected, pending และ failed ร่วมกับ session state
OpenAI ระบุว่า idle event เพียงอย่างเดียวไม่ใช่ safe shutdown signal เพราะ idle อาจมาถึงหลัง connection request หาย แต่ก่อน input ที่รอเริ่ม turn ก่อนหยุดต้องตรวจ incoming work, active command, required action และ connection request อีกครั้ง พร้อม grace period หากประสาน shutdown ไม่ได้ ให้คง compute ไว้
Mid-turn disconnect อาจทำให้ tool ล้มแม้ turn จบ Command ที่ถูก kill ไม่ restart อัตโนมัติ และ disconnect ไม่ได้ร้องขอ reconnect ผ่าน webhook เสมอ Recovery ต้องตรวจ executor health, command item, artifact และ external side effect แยกกัน
Hosted sandbox ตั้ง network เป็น enabled, disabled หรือ restricted ด้วย allowed_domains ได้ บันทึกปลายทางจริงระหว่าง PoC แล้วทำ allowlist สำหรับ production ส่วน self-hosted ต้องทดสอบ outbound route สำหรับ registration และ WebSocket ทั้งเส้นทาง Proxy timeout ที่สั้นกว่า 5 นาทีจะตัดการเชื่อมต่อก่อน platform
แยก application key กับ executor key
Application OPENAI_API_KEY มีสิทธิ์ session และ model inference ส่วน self-hosted environment รับ environment key แบบจำกัดผ่าน CODEX_API_KEY เก็บ application key ไว้นอก sandbox
Code ที่ agent สร้างอาจอ่าน environment key ได้ แต่ key นี้ควรใช้เชื่อม environment เท่านั้น ห้ามฝังใน source, image หรือ log และต้องทดสอบ rotate/revoke Organization, project และ owner ต้องตรงกับ session
Credential ของบริการภายนอกควรอยู่นอก environment ใน credential broker ที่เติม secret เฉพาะ request ไปยังปลายทางที่อนุมัติ นี่เป็นข้อกำหนดเฉพาะเพราะ agent-generated code เข้าถึง file, credential และ network ที่เปิดใน environment ได้
ทดสอบ shared filesystem และ concurrency ของ subagents
ตั้ง multi_agent.enabled และ max_concurrent_subagents ตอนสร้าง session ค่า default ในเอกสารคือ 6 subagents ไม่นับ coordinator แต่ไม่ควรใช้เป็น production recommendation โดยอัตโนมัติ ให้กำหนดจาก rate limit, CPU/memory, file contention และ token budget
Coordinator กับ subagents ใช้ filesystem เดียวกัน การสร้าง subagent ไม่ได้สร้าง sandbox ใหม่ จึงต้องมี work directory แยก, input read-only, file ownership, atomic write และ merge owner หนึ่งราย
Subagents สืบทอด MCP tools, credential/allowed tools, web search และ file/command ของ environment แต่ไม่รองรับ function tools หาก workflow เดิมให้ child เรียก function tool ต้องผ่าน coordinator หรือปรับเป็น MCP
Event stream แสดง subagent creation, coordination, wait และ interrupt แต่ create/wait item ที่ completed ไม่ได้แปลว่า child task เสร็จ ต้องดู child turn outcome และ artifact
| การทดสอบ | Fault injection | หลักฐานผ่าน |
|---|---|---|
| Concurrency | ส่งงานเกิน limit | จำนวน running ไม่เกินกำหนด |
| Shared file | 2 child แก้ file เดียวกัน | พบ conflict, ไม่ overwrite เงียบ |
| Child failure | ทำ command ของ child ให้ล้ม | Root รายงานว่างานไม่ครบ |
| Tool inheritance | ขอ tool ที่ห้าม | Block และบันทึก event |
| Function tool | ให้ child เรียก function | ตรวจว่าไม่รองรับและใช้ fallback |
| Interrupt | Interrupt child กลางงาน | ตาม outcome/partial artifact ได้ |
การปฏิบัติการ AI Agent: ชดเชยข้อจำกัด trace และ observability
Dashboard แสดง session, turn, model response, tool call, subagent activity, duration, status และ token Tracing เปิดโดย default สำหรับ session ใหม่ แต่สร้างหลัง turn จบและอาจมาช้ากว่า answer ใช้ live event ระหว่างทำงาน และ trace วิเคราะห์หลังจบ
ใน public beta ยังไม่มี trace retrieval และ external trace exporter ผ่าน API จึงไม่ควรสัญญาว่าจะ export platform trace ไป SIEM อัตโนมัติ ให้ application เก็บ session/turn/item ID, business ID, environment event, สรุป tool result, artifact hash และ external record ID พร้อม masking
Token usage ของ root กับ child อาจบันทึกแยกกัน และ usage ของ parent ไม่รวม child เสมอ ต้องรวมทุก agent turn เพื่อไม่ประเมินต้นทุนต่ำเกินไป
การ cancel active turn เก็บ session และงานก่อนหน้าไว้ แต่ไม่ rollback external action หลัง cancel ให้ retrieve saved item, reconcile ระบบปลายทาง แล้วเลือก resume, compensate หรือ close
การประเมิน AI Agent: เพิ่มภาคผนวก Agents API ใน RFP เดิม
ใช้ RFP เดิมสำหรับ approval, data governance และ business evaluation แล้วเพิ่มเฉพาะข้อเหล่านี้
| ข้อเพิ่ม | คำตอบที่ต้องการ | หลักฐานรับมอบ |
|---|---|---|
| Session mapping | Business ID กับ session/turn/item | Ledger และ retrieval |
| Stream recovery | Resync โดยไม่มี event replay | Disconnect test log |
| 5-minute connection | Wait, timeout, กัน resend, late connection | Offline executor test |
| Environment lifecycle | Startup, reconnect, shutdown, persistence | Event และ runbook |
| Executor boundary | Outbound WebSocket, health, proxy | Network test |
| Key separation | Application key vs environment key | Permission/revoke test |
| Multi-agent | Concurrency, shared FS, inherited tools | Conflict/child failure test |
| Trace limitation | Live event, post-turn trace, API ที่ไม่มี | Alternative telemetry |
| Beta change | Version pin, monitoring, regression, rollback | Version inventory |
ต้องขอ event และ ID ที่ใช้เป็นหลักฐาน ไม่รับเพียงคำว่า “รองรับ” เก็บเวอร์ชัน SDK, model, harness, container image และ tool schema
ใช้ PoC 90 วันทดสอบ failure mode ของ Agents API
จำกัด PoC ไว้ที่หนึ่ง workflow หนึ่งกลุ่มผู้ใช้ และระบบเชื่อมต่อประมาณ 2–3 ระบบ นี่เป็นตัวอย่างขอบเขตที่จัดการง่าย ไม่ใช่ข้อจำกัดผลิตภัณฑ์หรือการรับรองผล
วันที่ 1–30 เลือก environment, ทำ session mapping/business ledger, ตรวจ hosted network policy หรือ self-hosted executor/key separation และพิสูจน์ว่ายัง retrieve session/saved items ได้หลัง client stream ปิด
วันที่ 31–60 ทำ stream disconnect, executor offline, input-time connection timeout, mid-turn disconnect และ unknown tool outcome ตรวจว่าไม่มี duplicate input ระหว่างรอ late connection ไม่ replay input timeout และส่ง turn ใหม่หลัง reconcile เท่านั้น ทดสอบ concurrency, shared-file conflict, child failure, interrupt และ function-tool limitation
วันที่ 61–90 ตรึงเวอร์ชัน SDK/model/harness/tool schema แล้วรัน failure suite ซ้ำ ตรวจ trace delay, dashboard access, alternative telemetry และ runbook สำหรับสามกรณี: session ยังอยู่แต่ environment ตาย; turn completed แต่ tool ล้ม; executor กลับหลัง timeout 5 นาที
จุดตรวจ AI Agent สำหรับธุรกิจในการติดตั้งที่ไทย
หาก self-hosted executor อยู่ในเครือข่ายโรงงานไทย ให้ทดสอบ proxy, DNS, WebSocket idle timeout และนโยบายปิด compute กลางคืน แม้ API รอ 5 นาที proxy ขององค์กรที่สั้นกว่าจะตัดก่อน หากรอ approval จากญี่ปุ่นพร้อมกับเวลาปิด environment ห้าม shutdown จาก idle อย่างเดียว ต้องตรวจ pending input และ approval state
เก็บ ID, event name, tool name และ error code เป็นค่าต้นฉบับใน log แม้หน้าจอเป็นภาษาไทย/ญี่ปุ่น เชื่อม session_id, turn_id, environment_connection ค่าเดียวกัน และบันทึกทั้ง ICT/UTC เพื่อไม่ให้ลำดับ timeout 5 นาทีคลุมเครือ
ความเข้าใจผิดที่พบบ่อย
- Durable session เท่ากับ auto recovery: ไม่จริง เพราะไม่มี event replay, external reconciliation หรือ restart command อัตโนมัติ
- Idle แปลว่าหยุด compute ได้: idle อย่างเดียวไม่ใช่ safe shutdown
- Subagent ทุกตัวได้ sandbox ใหม่: ทุกตัวใช้ filesystem ร่วมกัน
- Completed turn แปลว่า tool สำเร็จทั้งหมด: ต้องตรวจ item/artifact/external record
- Trace ดึงและ export ผ่าน API ได้ทันที: trace สร้างหลัง turn และ public beta ยังไม่มี retrieval/exporter API
สรุป: รับมอบ state transition เฉพาะของ Agents API
งานเพิ่มเฉพาะของ Agents API มีขอบเขตชัด: ผูก session/turn/item กับ business ID, กู้ stream จาก saved items โดยไม่หวัง event replay, กัน duplicate input ระหว่าง input-time connection สูงสุด 5 นาที และจำไว้ว่า late connection ไม่ replay input ที่ timeout ต้องเฝ้า environment แยกจาก session และไม่ shutdown ด้วย idle อย่างเดียว
แยก application/environment key ทดสอบ subagents บน shared filesystem และ concurrency ที่กำหนดเอง ใช้ trace เป็นหลักฐานหลัง turn แต่ชดเชยข้อจำกัด API/exporter ด้วย telemetry ของ application การเพิ่มภาคผนวกนี้ใน RFP เดิมและ fault-test ระบบเชื่อมต่อ 2–3 ระบบทำให้ประเมิน Agents API ได้โดยไม่ซ้ำกับบทความ governance ทั่วไป
TOMAS TECH สามารถช่วยเพิ่มข้อกำหนดเหล่านี้ใน RFP เดิม และออกแบบการทดสอบ hosted/self-hosted, executor connectivity, session recovery, subagent contention และ timeout 5 นาที โปรด ติดต่อ TOMAS TECH
FAQ การออกแบบปฏิบัติการ Agents API
Stream หลุดควร resend input หรือไม่
ไม่ควรทันที ให้ retrieve session และ saved items ก่อน เพราะ turn เดิมอาจยังรันและ event ที่พลาดไม่ replay ตรวจ write ที่ไม่ชัดก่อนสร้าง turn ใหม่
การรอ 5 นาทีของ self-hosted คือ SLA หรือไม่
ไม่ใช่ เป็นพฤติกรรมผลิตภัณฑ์ เมื่อเกินเวล submission fail และ late connection ไม่ replay input timeout ต้องกำหนด SLA ภายในแยก
Subagent มี file แยกหรือไม่
ไม่มี Coordinator และ subagents ใช้ filesystem เดียวกัน ต้องแยก work directory, ownership, atomic write และ merge
Platform trace เพียงพอสำหรับ audit หรือไม่
Trace มีประโยชน์แต่สร้างหลัง turn และ public beta ไม่มี retrieval/external exporter API จึงต้องเก็บ business correlation และหลักฐานสำคัญเอง
ภาคผนวก RFP ต้องมีอะไร
Session mapping, recovery ที่ไม่ replay event, 5-minute connection, environment lifecycle, executor/key boundary, shared FS/concurrency, trace limits และ beta version management
แหล่งอ้างอิง
- OpenAI, Introducing the Agents API, 10 กันยายน 2026: https://openai.com/index/introducing-the-agents-api/
- OpenAI Developers, Agents API overview: https://developers.openai.com/api/docs/guides/agents-api/overview
- Architecture: https://developers.openai.com/api/docs/guides/agents-api/architecture
- Run and continue sessions: https://developers.openai.com/api/docs/guides/agents-api/sessions
- OpenAI-hosted sandboxes: https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted
- Self-hosted sandboxes: https://developers.openai.com/api/docs/guides/agents-api/environments/self-hosted
- Sandbox lifecycle: https://developers.openai.com/api/docs/guides/agents-api/environments/lifecycle
- Sandbox security: https://developers.openai.com/api/docs/guides/agents-api/environments/security
- Multi-agent: https://developers.openai.com/api/docs/guides/agents-api/multi-agent
- Observability and usage: https://developers.openai.com/api/docs/guides/agents-api/observability
- Tracing: https://developers.openai.com/api/docs/guides/agents-api/tracing
(เข้าถึงแหล่งข้อมูลปฐมภูมิทั้งหมดเมื่อ 16 กันยายน 2026)
