การดำเนินการของเอเจนต์ AI: ส่งคำขอ HTTP

แผนที่รองรับ: มีให้ในแผน Advanced, Enterprise และแผน Legacy บางแผน. การทดสอบใช้งานได้กับผู้ใช้ทุกคน แต่การเผยแพร่จำเป็นต้องใช้แผนที่รองรับ.

การดำเนินการ ส่งคำขอ HTTP ช่วยให้เอเจนต์ AI ของคุณเรียกใช้ API ภายนอกระหว่างการสนทนาได้. ทำให้เอเจนต์ AI สามารถดึงข้อมูลเรียลไทม์หรือเรียกใช้งานในระบบภายนอกตามคำขอของผู้ติดต่อได้. ตัวอย่างเช่น มันสามารถตรวจสอบสถานะคำสั่งซื้อ ดึงข้อมูลบัญชี หรือสร้างบันทึกในระบบอื่นได้. ในบทความนี้ คุณจะได้เรียนรู้วิธีตั้งค่าการดำเนินการส่งคำขอ HTTP และทดสอบกับเอเจนต์ AI ของคุณ.

เอเจนต์ AI:

1. วิเคราะห์ข้อความของผู้ติดต่อเพื่อระบุว่าตรงกับความตั้งใจที่กำหนดไว้ในคำสั่งการดำเนินการของคุณหรือไม่.

2. รวบรวมข้อมูลที่จำเป็นทั้งหมด.

3. ส่งคำขอ HTTP.

4. ตีความการตอบกลับจาก API.

5. ตอบกลับผู้ติดต่ออย่างเป็นธรรมชาติ.

เพิ่มการดำเนินการส่งคำขอ HTTP

สลับเปิดการดำเนินการแล้วคลิกปุ่ม “Add action” เพื่อเริ่มตั้งค่าคำขอ HTTP ของคุณ.

กำหนดว่าเมื่อใดที่การดำเนินการควรทำงาน

ตั้งชื่อที่อธิบายการดำเนินการในช่อง Action name.

ในช่อง When and how should this action be performed? ของช่อง ให้ระบุ:

• เมื่อใดที่เอเจนต์ AI ควรใช้การดำเนินการนี้

• สิ่งที่มันดึงหรือส่ง

• เงื่อนไขหรือผลลัพธ์ที่ต้องจัดการ

ตัวอย่าง:

ใช้การดำเนินการนี้เพื่อเรียกดูสถานะคำสั่งซื้อของผู้ติดต่อเมื่อพวกเขาถามเกี่ยวกับคำสั่งซื้อของตน. หาก API ส่งรหัสข้อผิดพลาด 404 ให้แจ้งผู้ติดต่อว่าหาไม่พบคำสั่งซื้อ.

เอเจนต์ AI ใช้คำอธิบายนี้เพื่อกำหนดว่าเมื่อใดควรเรียกใช้คำขอ.

ข้อมูลที่เอเจนต์ AI อาจต้องการ (ไม่บังคับ)

กำหนดอินพุตที่จำเป็นในส่วนนี้ก่อนเรียกใช้ API ของคุณ.

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

ถ้าค่าหนึ่งมีสถานะดังนี้:

• ถูกกล่าวถึงแล้วในการสนทนา → เอเจนต์ AI จะใช้ค่านั้น

• หากค่านั้นขาดหาย → เอเจนต์ AI จะขอจากผู้ติดต่อ.

ตัวแปรที่สร้างที่นี่สามารถนำไปใช้ในการกำหนดค่า API ได้. ตัวแปรผู้ติดต่อ (เช่น $contact.email) จะพร้อมใช้งานโดยอัตโนมัติและไม่จำเป็นต้องเพิ่มด้วยตนเอง.

การตั้งค่าฟิลด์

การกำหนดค่า API

กำหนดวิธีที่เอเจนต์ AI ควรเรียกใช้ API ของคุณ.

คุณสามารถกำหนดค่าได้:

• วิธี

• URL

• พารามิเตอร์ของคิวรี

• ส่วนหัว

• JSON body (สำหรับ POST, PUT, PATCH)

การอ้างอิงตัวแปร

คุณสามารถแทรกตัวแปรลงใน URL, พารามิเตอร์, ส่วนหัว หรือ body โดยใช้ $.

มีสองประเภท:

• ตัวแปรผู้ติดต่อ — ฟิลด์ผู้ติดต่อที่มีอยู่

  • $contact.email

• ตัวแปรเอเจนต์ AI — ฟิลด์ที่กำหนดภายใต้ ข้อมูลที่เอเจนต์ AI อาจต้องการ

  • $agent.order_id

ตัวแปรจะถูกแทนที่ด้วยค่าจริงเมื่อมีการรันคำขอ. หากตัวแปรเอเจนต์ AI ที่จำเป็นหายไป เอเจนต์ AI จะขอข้อมูลนั้นก่อนเรียกใช้ API.

