เพิ่มตัวแทนข้อมูล Fabric ไปยังตัวแทน Foundry ด้วย Fabric IQ (ตัวอย่าง)

ตัวแทนข้อมูล Fabric จะตอบคําถามเกี่ยวกับข้อมูลที่จัดเก็บใน Microsoft Fabric OneLake เอเจนต์ที่สร้างใน Microsoft Foundry สามารถเรียกใช้เอเจนต์ข้อมูล Fabric เมื่อต้องการคําตอบจากข้อมูลองค์กรใน OneLake

บทความนี้จะแสดงวิธีเพิ่มตัวแทนข้อมูล Fabric ลงในตัวแทน Foundry โดยใช้เครื่องมือ Fabric IQ (OneLake Catalog) ทุกขั้นตอนเกิดขึ้นในพอร์ทัล Microsoft Foundry คุณยังสามารถทําแบบเดียวกันนี้ในโค้ด ตามที่อธิบายไว้ใน Add a data agent by using code ในบทความนี้

สิ่งที่การผสานรวมนี้มอบให้คุณ

Fabric IQ คือส่วนหนึ่งของ Microsoft Fabric ที่ทําให้ข้อมูลของคุณพร้อมใช้งานสําหรับเอเจนต์และแอปพลิเคชัน ตัวแทนข้อมูล Fabric ที่เผยแพร่เป็นหนึ่งในข้อมูลที่ Fabric IQ เปิดเผย และคุณเพิ่มข้อมูลนั้นให้กับตัวแทน Foundry ผ่าน OneLake Catalog

วิธีนี้แตกต่างจากวิธีก่อนหน้าในสามประการ:

• คุณเลือกตัวแทนข้อมูลจากรายการ ในพอร์ทัล Foundry แคตตาล็อก OneLake จะแสดงตัวแทนข้อมูลที่เผยแพร่ซึ่งคุณสามารถเข้าถึงได้ตามชื่อ คุณไม่จําเป็นต้องค้นหา workspace ID หรือ artifact ID ก่อน
• คุณสามารถเพิ่มตัวแทนข้อมูลมากกว่าหนึ่งตัวได้ ตัวแทน Foundry เพียงตัวเดียวสามารถเรียกใช้ตัวแทนข้อมูลหลายราย เพื่อให้สามารถดึงข้อมูลจากหลายส่วนของข้อมูลธุรกิจของคุณได้ วิธีก่อนหน้านี้อนุญาตให้ใช้ได้เพียงหนึ่งวิธีเท่านั้น
• แต่ละตัวแทนข้อมูลจะถูกเปิดเผยเป็นจุดสิ้นสุดของโปรโตคอลบริบทแบบจําลอง โปรโตคอลบริบทแบบจําลองเป็นมาตรฐานเปิดสําหรับวิธีที่เอเจนต์เรียกใช้เครื่องมือ ตัวแทนข้อมูล Fabric ของคุณจะปรากฏต่อตัวแทน Foundry เป็นเครื่องมือที่สามารถเรียกใช้ได้ เช่นเดียวกับที่เรียกใช้เครื่องมืออื่น ๆ

สําหรับวิธีก่อนหน้านี้ ซึ่งเชื่อมต่อเอเจนต์ข้อมูลเดียวโดยใช้ ID workspace และ artifact ID ดูที่ Consume a data agent ใน Microsoft Foundry

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

• ความจุ Fabric แบบชําระเงิน F2 ขึ้นไป หรือ Power BI Premium ต่อความจุ (P1 ขึ้นไป) ที่เปิดใช้งาน Microsoft Fabric
• พื้นที่ทํางานในภูมิภาคที่รองรับ Fabric stack ทั้งหมด Fabric IQ ไม่มีให้ใช้งานในพื้นที่ที่ Power BI เป็นภาระงาน Fabric เพียงอย่างเดียว สําหรับข้อมูลเพิ่มเติม ดู ความพร้อมใช้งานของภูมิภาค Fabric
• เปิดใช้งานการประมวลผลข้ามพื้นที่และการจัดเก็บข้ามพื้นที่สําหรับ AI ตามข้อกําหนดที่อธิบายไว้ในการตั้งค่าผู้เช่าตัวแทนข้อมูล Fabric
• อย่างน้อยหนึ่งในแหล่งข้อมูลเหล่านี้ มีข้อมูล เช่น คลังสินค้า บ้านพักริมทะเลสาบ โมเดลเซแมนติก Power BI ฐานข้อมูล KQL หรือฐานข้อมูลมิเรอร์ คุณต้องมีสิทธิ์อ่านแหล่งข้อมูล
• โครงการ Foundry ที่มีโมเดลถูกนําไปใช้งานแล้ว หากต้องการสร้าง ดูที่ สร้างโปรเจกต์

