เชื่อมต่อกับเอเจนต์ Microsoft Foundry (พรีวิว)

หมายเหตุ

บทความนี้อธิบายคุณสมบัติที่ใช้ในเอเจนต์หรือการไหลของเอเจนต์ที่ขับเคลื่อนโดยฮาร์เนสมาตรฐาน

[บทความนี้เป็นคู่มือรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

คุณสามารถเชื่อมต่อเอเจนต์ Microsoft Foundry กับเอเจนต์ที่กำหนดเองของคุณ ซึ่งอนุญาตให้เอเจนต์นี้ตอบกลับไปยังผู้ใช้หรือทริกเกอร์ได้

สําคัญ

บทความนี้มีเอกสารรุ่นพรีวิว Microsoft Copilot Studio และอาจจะมีการเปลี่ยนแปลงในอนาคต

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

หากคุณกำลังสร้างเอเจนต์ที่พร้อมสำหรับการใช้งานจริง โปรดดู ภาพรวมของ Microsoft Copilot Studio

ข้อกำหนดเบื้องต้น

ก่อนที่คุณจะเชื่อมต่อเอเจนต์ Microsoft Foundry กับ Copilot Studio เอเจนต์ Foundry ต้องเปิดใช้งานปลายทางโปรโตคอล Activity เอเจนต์ Foundry ที่สร้างขึ้นใหม่จะแสดงเฉพาะจุดสิ้นสุดของโปรโตคอล Responses และ A2A โดยค่าเริ่มต้น หาก Activity endpoint ไม่ได้เปิดใช้งาน การเชื่อมต่อกับ Copilot Studio จะล้มเหลวขณะรันไทม์ด้วยข้อผิดพลาด 400 ดูข้อมูลเพิ่มเติมในส่วน เปิดใช้งาน A2A ขาเข้าบนเอเจนต์ Foundry

ขณะนี้คุณสามารถเปิดใช้งาน Activity endpoint ได้เฉพาะผ่านโปรแกรมเท่านั้น โดยใช้ REST API หรือ Python SDK ไม่มีตัวเลือกเปิดใช้งานจากพอร์ทัล Microsoft Foundry เรียนรู้เพิ่มเติมเกี่ยวกับขั้นตอนการเปิดใช้งานในหัวข้อ กําหนดค่าและแชร์เอเจนต์ของคุณ

หลังจากที่คุณเปิดใช้งานปลายทาง Activity แล้ว ส่วน Endpoints สำหรับเอเจนต์ในพอร์ทัล Foundry จะยังคงแสดงเพียง Responses และ A2A เท่านั้น การขาด UI นี้ก็เป็นเรื่องที่คาดไว้ และไม่ได้หมายความว่าการเปลี่ยนแปลงจะล้มเหลว การเชื่อมต่อกับ Copilot Studio จะทํางานได้หลังจากอัปเดตแล้ว

เชื่อมต่อกับเอเจนต์ Microsoft Foundry

1. ไปที่หน้า เอเจนต์ สำหรับเอเจนต์หลักของคุณ และเลือก เพิ่มเอเจนต์

2. ภายใต้ เชื่อมต่อกับเอเจนต์ภายนอก เลือก Microsoft Foundry จากชนิดเอเจนต์ที่ใช้ได้

3. เลือกการเชื่อมต่อที่ต้องการจากรายการการเชื่อมต่อที่พร้อมใช้งาน หรือสร้างการเชื่อมต่อใหม่ระหว่าง Microsoft Foundry และตัวแทน Copilot Studio ของคุณ เมื่อต้องสร้างการเชื่อมต่อใหม่ คุณจำเป็นต้องระบุ URL ปลายทางโครงการ Foundry

   หมายเหตุ

   เมื่อเชื่อมต่อกับตัวแทนของ Microsoft Foundry จาก Copilot Studio คุณสามารถเชื่อมต่อเฉพาะกับตัวแทนที่สร้างขึ้นในพอร์ทัล Microsoft Foundry ใหม่เท่านั้น การเชื่อมต่อกับเอเจนต์ที่สร้างในพอร์ทัลก่อนหน้าจะทําให้เกิดข้อผิดพลาดที่แสดง 404 - Version not found.

4. เมื่อสร้างการเชื่อมต่อของคุณแล้ว ให้เลือก ถัดไป

5. ป้อน ชื่อ และ คำอธิบาย ที่เหมาะสมสำหรับเอเจนต์ SDK ของคุณ คำอธิบายควรอธิบายวัตถุประสงค์ของเอเจนต์ Microsoft Foundry ของคุณ เพื่อให้เอเจนต์หลักของคุณเข้าใจว่าควรใช้เมื่อใด สำหรับข้อมูลเพิ่มเติม ให้ดู การเขียนเมตาดาต้าที่มีประสิทธิภาพ

6. ป้อน รหัสเอเจนต์ สำหรับเอเจนต์ Microsoft Foundry ที่คุณต้องการเชื่อมต่อ

7. ปรับคําอธิบาย (ถ้าจําเป็น) เพื่อให้สอดคล้องกับบริบทมากขึ้นสําหรับเอเจนต์หลัก ตัวอย่างเช่น ทำให้คำอธิบายเจาะจงมากขึ้นถ้าคุณมีเครื่องมือหรือเอเจนต์อื่น ที่คำอธิบายอาจทับซ้อนกัน อัปเดตคําอธิบายเพื่อให้ Copilot Studio เข้าใจว่าเมื่อใดควรเรียกใช้เอเจนต์นี้

8. เลือก เพิ่มเอเจนต์

9. เมื่อเอเจนต์ของคุณถูกสร้างขึ้น คุณสามารถทดสอบเอเจนต์ของคุณได้ทันที หากคุณต้องการเปลี่ยนรหัสเอเจนต์ในภายหลัง คุณสามารถทำได้จากหน้ารายละเอียดโดยการเลือกเอเจนต์จากรายการเอเจนต์

หมายเหตุ

• หากการโทรทดสอบครั้งแรกของคุณไปยังตัวแทน Foundry ที่เชื่อมต่อล้มเหลวด้วยข้อผิดพลาดคล้ายกับ "The connector 'Azure AI Foundry Agent Service' ส่งคืนข้อผิดพลาด HTTP พร้อมรหัส 400 ข้อผิดพลาดภายใน: ปลายทางของเอเจนต์ <name> ไม่รองรับกิจกรรม กรุณาอัปเดตเอเจนต์เอเจนต์เพื่อรองรับโปรโตคอลนี้" เอเจนต์ Foundry ไม่ได้เปิดใช้งานเอนด์พอยต์โปรโตคอล Activity ดูข้อกําหนดเบื้องต้นในบทความนี้ จากนั้นเปิดใช้งานจุดสิ้นสุดกิจกรรมโดยทําตามขั้นตอน กําหนดค่าและแชร์เอเจนต์ของคุณในเอกสารของ Microsoft Foundry

• คุณมีหน้าที่รับผิดชอบในการตรวจสอบและทดสอบตัวแทนที่เชื่อมต่ออย่างรอบคอบในบริบทของกรณีการใช้งานเฉพาะของคุณ และทําการตัดสินใจและการปรับแต่งที่เหมาะสมทั้งหมด เมื่อคุณเชื่อมต่อกับเอเจนต์ภายนอก Copilot Studio คุณจะต้องรับผิดชอบต่อการใช้เอเจนต์ดังกล่าว ข้อควรพิจารณารวมถึงการรับรอง:

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