วิธีที่ AI จัดการการตอบกลับจาก API

ตัวอย่าง body:

{
  "order_id": "$agent.order_id",
  "email": "$contact.email"
}

เอเจนต์ AI จะตีความการตอบกลับ JSON ของ API โดยอัตโนมัติและสร้างการตอบกลับที่เป็นธรรมชาติ.

ตัวอย่างการตอบกลับจาก API:

{
  "status": "shipped",
  "eta": "2025-12-12"
}

การตอบของเอเจนต์ AI: “ข่าวดี! คำสั่งซื้อของคุณถูกจัดส่งแล้วและคาดว่าจะมาถึงในวันที่ 12 ธันวาคม 2025.”

การทดสอบ

คุณสามารถทดสอบการดำเนินการคำขอ HTTP ของคุณในแผง Test AI Agent ก่อนเผยแพร่.

วิธีทดสอบ

1. เริ่มการสนทนาทดสอบที่ตรงกับเงื่อนไขของการดำเนินการของคุณ.

   

2. เมื่อมีการตรวจพบความตั้งใจและอินพุตที่จำเป็นพร้อม เอเจนต์ AI จะดำเนินการคำขอ HTTP.

3. เหตุการณ์การรันจะปรากฏในแผงทดสอบ:

   

   1. {AI Agent name} ดำเนินการ {Action name}

   2. การตอบกลับรหัส 2xx จะแสดงว่าเป็นความสำเร็จ

   3. รหัสสถานะอื่นๆ จะแสดงว่าเป็นความล้มเหลว

4. คลิกเหตุการณ์เพื่อดู:

   1. แท็บ Response (ค่าเริ่มต้น) — ตัวเนื้อหาการตอบกลับของ API ทั้งหมด

   2. แท็บ Request — payload ของคำขอ cURL ทั้งหมด

   3. ตัวเลือกคัดลอกสำหรับการดีบัก

5. หลังจากได้รับการตอบกลับจาก API เอเจนต์ AI จะสร้างการตอบกลับโดยอิงจากข้อมูลที่ส่งกลับมา.

หมายเหตุสำคัญ

• เหตุการณ์การรันจะปรากฏ เฉพาะในแผง Test AI Agent เท่านั้น. จะไม่ปรากฏใน Inbox หรือ Contact Activity.

• หากอินพุตที่จำเป็นขาดหาย เอเจนต์ AI จะขอข้อมูลเหล่านั้นก่อนเรียกใช้คำขอ.

แนวทางปฏิบัติที่ดีที่สุด

• ระบุคำอธิบายของการดำเนินการให้ชัดเจน. คำสั่งคลุมเครือจะทำให้การทริกเกอร์คลุมเครือ.

• กำหนดอินพุตที่จำเป็นให้ชัดเจน. หาก AI ต้องถามข้อมูล ให้ทำให้ชัดเจน.

• จัดการกรณีข้อผิดพลาดในคำสั่งของคุณ.

• ทดสอบเสมอก่อนเผยแพร่.

• หลีกเลี่ยงการทำซ้ำตรรกะที่เวิร์กโฟลว์จัดการอยู่แล้ว เว้นแต่เป็นการออกแบบโดยตั้งใจ.

ข้อจำกัด

• สูงสุด 10 การดำเนินการคำขอ HTTP ต่อเอเจนต์ AI.

• ขีดจำกัดต่อการดำเนินการ:

  • 20 ฟิลด์อินพุตข้อมูล

  • 50 พารามิเตอร์

  • 50 ส่วนหัว

• เอเจนต์ AI จะกำหนดว่าเมื่อใดควรเรียกใช้ API โดยอิงจากคำอธิบายที่คุณเขียน. คำสั่งที่เขียนไม่ดีอาจทำให้เกิดการทริกเกอร์ที่ไม่คาดคิด.

• การจัดการการตอบกลับจาก API เป็นไปโดยอัตโนมัติ. คุณไม่สามารถแมปฟิลด์การตอบกลับด้วยตนเองได้ — AI จะตีความ JSON ตามบริบท.

• เหตุการณ์การรันคำขอ HTTP จะแสดงเฉพาะในแผง Test AI Agent เท่านั้น และจะไม่แสดงใน Contact Activity.

• เอเจนต์ AI สำหรับเสียงสามารถเรียกใช้การดำเนินการส่งคำขอ HTTP ได้. อย่างไรก็ตาม การตอบกลับจาก API ที่ส่งกลับมาไม่ได้ถูกส่งกลับไปยังเอเจนต์ AI สำหรับเสียงเพื่อสร้างการตอบกลับ นั่นหมายความว่าการสนทนาด้วยเสียงไม่สามารถตอบสนองแบบไดนามิกตามผลลัพธ์ของ API ได้.