ก่อนที่คุณจะเริ่มต้น

ตรวจสอบรายการต่อไปนี้ก่อนที่คุณจะเพิ่มตัวแทนข้อมูล Fabric ไปยังตัวแทน Foundry:

• Data agent ทํางานได้ ยืนยันว่าตัวแทนข้อมูลตอบคําถามตามที่คาดหวังใน Fabric
• ตัวแทนข้อมูลจะถูกเผยแพร่ เฉพาะตัวแทนข้อมูล Fabric ที่เผยแพร่เท่านั้นที่ปรากฏใน OneLake Catalog หากต้องการสร้างและเผยแพร่ ดูที่ Create a Fabric data agent
• ตัวแทนทั้งสองอยู่ในผู้เช่ารายเดียวกัน ตัวแทนข้อมูล Fabric และตัวแทน Foundry ต้องอยู่ในผู้เช่าเดียวกัน
• คุณใช้บัญชีเดียวกัน ลงชื่อเข้าใช้ Microsoft Fabric และ Microsoft Foundry ด้วยบัญชีเดียวกัน
• คุณมีสิทธิ์ถูกต้องแล้ว คุณต้องมีสิทธิ์อ่านข้อมูลเอเจนต์ Fabric อย่างน้อย สิทธิ์อ่านแหล่งข้อมูลพื้นฐาน และสิทธิ์ในการสร้างและแก้ไขตัวแทนในโปรเจกต์ Foundry ของคุณ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับสิทธิ์ของตัวแทนข้อมูล โปรดดูที่ การแชร์และการจัดการสิทธิ์ของตัวแทนข้อมูล Fabric

บทบาทใน Microsoft Foundry

Microsoft Foundry ใช้ระบบควบคุมการเข้าถึงแบบบทบาท ตารางต่อไปนี้แสดงบทบาทที่คุณต้องการสําหรับแต่ละงาน สําหรับข้อมูลเพิ่มเติม ดูที่ การควบคุมการเข้าถึงตามบทบาทสําหรับ Microsoft Foundry

วิธีการทำงาน

1. ผู้ใช้จะถามคําถามกับตัวแทน Foundry ของคุณ
2. ตัวแทน Foundry จะตัดสินใจว่าตัวแทนข้อมูล Fabric ของตนจะตอบคําถามนี้ได้หรือไม่ คําแนะนําที่คุณเขียนจะเป็นแนวทางในการตัดสินใจนี้
3. ตัวแทน Foundry จะเรียกใช้ตัวแทนข้อมูล Fabric
4. ตัวแทนข้อมูลจะสอบถามแหล่งข้อมูลใน Fabric OneLake และส่งคําตอบกลับมา
5. ตัวแทน Foundry ใช้คําตอบนั้นเพื่อตอบกลับผู้ใช้

คําขอจะทํางานภายใต้ตัวตนที่กําหนดค่าสําหรับการเชื่อมต่อ สําหรับ Fabric data agent การเชื่อมต่อนั้นใช้การตรวจสอบสิทธิ์ผู้ใช้ที่ได้รับมอบหมาย ดังนั้นคําขอจะทํางานในฐานะผู้ใช้ที่ลงชื่อเข้าใช้ และ Fabric จะนําสิทธิ์ของผู้ใช้นั้นมาใช้ ผู้ใช้จะได้รับผลลัพธ์เฉพาะจากข้อมูลที่ผู้ใช้สามารถเข้าถึงได้เท่านั้น

ขั้นตอนที่ 1: สร้างตัวแทน Foundry

ถ้าคุณมีตัวแทนอยู่แล้ว ให้เปิดและไปที่ขั้นตอนที่ 2

1. ลงชื่อเข้าใช้พอร์ทัล Microsoft Foundry และเลือกโปรเจกต์ของคุณ คุณจะไปที่หน้าแรก

   

2. ในเมนูนําทางด้านบน ให้เลือก สร้าง ซึ่งจะแสดงรายการเอเจนต์ทั้งหมดในโปรเจกต์ของคุณ

   

3. เลือกลูกศรถัดจาก New agent แล้วเลือก สร้าง agent

   

4. ในกล่องโต้ตอบสร้างเอเจนต์ ให้ป้อนชื่อเอเจนต์ที่อธิบายสิ่งที่เอเจนต์ทํา แล้วเลือก สร้าง

   

เอเจนต์ใหม่ของคุณจะเปิดขึ้นที่แท็บ Playground บานหน้าต่างทางซ้ายคือที่ที่คุณกําหนดค่าเอเจนต์ โดยมีส่วนสําหรับ โมเดลคําแนะนําเครื่องมือความรู้ และอื่น ๆ บานหน้าต่างทางขวาคือแชทที่คุณทดสอบ ขั้นตอนที่เหลือในบทความนี้จะดําเนินการในแท็บนี้

