ทำไมควรเชื่อมเอเจนต์ AI เข้ากับแอปของคุณผ่าน API

API เอเจนต์ AI คืออะไร

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

นี่คือความต่างจาก API ของโมเดลโดยตรง API ของโมเดลให้แค่การสร้างข้อความ ที่เหลือคุณต้องทำเองทั้งหมด ทั้งพรอมต์ การค้นหาเอกสาร หน่วยความจำ การจำกัดอัตราเรียกใช้ และการคิดเงิน ส่วน REST API ของ IMFA ให้ เอเจนต์แบบจัดการให้ครบ ที่มีทุกอย่างนั้นพร้อมแล้ว อยู่หลัง คีย์เฉพาะเอเจนต์ เพียงคีย์เดียว

คุณสร้างเอเจนต์ได้ด้วย เครื่องมือสร้างแชทบอท AI API เป็นอีกหนึ่งช่องทางที่เอเจนต์ตอบได้ ควบคู่กับเว็บไซต์ WhatsApp, Instagram, Facebook, Telegram, Discord และสายเสียง

เมื่อไหร่ควรเชื่อมเอเจนต์ผ่าน API

ใช้ API เมื่อบทสนทนาเกิดขึ้นในระบบที่คุณเป็นเจ้าของ:

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

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

API เอเจนต์ของ IMFA ทำงานอย่างไร

Base URL คือ https://site.imfa.app/v1 ทุกคำขอต้องใช้คีย์ของเอเจนต์ และต้องส่งจาก โค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ ห้ามส่งจากเบราว์เซอร์หรือแอปมือถือ

1. เผยแพร่เอเจนต์ ตั้งค่าคำสั่ง ข้อมูลความรู้ โมเดล และเครื่องมือใน IMFA ทดสอบด้วยคำถามจริง แล้วเผยแพร่ API จะใช้เวอร์ชันที่เผยแพร่แล้ว
2. สร้างคีย์ เปิดมุมมอง API ของเอเจนต์หรือหน้า API Keys แล้วสร้างคีย์ คีย์จะแสดงเพียงครั้งเดียวและเก็บไว้เป็นค่าแฮชเท่านั้น เก็บคีย์ไว้ในตัวแปรสภาพแวดล้อมของเซิร์ฟเวอร์ เช่น IMFA_API_KEY
3. ส่งคำขอแชท POST /v1/agents/{slug}/chat พร้อม Authorization: Bearer <key>, Idempotency-Key ที่ไม่ซ้ำกัน (8 ถึง 128 ตัวอักษร) และ JSON body ที่มี message กับ sessionId (ไม่บังคับ) คำตอบจะกลับมาพร้อม sessionId และ usage.credits
4. คุยต่อในบทสนทนาเดิม ไม่ต้องส่ง sessionId ในข้อความแรก จากนั้นส่งค่าที่ได้รับกลับไปทุกครั้ง เอเจนต์จะจำบริบทได้
5. ดูสิ่งที่เกิดขึ้น GET /v1/agents/{slug}/sessions แสดงรายการบทสนทนา GET /v1/agents/{slug}/sessions/{sessionId}/messages อ่านบทสนทนาหนึ่งรายการ และ GET /v1/agents/{slug}/leads ส่งคืนลีดที่เก็บได้ รายการจะคืนค่า 20 รายการโดยค่าเริ่มต้น สูงสุด 100 รายการ พร้อม cursor ส่วน GET /v1/agents ใช้ยืนยันว่าคีย์นี้ใช้กับเอเจนต์ตัวไหน

ข้อจำกัดระบุไว้ชัดเจน: ใช้เฉพาะ 4,000 ตัวอักษรแรกของข้อความ body จำกัดที่ 64,000 ไบต์ และข้อผิดพลาดแยกประเภทชัดเจน (การตรวจสอบข้อมูล การยืนยันตัวตน เครดิต การจำกัดอัตรา และเซิร์ฟเวอร์) สถานะ 429 จะมาพร้อม Retry-After ส่วน 402 หมายถึงเครดิตของเจ้าของหมดแล้ว

