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

เปลี่ยน HTTP API ใดก็ได้ให้เป็นฟังก์ชันที่เอเจนต์ของคุณเรียกใช้ระหว่างการสนทนาได้: วางคำสั่ง cURL แล้ววิซาร์ดจะสร้างนิยามเครื่องมือ พารามิเตอร์ และการยืนยันตัวตน

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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