ขั้นตอนที่ 2: เพิ่มเครื่องมือ Fabric IQ (OneLake Catalog)

1. ในส่วนเครื่องมือ ให้เลือก เพิ่ม แล้วเลือก เรียกดูเครื่องมือทั้งหมด
2. ในกล่องโต้ตอบ เลือกเครื่องมือ ที่แท็บ กําหนดค่า ให้เลือก Fabric IQ (OneLake Catalog)
3. เลือก เพิ่มเครื่องมือ

แค ตตาล็อก OneLake เปิดให้บริการ

ขั้นตอนที่ 3: กรองแคตตาล็อกสําหรับตัวแทนข้อมูล

แคตตาล็อก OneLake ระบุรายการสินค้า Fabric หลายประเภท ดังนั้นควรคัดกรองให้แคบลงก่อน

1. เลือก ตัวกรอง
2. ภายใต้ ประเภท ให้เลือก Data agent

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

มีสองกฎที่กําหนดสิ่งที่คุณเห็นในรายการนี้:

• ตัวแทนข้อมูลต้องถูกเผยแพร่ Data agent ที่ยังอยู่ในร่างจะไม่ปรากฏ
• คุณต้องมีสิทธิ์เข้าถึง data agent ถ้าเพื่อนร่วมงานสร้างเครื่องนี้แต่ไม่ได้แชร์กับคุณ มันจะไม่อยู่ในรายการของคุณ

ขั้นตอนที่ 4: เพิ่มตัวแทนข้อมูล

1. ในรายการที่กรองแล้ว ให้เลือกตัวแทนข้อมูล Fabric ที่คุณต้องการให้ตัวแทน Foundry ของคุณใช้
2. เลือก เพิ่ม

ตัวแทนข้อมูลจะปรากฏในส่วนเครื่องมือของตัวแทน Foundry ของคุณ โดยมีชื่อ Fabric IQ พร้อมชื่อตัวแทนข้อมูลในวงเล็บ

ขั้นตอนที่ 5: เพิ่มตัวแทนข้อมูลมากขึ้น

คุณเพิ่มตัวแทนข้อมูลทีละคน หากต้องการเพิ่มอีกหนึ่งอัน ให้ทําซ้ําขั้นตอนที่ 2 ถึง 4 เปิด OneLake Catalog อีกครั้งจากส่วน เครื่องมือ และเลือกตัวแทนข้อมูลถัดไป แต่ละรายการจะปรากฏเป็นรายการแยกในรายการเครื่องมือ

เพิ่มตัวแทนข้อมูลสําหรับแต่ละส่วนของธุรกิจที่ตัวแทน Foundry ต้องดูแล ตัวอย่างเช่น ตัวแทนคนหนึ่งสามารถเก็บข้อมูลการขาย อีกคนหนึ่งเก็บข้อมูลซัพพลายเชน และอีกคนเก็บข้อมูลการสนับสนุนลูกค้า ตัวแทนของ Foundry จะเลือกคําถามที่เหมาะสมสําหรับแต่ละคําถาม

ขั้นตอนที่ 6: เขียนคําแนะนําสําหรับตัวแทนของคุณ

ตัวแทน Foundry ของคุณจําเป็นต้องรู้ว่าเมื่อใดควรใช้แต่ละตัวแทนข้อมูล เขียนคําแนะนํานั้นในส่วนคําแนะนํา

เจาะจง ระบุชื่อเอเจนต์ข้อมูลแต่ละตัวและบอกว่าควรจัดการกับคําถามประเภทใดบ้าง เช่น:

ใช้ตัวแทนข้อมูลการขายของ Contoso สําหรับคําถามเกี่ยวกับรายได้ คําสั่งซื้อ และสินค้า ใช้ตัวแทนข้อมูลฝ่ายสนับสนุนของ Contoso สําหรับคําถามเกี่ยวกับตั๋วสนับสนุนและข้อร้องเรียนของลูกค้า ถ้าคําถามต้องการทั้งสองอย่าง ให้เรียกทั้งสองอย่างและรวมผลลัพธ์เข้าด้วยกัน

หากไม่มีคําแนะนําที่ชัดเจน ตัวแทนอาจไม่โทรหาตัวแทนข้อมูลเลย หรืออาจโทรผิดคน

ขั้นตอนที่ 7: เพิ่มเครื่องมือและแหล่งข้อมูลความรู้อื่น ๆ

ขั้นตอนนี้เป็นทางเลือก นอกจากตัวแทนข้อมูล Fabric แล้ว คุณยังสามารถเพิ่มเครื่องมืออื่น ๆ ในส่วนเครื่องมือ และแหล่งความรู้ในส่วนความรู้ของตัวแทนเดียวกันได้ เพิ่มสิ่งอื่น ๆ ที่ตัวแทนต้องการเพื่อทํางาน

