หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
คุณสามารถเพิ่มตัวแทนข้อมูล Fabric เป็นเครื่องมือให้กับตัวแทนที่คุณสร้างใน Microsoft Foundry หลังจากที่คุณเชื่อมต่อแล้ว ตัวแทน Foundry จะโทรหาตัวแทนข้อมูล Fabric เพื่อตอบคําถามที่มีพื้นฐานมาจากข้อมูลองค์กรของคุณที่อยู่ใน Fabric OneLake
บทความนี้เกี่ยวกับความสามารถในการสังเกตการณ์สําหรับการตั้งค่านั้น เมื่อคุณสร้างตัวแทนใน Foundry และเชื่อมต่อตัวแทนข้อมูล Fabric กับตัวแทนนั้น คุณต้องการดูว่าตัวแทนข้อมูลทําอะไรในแต่ละคําขอ ไม่ใช่แค่คําตอบสุดท้าย Foundry Observability ช่วยให้คุณมองเห็นได้ บันทึกและการติดตามของตัวแทนข้อมูลจะถูกส่งไปยังที่เดียวกับที่ตัวแทน Foundry ของคุณรายงานไปแล้ว คุณจึงสามารถติดตามคําขอแบบ end-to-end จากตัวแทน Foundry ไปยังตัวแทนข้อมูล Fabric และลงไปยังแหล่งข้อมูลที่สืบค้น
ส่วนที่เหลือของบทความนี้จะอธิบายว่าการวัดและส่งข้อมูลทางไกลนั้นถูกเก็บไว้ที่ใด ไปถึงที่นั่นได้อย่างไร จะอ่านอย่างไร ใครสามารถดูได้ และจะควบคุมได้อย่างไร
สําหรับภาพรวมทั่วไป โปรดดู ความสามารถในการสังเกตการณ์ใน Generative AI เมื่อต้องการเชื่อมต่อตัวแทนข้อมูล Fabric กับ Foundry โปรดดู ใช้ตัวแทนข้อมูลใน Microsoft Foundry
โครงการโรงหล่อและข้อมูลเชิงลึกของแอปพลิเคชัน
โครงการ Foundry คือที่ที่คุณสร้างและดําเนินการตัวแทนของคุณ Foundry จัดเก็บการติดตามตัวแทนในทรัพยากร Azure Monitor Application Insights และแต่ละโครงการเชื่อมต่อกับทรัพยากรดังกล่าวหนึ่งรายการ
ในฐานะผู้สร้างเอเจนต์ ให้ตั้งค่านี้เพียงครั้งเดียว ในโครงการ Foundry ของคุณ ให้เปิดส่วน ตัวแทน เลือก การติดตาม และเลือก เชื่อมต่อ คุณสามารถสร้างทรัพยากร Application Insights ใหม่ หรือเชื่อมต่อทรัพยากรที่มีอยู่แล้ว หลังจากที่คุณเชื่อมต่อทรัพยากร Foundry จะเปิดการติดตามฝั่งเซิร์ฟเวอร์สําหรับโครงการโดยอัตโนมัติ คุณไม่จําเป็นต้องทําการเปลี่ยนแปลงโค้ดใดๆ และการติดตามจะเริ่มไหลภายในไม่กี่นาที
ความสัมพันธ์ตรงไปตรงมา: โครงการชี้ไปที่ทรัพยากร Application Insights หนึ่งทรัพยากร และตัวแทนทุกคนในโครงการนั้นจะส่งการติดตามไปที่นั่น โครงการกําหนดตําแหน่งที่รวบรวมการวัดและส่งข้อมูลทางไกล Application Insights คือตําแหน่งที่ใช้งานและตําแหน่งที่คุณสืบค้น
คุณสามารถดูการติดตามในแท็บ การติดตาม ของตัวแทน Foundry ของคุณ หรือคิวรีโดยตรงในรีซอร์ส Application Insights ที่เชื่อมต่อ พอร์ทัล Foundry แสดงร่องรอยจาก 90 วันที่ผ่านมา
สําหรับการตั้งค่าทีละขั้นตอน โปรดดู ตั้งค่าการติดตามสําหรับตัวแทน AI ใน Microsoft Foundry
บันทึกและการติดตามของตัวแทนข้อมูล Fabric เข้าถึงโปรเจ็กต์ของคุณอย่างไร
หากต้องการเชื่อมต่อตัวแทนข้อมูล Fabric กับ Foundry ให้ทํางานในโครงการ Foundry หากคุณเชื่อมต่อทรัพยากร Application Insights กับโครงการนั้น ตัวแทนข้อมูล Fabric จะส่งบันทึกและการติดตามไปยังทรัพยากรเดียวกันนั้น การวัดและส่งข้อมูลทางไกลของตัวแทน Foundry และการวัดและส่งข้อมูลทางไกลของตัวแทนข้อมูล Fabric อยู่ในที่เดียว คุณจึงสามารถอ่านร่วมกันได้
โฟลว์ทํางานดังนี้:
- ในโครงการ Foundry ของคุณ ให้เชื่อมต่อทรัพยากร Application Insights ตามที่อธิบายไว้ในส่วนก่อนหน้า
- เพิ่มตัวแทนข้อมูล Fabric เป็นเครื่องมือให้กับตัวแทน Foundry ในโครงการนั้น
- เมื่อตัวแทน Foundry ทํางาน จะเรียกใช้ตัวแทนข้อมูล Fabric เพื่อรับข้อมูลเชิงลึกจากข้อมูลองค์กรใน Fabric OneLake
- Fabric ตรวจสอบความถูกต้องของทรัพยากร Application Insights ที่เชื่อมต่อกับโครงการ จากนั้นส่งบันทึกและการติดตามของตัวแทนข้อมูลไปยังโครงการ
- การวัดและส่งข้อมูลทางไกลของตัวแทนข้อมูลจะปรากฏควบคู่ไปกับการติดตามของตัวแทน Foundry ของคุณ ทั้งในทรัพยากร Application Insights ที่เชื่อมต่อและในมุมมอง การติดตาม ของตัวแทน
ผลลัพธ์ที่ได้คืองานที่ตัวแทนข้อมูล Fabric ทําจะกลายเป็นส่วนหนึ่งของการติดตามสําหรับคําขอ คุณจะเห็นว่าตัวแทน Foundry ของคุณโทรหาตัวแทนข้อมูล และคุณจะเห็นว่าตัวแทนข้อมูลทําอะไรเพื่อสร้างคําตอบ รวมถึงแหล่งข้อมูลที่สืบค้น ระยะเวลาที่แต่ละขั้นตอนใช้เวลา และแต่ละขั้นตอนสําเร็จหรือไม่
อ่านร่องรอย
Foundry Observability บันทึกคําขอแต่ละรายการเป็นการติดตาม การติดตามประกอบด้วยช่วง และแต่ละช่วงแสดงถึงหนึ่งหน่วยของงานที่มีเวลาเริ่มต้น ระยะเวลา และสถานะของตัวเอง ช่วงจะซ้อนกัน ดังนั้นการอ่านการติดตามจากบนลงล่างจะแสดงเส้นทางที่คําขอใช้และตําแหน่งที่ใช้เวลา
ตัวแทนข้อมูล Fabric จะเพิ่มช่วงสองชนิดในการติดตาม:
- ช่วงตัวแทน: การเรียกใช้โดยรวมของตัวแทนข้อมูล Fabric สําหรับคําขอเดียว
- ช่วงเครื่องมือ: แหล่งข้อมูลหรือเครื่องมือเดียวที่ตัวแทนข้อมูลเรียกใช้ขณะตอบคําขอ คําขอเดียวสามารถสร้างช่วงเครื่องมือได้มากกว่าหนึ่งช่วง
ตัวอย่างต่อไปนี้แสดงตัวแทน Foundry ที่เรียกตัวแทนข้อมูล Fabric ซึ่งสอบถามแหล่งข้อมูลสองแหล่งเพื่อตอบคําถาม:
Request (trace)
└─ Foundry agent run
└─ Fabric data agent (called as a tool)
└─ Agent span Overall run of the Fabric data agent
├─ Tool span First data source the data agent queried
└─ Tool span Second data source the data agent queried
ตารางต่อไปนี้อธิบายแต่ละระดับของการติดตามและชนิดของข้อมูลเมตาที่แนบมา
| ระดับ | ปล่อยโดย | แสดง | ตัวอย่างข้อมูลเมตา |
|---|---|---|---|
| ตัวแทนโรงหล่อทํางาน | โรงหล่อ | ตัวแทน Foundry ที่จัดการคําขอของผู้ใช้ | รหัสการสนทนา สถานะ ระยะเวลา |
| ตัวแทนข้อมูล Fabric (การเรียกใช้เครื่องมือ) | โรงหล่อ | จุดที่ตัวแทน Foundry เรียกตัวแทนข้อมูล Fabric | ชื่อที่แสดงของตัวแทน สถานะ ระยะเวลา |
| ช่วงตัวแทน | ตัวแทนข้อมูล Fabric | การเรียกใช้โดยรวมของตัวแทนข้อมูล Fabric สําหรับคําขอ | ชื่อที่แสดงของตัวแทน ID การสนทนา สถานะ ระยะเวลา |
| ช่วงเครื่องมือ | ตัวแทนข้อมูล Fabric | แหล่งข้อมูลหรือเครื่องมือแต่ละรายการที่ตัวแทนข้อมูลเรียกใช้เพื่อตอบ | ชื่อแหล่งข้อมูล รหัสขั้นตอนการให้เหตุผล สถานะ ระยะเวลา |
ด้วยโครงสร้างนี้ คุณสามารถตอบคําถามที่สําคัญเมื่อมีบางอย่างผิดปกติ:
- เมื่อการตอบสนองช้าระยะเวลาในแต่ละช่วงจะแสดงขั้นตอนที่ใช้เวลามากที่สุด
- เมื่อคําตอบผิด ช่วงเครื่องมือจะแสดงแหล่งข้อมูลใดที่ถูกคิวรีและในลําดับใด
- เมื่อคําขอล้มเหลว สถานะในแต่ละช่วงจะแสดงตําแหน่งที่เกิดความล้มเหลว
ใครสามารถดูบันทึกและการติดตามได้บ้าง
ทรัพยากร Application Insights ที่จัดเก็บบันทึกและการติดตามของตัวแทนข้อมูลจะควบคุมการเข้าถึง ใครก็ตามที่มีสิทธิ์อ่านทรัพยากรนั้นสามารถดูการวัดและส่งข้อมูลทางไกลได้ การเชื่อมต่อทรัพยากรกับโครงการไม่ได้ให้สิทธิ์การเข้าถึงข้อมูลที่เก็บไว้
| ตําแหน่งที่คุณดูข้อมูล | การเข้าถึงที่จําเป็น |
|---|---|
| ข้อมูลเชิงลึกของแอปพลิเคชัน | บทบาทที่มีสิทธิ์ในการอ่านบนรีซอร์ส Application Insights ที่เชื่อมต่อ เช่น Monitoring Reader หรือ Log Analytics Reader |
| โครงการ Microsoft Foundry | สิทธิ์การอ่านบนทรัพยากร Application Insights ที่เชื่อมต่อ รวมถึงบทบาทโครงการ Foundry ของผู้ใช้ Foundry หรือสูงกว่า |
การเข้าถึงโครงการ Foundry ด้วยตัวเองไม่รวมถึงการเข้าถึงการวัดและส่งข้อมูลทางไกล จําเป็นต้องมีสิทธิ์อ่านบนทรัพยากร Application Insights เสมอ
การตั้งค่าผู้เช่าข้อมูลเมตาการดําเนินงาน
การตั้งค่าผู้เช่าในพอร์ทัลผู้ดูแลระบบ Fabric จะควบคุมว่าตัวแทนข้อมูล Fabric จะส่งเมตาดาต้าการดําเนินงานเพื่อความสามารถในการสังเกตการณ์ใน Foundry หรือไม่ การตั้งค่าจะเปิดอยู่โดยค่าเริ่มต้น
การตั้งค่าจะส่งเฉพาะข้อมูลเมตาการดําเนินงานเท่านั้น ข้อมูลเมตานี้ประกอบด้วยชื่อที่แสดงของตัวแทน ชื่อแหล่งข้อมูล รหัสขั้นตอนการให้เหตุผล และรหัสการสนทนา Fabric ไม่ส่งเนื้อหาของลูกค้า ข้อความแจ้งของผู้ใช้และการตอบกลับของตัวแทนข้อมูลจะอยู่ภายในขอบเขตการปฏิบัติตามข้อกําหนดของ Fabric และไม่รวมอยู่ในการวัดและส่งข้อมูลทางไกลนี้
หมายเหตุ
ผู้ดูแลระบบ Fabric สามารถปิดสําหรับผู้เช่าได้ การเปลี่ยนแปลงการตั้งค่าผู้เช่าอาจใช้เวลาถึงหนึ่งชั่วโมงจึงจะมีผล
การตั้งค่าอ่านได้ดังนี้
ตัวแทนข้อมูล Fabric สามารถส่งข้อมูลเมตาการดําเนินงานเพื่อการสังเกตการณ์ใน Microsoft Foundry
ผู้สร้างตัวแทนสามารถใช้ข้อมูลเมตาการดําเนินงานเพื่อตรวจสอบสถานภาพของตัวแทน ตรวจหาปัญหา และทําความเข้าใจว่าเอเจนต์ที่เผยแพร่ของตนถูกใช้อย่างไรในแอปพลิเคชันและบริการต่างๆ ข้อมูลเชิงลึกเหล่านี้ช่วยให้ผู้สร้างตัวแทนปรับปรุงความน่าเชื่อถือและประสิทธิภาพของตัวแทน
เมื่อคุณเปิดการตั้งค่านี้ ตัวแทนข้อมูล Fabric จะส่งข้อมูลเมตาการดําเนินงานไปยังทรัพยากร Application Insights ที่กําหนดค่าไว้สําหรับการประมวลผลและการจัดเก็บ ข้อมูลนี้รวมถึงชื่อที่แสดงของตัวแทน ชื่อแหล่งข้อมูล รหัสขั้นตอนการให้เหตุผล และรหัสการสนทนา ทรัพยากร Application Insights ที่ประมวลผลและจัดเก็บข้อมูลนี้อาจอยู่นอกภูมิภาคทางภูมิศาสตร์ของผู้เช่า ขอบเขตการปฏิบัติตามข้อกําหนด หรืออินสแตนซ์ระบบคลาวด์แห่งชาติของคุณ
ในการเข้าถึงข้อมูลเมตาการดําเนินงาน คุณต้องมีบทบาทที่มีสิทธิ์ในการอ่าน (เช่น Monitoring Reader หรือ Log Analytics Reader) บนทรัพยากร Application Insights ที่กําหนดค่าไว้ ผู้ใช้ที่มีสิทธิ์เข้าถึงนี้สามารถดูข้อมูลใน Application Insights ได้ ผู้ใช้ยังสามารถดูข้อมูลผ่านโครงการ Foundry ที่เชื่อมต่อกับทรัพยากร Application Insights ที่กําหนดค่าไว้ การเข้าถึงผ่าน Foundry จําเป็นต้องมีการเข้าถึงตามบทบาทไปยังโครงการ Foundry (ผู้ใช้ Foundry หรือสูงกว่า) นอกเหนือจากสิทธิ์การอ่านบนทรัพยากร Application Insights การเข้าถึงโครงการ Foundry เพียงอย่างเดียวไม่รวมถึงการเข้าถึงข้อมูลการวัดและส่งข้อมูลทางไกล
สำคัญ
ทรัพยากร Application Insights ที่จัดเก็บข้อมูลเมตานี้อาจอยู่นอกภูมิภาคทางภูมิศาสตร์ของผู้เช่า ขอบเขตการปฏิบัติตามข้อกําหนด หรืออินสแตนซ์ระบบคลาวด์แห่งชาติของคุณ ตรวจสอบข้อกําหนดด้านถิ่นที่อยู่และการปฏิบัติตามข้อกําหนดของข้อมูลก่อนที่จะเปิดการตั้งค่าไว้