หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ด้วยการใช้เซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลสําหรับ Microsoft Fabric Activator คุณสามารถเปิดใช้งานผู้ช่วย AI เพื่อโต้ตอบกับ Activator และสร้างกฎการตรวจสอบ จัดการการแจ้งเตือน และทริกเกอร์การดําเนินการ ทั้งหมดนี้ผ่านภาษาธรรมชาติ
เมื่อต้องการเริ่มต้นใช้งานเซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator ให้ทําตามขั้นตอนเหล่านี้:
- เชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator จาก Visual Studio Code หรือ GitHub Copilot CLI
- กําหนดค่าไคลเอ็นต์ MCP ด้วย URL ของเซิร์ฟเวอร์และการตรวจสอบสิทธิ์
- ใช้ GitHub Copilot เพื่อสร้างกฎการตรวจสอบ จัดการการแจ้งเตือน และทริกเกอร์การดําเนินการโดยใช้ภาษาธรรมชาติ
- ตรวจสอบการเชื่อมต่อโดยใช้พร้อมท์การทดสอบ
ข้อกำหนดเบื้องต้น
ก่อนตั้งค่าและสืบค้นเซิร์ฟเวอร์ MCP โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้
<ค 0>Visual Studio Code
GitHub Copilot ใน Visual Studio Code
รายการ Activator ที่สร้างขึ้นในพื้นที่ทํางาน Fabric
หมายเหตุ รหัสสิ่งประดิษฐ์พื้นที่ทํางานและตัวเปิดใช้งานจาก URL รายการ Fabric สําหรับการกําหนดค่า รูปแบบ URL คือ
https://msit.powerbi.com/groups/<Workspace ID>/reflexes/<Artifact ID>/data/welcome?experience=power-bi&extensionScenario=openArtifact.
การพิสูจน์ตัวตน
เซิร์ฟเวอร์ใช้ OAuth ไคลเอ็นต์ MCP ของคุณต้องได้รับการกําหนดค่าเพื่อรับและส่งผ่านโทเค็น Microsoft Entra ID ที่ถูกต้อง GitHub Copilot รองรับการจัดการโทเค็นนี้โดยอัตโนมัติ
การเชื่อมต่อกับเซิร์ฟเวอร์ Activator MCP
เซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator ทําหน้าที่เป็นปลายทาง MCP ที่ใช้ HTTP
URL ของเซิร์ฟเวอร์
https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/reflexes/<Artifact ID>
| พารามิเตอร์ | คำอธิบาย |
|---|---|
Workspace ID |
รหัสพื้นที่ทํางาน Fabric (UUID) |
Artifact ID |
รหัสสิ่งประดิษฐ์ (สะท้อน) ของ Activator (UUID) |
การกําหนดค่าไคลเอ็นต์ MCP
เพิ่มคําจํากัดความสําหรับเซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator ลงในไฟล์การกําหนดค่าสําหรับไคลเอ็นต์ MCP (ตัวอย่างเช่น mcp.json และการตั้งค่า Visual Studio Code Copilot) ปัจจุบันรองรับเฉพาะการกําหนดค่าด้วยตนเองเท่านั้น
{
"servers": {
"activator": {
"type": "http",
"url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/reflexes/<Artifact ID>"
}
}
}
เครื่องมือที่พร้อมใช้งาน
เซิร์ฟเวอร์ Activator MCP เปิดเผยชุดเครื่องมือที่ตัวแทน AI สามารถใช้เพื่อโต้ตอบกับ Activator เครื่องมือเหล่านี้ใช้ตัวแทนเพื่อสร้างกฎการตรวจสอบ จัดการการแจ้งเตือน และทริกเกอร์การดําเนินการตามข้อมูลแบบเรียลไทม์
การจัดการกฎ
| เครื่องมือ | คำอธิบาย |
|---|---|
create_rule |
สร้างกฎการตรวจสอบที่เฝ้าดูสตรีมข้อมูลและทริกเกอร์การดําเนินการ (อีเมล ข้อความ Microsoft Teams) เมื่อตรงตามเงื่อนไข กฎนี้รองรับฟังก์ชันการตรวจจับตัวเลข ข้อความ บูลีน และการเต้นของหัวใจพร้อมตัวแก้ไขการเกิดขึ้นที่กําหนดค่าได้ มันเริ่มโดยอัตโนมัติ |
list_rules |
แสดงรายการกฎทั้งหมดที่กําหนดไว้ในสิ่งประดิษฐ์ Activator |
start_rule |
เริ่ม (เปิดใช้งาน) กฎเพื่อให้เริ่มการตรวจสอบ |
stop_rule |
หยุด (ปิดใช้งาน) กฎที่กําลังทํางานอยู่ |
โครงสร้างกฎ
กฎการตรวจสอบทุกข้อมีสามส่วนหลัก:
สตรีม: กําหนดข้อมูล ที่จะ ตรวจสอบ
-
splitColumn: จัดกลุ่มตามคอลัมน์สําหรับการตรวจสอบต่อเอนทิตี หรือเว้นว่างไว้สําหรับการตรวจสอบส่วนกลาง -
filters: จํากัดข้อมูลให้แคบลงก่อนการตรวจหา (ตัวอย่างเช่น เฉพาะแถวที่Region == "EU")
-
การตรวจจับ: กําหนดเวลาที่จะทริกเกอร์
-
condition: เงื่อนไขการตรวจสอบ (เช่น ample, "อุณหภูมิเพิ่มขึ้นสูงกว่า 100") -
occurrence: ความถี่ที่ต้องปฏิบัติตามเงื่อนไข (เช่น "ทุกครั้ง" "อยู่ 5 นาที" "สามครั้งใน 10 นาที")
-
การดําเนินการ: กําหนด สิ่งที่ ต้องทําเมื่อเงื่อนไขเริ่มทํางาน (อีเมลหรือข้อความ Teams)
รหัสพื้นที่ทํางานและสิ่งประดิษฐ์
เมื่อคุณสร้างกฎ ให้ระบุ รหัสพื้นที่ทํางาน และ รหัสสิ่งประดิษฐ์ ของรายการ Activator ในพร้อมท์ของคุณ รหัสเหล่านี้เป็นรหัสเดียวกับที่ใช้ใน URL ของเซิร์ฟเวอร์ MCP ผู้ช่วยต้องการให้พวกเขากําหนดเป้าหมายสิ่งประดิษฐ์ Activator ที่ถูกต้อง
การเชื่อมต่อแหล่งข้อมูล
กฎต้องมีแหล่งข้อมูล คุณสามารถระบุการเชื่อมต่อได้สองวิธี:
URL ของคลัสเตอร์สําหรับ Azure Data Explorer และ Kusto: ระบุชื่อโฮสต์และชื่อฐานข้อมูลของคลัสเตอร์ (ตัวอย่างเช่น ชื่อ
https://mycluster.kusto.windows.netโฮสต์และฐานข้อมูลTelemetryDB)บ้านเหตุการณ์ Fabric: ระบุรหัสรายการฐานข้อมูล KQL และรหัสพื้นที่ทํางานแทน URL
ตัวอย่าง: สร้างกฎ
พร้อมท์ตัวอย่าง:
"สร้างกฎที่ตรวจสอบ Metrics ตารางในฐานข้อมูล TelemetryDB eventhouse ของฉัน (คลัสเตอร์: https://mycluster.kusto.windows.net) ส่งอีเมลถึงฉันเมื่อ alice@contoso.com การใช้งาน CPU สูงกว่า 90%"
การตอบสนอง :
เชื่อมต่อผ่าน URL ของคลัสเตอร์ Azure Data Explorer และสร้างincreasesAboveเงื่อนไขบนคอลัมน์ CPU ด้วยการดําเนินการทางอีเมล
พร้อมท์ตัวอย่าง:
"เชื่อมต่อกับฐานข้อมูล KQL ของบ้านเหตุการณ์ (ID รายการ: aabbccdd-1234-5678-abcd-ef0123456789, พื้นที่ทํางาน: 7855032f-a096-4a01-b6de-806aa26ecb00) ตรวจสอบ SensorReadings ตาราง สําหรับแต่ละเครื่อง หากพื้นที่ดิสก์ลดลงต่ํากว่า 10 GB และคงอยู่อย่างนั้นเป็นเวลา 15 นาที ให้ส่งข้อความ Teams ไปที่ bob@contoso.com"
การตอบสนอง :
เชื่อมต่อผ่าน ID ของบ้านเหตุการณ์ Fabric และใช้สําหรับsplitColumnการติดตามต่อเครื่องด้วยการdecreasesBelow/andStaysตรวจจับ
พร้อมท์ตัวอย่าง:
"เมื่อใช้ Heartbeat ตารางในฐานข้อมูล MonitoringDB eventhouse ของฉัน (คลัสเตอร์: https://monitoring.kusto.windows.net) แจ้งเตือนฉันหากไม่มีข้อมูลเป็นเวลา 10 นาที"
การตอบสนอง :
เชื่อมต่อผ่าน URL คลัสเตอร์ Azure Data Explorer และสร้างกฎการเต้นของฮาร์ทบีทโดยใช้noPresenceOfData(600)
พร้อมท์ตัวอย่าง:
"ตรวจสอบAppLogsตารางในบ้านจัดงาน Fabric ของฉัน (ID รายการ: 11223344-aabb-ccdd-eeff-556677889900, พื้นที่ทํางาน: 7855032f-a096-4a01-b6de-806aa26ecb00) หากคอลัมน์สถานะเปลี่ยนเป็น Error มากกว่าสามครั้งใน 5 นาที ให้ส่งอีเมล oncall@contoso.com"
การตอบสนอง :
เชื่อมต่อผ่าน Fabric eventhouse ID และใช้กับchangesToeveryNthTime(3, 300)ตัวแก้ไขการเกิดขึ้น
ตัวอย่าง: จัดการกฎ
ต่อไปนี้เป็นตัวอย่างข้อความแจ้งบางส่วน:
"ระบุกฎทั้งหมดในสิ่งประดิษฐ์นี้"
"หยุดกฎที่เรียกว่า High CPU Alert"
"เริ่มกฎทั้งหมดที่หยุดอยู่ในปัจจุบัน"
ข้อจำกัด
แหล่งข้อมูล KQL เท่านั้น: คุณสามารถสร้างกฎกับฐานข้อมูล KQL สําหรับ Kusto (Azure Data Explorer) หรือบ้านเหตุการณ์ Fabric เท่านั้น แหล่งข้อมูลชนิดอื่นไม่ได้รับการสนับสนุนในขณะนี้
การกําหนดค่าต่อรายการ: URL ของเซิร์ฟเวอร์ MCP ใช้กับอาร์ติแฟกต์ Activator รายการเดียว เมื่อต้องการทํางานกับสิ่งประดิษฐ์หลายรายการ คุณต้องกําหนดค่ารายการเซิร์ฟเวอร์ MCP แยกต่างหากสําหรับแต่ละรายการ
การดําเนินการของ Teams และอีเมลเท่านั้น: กฎสามารถทริกเกอร์ข้อความหรืออีเมลของ Teams ได้ ชนิดการดําเนินการอื่นๆ เช่น เว็บฮุคหรือโฟลว์ Power Automate ไม่พร้อมใช้งานผ่านเซิร์ฟเวอร์ MCP
ไม่มีทริกเกอร์หลายเหตุการณ์: กฎแต่ละข้อจะตรวจสอบสตรีมเหตุการณ์เดียว ทริกเกอร์ที่สัมพันธ์กับสตรีมเหตุการณ์หรือตารางหลายรายการไม่ได้รับการสนับสนุน
ไม่มีการรวมหรือการสรุป: เงื่อนไขการตรวจหาจะทํางานกับแต่ละเหตุการณ์ ฟังก์ชันการรวม เช่น ค่าเฉลี่ย ผลรวม หรือการนับในหน้าต่าง ไม่ได้รับการสนับสนุน
เคล็ดลับ
เชื่อมต่อเซิร์ฟเวอร์ MCP ของอีเวนต์เฮาส์ด้วย: หากแหล่งข้อมูลของคุณเป็นอีเวนต์เฮาส์ Fabric การเชื่อมต่อเซิร์ฟเวอร์ MCP ของอีเวนต์เฮาส์ควบคู่ไปกับ Activator จะช่วยปรับปรุงผลลัพธ์ได้อย่างมาก จากนั้นตัวแทนของคุณสามารถตรวจสอบสคีมาฐานข้อมูล ข้อมูลตัวอย่าง และตรวจสอบความถูกต้องของคิวรี KQL ก่อนสร้างกฎ
เจาะจงเกี่ยวกับคอลัมน์: ผู้ช่วยจําเป็นต้องทราบว่าคอลัมน์ข้อมูลใดที่จะตรวจสอบ หากคุณไม่แน่ใจ ให้ขอให้แสดงรายการสคีมาก่อน (ซึ่งจะง่ายกว่าเมื่อเชื่อมต่อเซิร์ฟเวอร์ MCP ของบ้านเหตุการณ์)
สถานะเทียบกับการเปลี่ยนแปลงมีความสําคัญ: ใช้ "ขึ้นเหนือ" หรือ "ลดลงด้านล่าง" สําหรับการแจ้งเตือนการเปลี่ยนผ่านแบบครั้งเดียว ใช้ "อยู่ด้านบน" หรือ "อยู่ด้านล่าง" สําหรับการแจ้งเตือนซ้ําๆ ในทุกเหตุการณ์ที่ตรงกัน
ใช้ค่าแบบไดนามิกในการดําเนินการ: ใช้ใน
{columnName}อีเมลหรือเนื้อหาข้อความ Teams เพื่อแทรกค่าข้อมูลสด ตัวอย่างเช่น ใช้ "CPU อยู่ที่{cpuPercent}%"