ขั้นตอนที่ 8: บันทึกเอเจนต์ของคุณ

เลือก บันทึก ที่มุมขวาบน

ขั้นตอนที่ 9: ทดสอบเอเจนต์ของคุณ

ใช้แผงแชททางด้านขวาของแท็บ Playground เพื่อทดสอบตัวแทน

1. ส่งคําถามที่ตัวแทนข้อมูลของคุณควรตอบ เช่น สินค้าขายดีอันดับต้น ๆ ของเราเมื่อเดือนที่แล้วคืออะไร?
2. ตรวจสอบคําตอบ ยืนยันว่ามันใช้ข้อมูลที่คุณคาดหวัง และข้อมูลนั้นมาจากตัวแทนข้อมูลที่คุณต้องการ

ทดสอบเอเจนต์ข้อมูลแต่ละตัวที่คุณเพิ่มด้วยคําถามอย่างน้อยหนึ่งข้อ และทดสอบคําถามที่ต้องการมากกว่าหนึ่งข้อ ถ้าเอเจนต์ไม่เรียกเอเจนต์ข้อมูล ให้แก้ไขคําแนะนําที่คุณเขียนในขั้นตอนที่ 6 บันทึก และทดสอบอีกครั้ง

หากต้องการดูว่า data agent ทําอะไรในแต่ละคําขอ รวมถึงแหล่งข้อมูลที่สอบถามและระยะเวลาที่ใช้ในแต่ละขั้นตอน ดูที่ Observability for Fabric data agents ใน Microsoft Foundry

คําถามที่ดําเนินมายาวนาน

บางคําถามใช้เวลาตอบโดยตัวแทนข้อมูลนานกว่าที่การเรียกใช้เครื่องมือมาตรฐานจะอนุญาต เพื่อให้สายเหล่านั้นจบลง:

1. ในรายการ Model ให้เลือกโมเดลที่รองรับโหมดพื้นหลัง เช่น gpt-5.4 หรือgpt-5.5
2. เลือกไอคอนพารามิเตอร์ถัดจากโมเดล แล้วเปิดโหมดพื้นหลัง

จากนั้นเอเจนต์จะแสดงความคืบหน้าในขณะที่เอเจนต์ข้อมูลทํางาน และคืนคําตอบเมื่อรันเสร็จสิ้น

เพิ่มเอเจนต์ข้อมูลโดยใช้โค้ด

ขั้นตอนในบทความนี้ใช้พอร์ทัล Foundry คุณสามารถทําแบบเดียวกันนี้ในโค้ดด้วย Python, C# หรือ JavaScript SDK หรือด้วย REST API Java SDK ไม่รองรับ Fabric IQ

มีสองสิ่งที่ทํางานแตกต่างกันในโค้ด:

• คุณต้องจัดหาจุดสิ้นสุดด้วยตัวเอง ไม่มีแคตตาล็อกให้เรียกดู ดังนั้นคุณต้องส่งปลายทาง Model Context Protocol ของ data agent เป็น server_urlในรูปแบบนี้:

  https://{host}/v1/mcp/workspaces/{workspaceId}/dataagents/{dataAgentId}/agent

  ที่นี่ {host} คือโฮสต์ API ของ Fabric โดยปกติapi.fabric.microsoft.comจะเป็น . ค้นหา{workspaceId}และ{dataAgentId}ในพอร์ทัล Microsoft Fabric: เปิดพื้นที่ทํางาน เลือกตัวแทนข้อมูล และคัดลอกรหัสสองตัวจากแถบที่อยู่เบราว์เซอร์

• คุณอ้างอิงถึงการเชื่อมต่อโครงการ คุณส่งรหัสทรัพยากรของการเชื่อมต่อโครงการ Fabric IQ เป็น project_connection_id. สร้างการเชื่อมต่อนั้นในพอร์ทัล Foundry ก่อน

สําหรับตัวอย่างโค้ดในแต่ละภาษา ดูที่ Connect agent to Microsoft Fabric with Fabric IQ

เนื้อหาที่เกี่ยวข้อง

• ตัวแทนข้อมูล Fabric คืออะไร?
• สร้างตัวแทนข้อมูล Fabric
• แชร์ตัวแทนข้อมูล Fabric
• ใช้ตัวแทนข้อมูลใน Microsoft Foundry
• ความสามารถในการสังเกตสําหรับตัวแทนข้อมูล Fabric ใน Microsoft Foundry
• เชื่อมต่อเจ้าหน้าที่กับ Microsoft Fabric ด้วย Fabric IQ