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

คุณกำลังใช้ประสบการณ์แบบไหน?

เอกสารนี้ครอบคลุมทั้งสองประสบการณ์ หากมี Settings → Personal → My Okou ให้ทำตามขั้นตอนของ My Okou หากคุณใช้หน้า Agents ที่มี New agent ให้ทำตามขั้นตอนของ Legacy Agents การมีใช้งานอาจแตกต่างกันไปในแต่ละสมาชิก เอกสารนี้ไม่เปลี่ยนประสบการณ์ของคุณ

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

ความแตกต่างในการตั้งค่า: My Okou ใช้ Instructions แบบส่วนตัวใน Settings → Personal → My Okou และ Workflows ของพื้นที่ทำงาน ขั้นตอนด้านล่างที่ให้คุณเลือก สร้าง หรืออนุญาต Agent ที่มีชื่อจะใช้กับ Legacy Agents เท่านั้น ใน My Okou ให้ใช้แชตของคุณเองและทำตามคำขอบัญชีและสิทธิ์เฉพาะที่มีชื่อซึ่งแสดงไว้ Workflows ที่แชร์จะไม่แชร์ข้อมูลรับรอง ส่วน Automations จะใช้บริบทและสิทธิ์การเข้าถึงของเจ้าของ

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

ใครกำหนดค่าอะไร

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

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

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

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

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

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

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

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

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

ตรวจสอบคอนเนคเตอร์ใหม่ด้วยคำขอที่จำกัดและเป็นแบบอ่านอย่างเดียวไปยังปลายทางที่รู้จัก ไม่มีคำขอ Test connection แบบทั่วไป เพราะ API จำนวนมากไม่ได้เปิดเผยปลายทางรากที่มีความหมาย

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

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

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

ถัดไปคืออะไร

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