การเชื่อมต่อ API

การเชื่อมต่อ API คือฟังก์ชัน HTTP แบบกำหนดเองที่เอเจนต์ของคุณสามารถเรียกใช้ระหว่าง การสนทนาได้ เช่น ค้นหาคำสั่งซื้อ สร้างทิกเก็ต ดึงสถานะบัญชี จากแบ็กเอนด์ของคุณเอง คุณกำหนดเอนด์พอยต์เพียงครั้งเดียวใน การเชื่อมต่อ → API (/dashboard/api-connections) จากนั้นเอเจนต์ที่ แนบการเชื่อมต่อนี้ไว้จะเรียกใช้ได้ทุกเมื่อที่เหมาะสมกับการสนทนา

มี 2 วิธีในการสร้าง: วางข้อมูลที่วิซาร์ดสามารถวิเคราะห์ได้ หรือตั้งค่าการเชื่อมต่อด้วยตนเอง

วิธีที่รวดเร็ว: วางและวิเคราะห์

1. คลิกการเชื่อมต่อ API ใหม่

   กล่องโต้ตอบจะเปิดที่วิซาร์ด วางตัวอย่าง คำสั่ง cURL, สเปก OpenAPI/Swagger, ไฟล์ส่งออก Postman, อินเทอร์เฟซ TypeScript หรือ สคีมา Zod ลงในกล่อง

2. คลิกวิเคราะห์

   ThunderPhone อนุมานการเชื่อมต่อทั้งหมดจากข้อมูลที่คุณวาง — URL, เมธอด ส่วนหัว และสคีมาพารามิเตอร์ที่ได้จากพารามิเตอร์คิวรี และเนื้อหาคำขอที่พบ ส่วนหัวที่คุณวางไว้ (รวมถึง ส่วนหัวการตรวจสอบสิทธิ์) จะถูกนำไปใช้ในการกำหนดค่าเอนด์พอยต์

3. ยืนยันฟิลด์ที่ไฮไลต์

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

4. ตรวจสอบและบันทึก

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

หากวิซาร์ดไม่พบ URL คำขอในข้อมูลที่คุณวาง ระบบจะแจ้งให้ทราบ — ใส่เอนด์พอยต์ http(s) แบบเต็มแล้วลองอีกครั้ง

การตั้งค่าด้วยตนเอง

คลิก ตั้งค่าด้วยตนเอง → ในวิซาร์ด (หรือคลิก ต้องการให้ AI อนุมานข้อมูลนี้หรือไม่? ลองใช้วิซาร์ด → เพื่อกลับไป) ตัวสร้างแบบกำหนดเองมีตัวแก้ไข 2 แบบ:

• แบบภาพ — ฟิลด์แบบฟอร์มสำหรับชื่อที่แสดง ชื่อฟังก์ชัน URL, เมธอด (POST, GET, PUT, PATCH, DELETE), ส่วนหัว แบบกำหนดเอง และสคีมาพารามิเตอร์ (เพิ่มคุณสมบัติ สำหรับ อาร์กิวเมนต์แต่ละรายการที่เอเจนต์สามารถระบุได้)
• JSON — คำจำกัดความเดียวกันในรูปแบบ JSON ดิบ สำหรับวางหรือปรับแต่ง สเปกเครื่องมือโดยตรง

แผง ทดสอบคำขอ (ไม่บังคับ) ให้คุณส่งคำขอที่กำหนดค่าไว้ ก่อนบันทึก และแสดงสถานะ เวลาแฝง และตัวอย่างการตอบกลับ ตรวจสอบและบันทึก จะเรียกใช้การทดสอบนี้เสมอและบันทึกเฉพาะเมื่อสำเร็จ

จัดการการเชื่อมต่อของคุณ

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

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

แนบเข้ากับเอเจนต์

เพิ่มการเชื่อมต่อไปยังเอเจนต์ในส่วนการเชื่อมต่อ API ของตัวสร้าง (สร้างเอเจนต์) รายการจะแสดงว่าเอเจนต์ใด ใช้การเชื่อมต่อแต่ละรายการ เพื่อให้คุณทราบได้ทันทีว่าการเปลี่ยนแปลงส่งผลต่อสิ่งใด

ขั้นตอนถัดไป