ทำไมควรใช้ API เอเจนต์แทนการสร้างเอง

ข้ามงานวางระบบหลายเดือน การค้นหาเอกสาร เซสชัน การจำกัดอัตรา การลองใหม่ การคิดเครดิต และกฎป้องกัน prompt injection ทำงานอยู่แล้ว ทีมของคุณเขียนแค่คำขอ HTTP เดียว

เอเจนต์เดียว พฤติกรรมเดียว คำตอบในแอปของคุณเป็นคำตอบเดียวกับบนเว็บไซต์และ WhatsApp เพราะเป็นเอเจนต์ตัวเดียวกัน แก้ครั้งเดียวใน IMFA ทุกช่องทางก็เปลี่ยนตาม

ลองใหม่ได้อย่างปลอดภัย Idempotency key ทำให้การลองส่งใหม่เมื่อเครือข่ายขัดข้องได้คำตอบเดิมกลับมา โดยไม่ถูกคิดเครดิตซ้ำ

ลีดไม่กระจัดกระจายอีกต่อไป ดึงลีดทั้งหมดผ่าน endpoint เดียว ไม่ว่าจะมาจากช่องทางไหน

ยังสร้างเองทั้งหมดได้ถ้าต้องการ ถ้าต้องควบคุมทุกชั้นเอง API ของโมเดลโดยตรงให้อิสระนั้น แลกกับการต้องสร้างและดูแลระบบเอง เอเจนต์เขียนโค้ดอย่าง Codex และ Claude Code ยังจัดการเอเจนต์ IMFA ผ่าน MCP ได้ ขณะที่เซิร์ฟเวอร์ของคุณใช้คีย์ REST เพื่อให้บริการลูกค้า

คำถามที่พบบ่อยเกี่ยวกับ API เอเจนต์ AI

เรียก API เอเจนต์ AI จากเบราว์เซอร์โดยตรงได้ไหม

ไม่ได้ คีย์นี้ใช้เครดิตของเจ้าของ จึงต้องอยู่บนเซิร์ฟเวอร์ที่เชื่อถือได้ API ไม่เปิดให้เบราว์เซอร์เข้าถึงแบบกว้าง ๆ ให้เบราว์เซอร์เรียก endpoint ที่ป้องกันไว้ของคุณเอง แล้วให้ endpoint นั้นเรียก IMFA อีกที

ยืนยันตัวตนคำขอ API เอเจนต์ของ IMFA อย่างไร

สร้างคีย์เฉพาะเอเจนต์ในมุมมอง API ของเอเจนต์หรือหน้า API Keys แล้วส่ง Authorization: Bearer YOUR_API_KEY จากโค้ดฝั่งเซิร์ฟเวอร์ โทเคน MCP เป็นข้อมูลรับรองคนละแบบและใช้ที่นี่ไม่ได้

คุยต่อในบทสนทนา API เดิมได้อย่างไร

ไม่ต้องส่ง sessionId ในคำขอแชทแรก เก็บ sessionId ที่ API ส่งกลับมา แล้วส่งไปพร้อมข้อความถัดไป Session ID จากบทสนทนาบนเว็บไซต์หรือช่องทางอื่นอ่านได้อย่างเดียว ใช้ต่อบทสนทนา API ไม่ได้

ทำไมการแชทต้องมี Idempotency-Key

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

API เอเจนต์ใช้ข้อมูลความรู้และเครื่องมือของฉันไหม

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

จะเกิดอะไรขึ้นเมื่อ API ถูกจำกัดอัตราหรือเครดิตหมด

คุณจะได้ 429 พร้อม header Retry-After เมื่อถูกจำกัดอัตรา และ 402 เมื่อเครดิตของเจ้าของหมด ควรจัดการทุกสถานะที่ระบุไว้ในเอกสารในระบบที่คุณเชื่อมต่อ