คอนเนคเตอร์แบบกำหนดเอง

คอนเนคเตอร์แบบกำหนดเองช่วยให้ผู้ดูแลองค์กรสามารถลงทะเบียน HTTPS API หรือในกรณีที่เปิดใช้งาน สามารถลงทะเบียนเซิร์ฟเวอร์ Streamable HTTP MCP ที่ไม่ได้อยู่ในแค็ตตาล็อกในตัวได้ โดยจะกำหนดขอบเขตเครือข่ายและวิธีการยืนยันตัวตน แต่จะไม่สร้างเอกสารอ้างอิง API สำหรับเอเจนต์โดยอัตโนมัติ

ใครตั้งค่าอะไร

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

คำนิยามจะถูกแชร์ในองค์กร ข้อมูลรับรองของสมาชิกจะยังคงถูกจำกัดขอบเขตไว้เฉพาะสมาชิกและองค์กรเท่านั้น

คอนเนคเตอร์ HTTP API

1. เปิด คอนเนคเตอร์ → กำหนดเอง และเลือก คอนเนคเตอร์ใหม่
2. เลือก HTTP API และกรอกชื่อที่จะแสดง
3. เพิ่ม Prefix ของ HTTPS อย่างน้อยหนึ่งรายการ โดยใส่หนึ่งบรรทัดต่อหนึ่งรายการ คำขอต้องตรงกับ prefix ที่กำหนดไว้ก่อนที่คอนเนคเตอร์จะอนุญาตได้
4. เพิ่มการยืนยันตัวตนหาก API ต้องการ:
   • การยืนยันตัวตนด้วย API: กรอกชื่อ header และเทมเพลต header ที่มี {{secret}} เช่น Authorization และ Bearer {{secret}}
   • OAuth 2.0: กรอก URL สำหรับ authorization, token URL, client ID, client secret, scopes และวิธีการยืนยันตัวตนของ token-endpoint ลงทะเบียน redirect URL ที่แสดงในฟอร์มกับผู้ให้บริการให้ตรงกัน
5. สร้างคอนเนคเตอร์ สมาชิกแต่ละคนที่ต้องการใช้งานให้เลือก เชื่อมต่อ และกรอกความลับของตนเองหรือดำเนินการ OAuth ให้เสร็จสมบูรณ์
6. อนุญาตเอเจนต์และสิทธิ์ที่ต้องการ

การเปลี่ยนคำนิยาม OAuth ที่มีอยู่หรือข้อมูล client credentials จะตัดการเชื่อมต่อ OAuth ปัจจุบัน สมาชิกต้องเชื่อมต่อใหม่หลังจากเปลี่ยนแปลง

คอนเนคเตอร์ MCP

หาก MCP ปรากฏเป็นประเภทคอนเนคเตอร์ในเวิร์กสเปซของคุณ ให้กรอก endpoint ของ Streamable HTTP MCP แบบ HTTPS และตั้งค่าการยืนยันตัวตนแบบ API หรือ OAuth ในฟอร์มเดียวกัน หาก MCP ไม่ปรากฏในตัวเลือก แสดงว่ายังไม่ได้เปิดใช้งานสำหรับเวิร์กสเปซนั้น

สอนขั้นตอน API ให้เอเจนต์

คอนเนคเตอร์แบบกำหนดเองจะให้การเข้าถึงเครือข่ายอย่างปลอดภัยและการแทรกข้อมูลรับรอง ฟอร์มสร้างจะไม่อัปโหลดหรือค้นหาเอกสาร OpenAPI อัตโนมัติ ให้เอเจนต์ทราบ endpoint, method, พารามิเตอร์ และ response ที่คาดหวังในคำขอ หรือบันทึกขั้นตอนนั้นไว้ใน เวิร์กโฟลว์ พร้อมแนบเอกสารอ้างอิง API เป็นไฟล์

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

ขอบเขตความปลอดภัย

• ยอมรับเฉพาะ prefix ของ HTTPS และ endpoint ของ MCP เท่านั้น
• ไฟร์วอลล์จะแทรกข้อมูลรับรองที่บันทึกไว้เฉพาะในคำขอที่ตรงกับที่กำหนด
• ความลับที่บันทึกไว้จะถูกเข้ารหัสขณะจัดเก็บและจะไม่ถูกเปิดเผยต่อเอเจนต์ในรูปแบบ environment variable
• ห้ามใส่ key, token หรือ client secret ในข้อความแชท คำแนะนำเวิร์กโฟลว์ หรือไฟล์แนบ
• ใช้ข้อมูลรับรองของบริการที่มี scope ต้นทางเท่าที่เวิร์กโฟลว์ต้องการเท่านั้น

การแก้ไขปัญหา

ถัดไป

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