เริ่มต้นใช้งานเซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator (พรีวิว)

ด้วยการใช้เซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลสําหรับ Microsoft Fabric Activator คุณสามารถเปิดใช้งานผู้ช่วย AI เพื่อโต้ตอบกับ Activator และสร้างกฎการตรวจสอบ จัดการการแจ้งเตือน และทริกเกอร์การดําเนินการ ทั้งหมดนี้ผ่านภาษาธรรมชาติ

เมื่อต้องการเริ่มต้นใช้งานเซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator ให้ทําตามขั้นตอนเหล่านี้:

  1. เชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator จาก Visual Studio Code หรือ GitHub Copilot CLI
  2. กําหนดค่าไคลเอ็นต์ MCP ด้วย URL ของเซิร์ฟเวอร์และการตรวจสอบสิทธิ์
  3. ใช้ GitHub Copilot เพื่อสร้างกฎการตรวจสอบ จัดการการแจ้งเตือน และทริกเกอร์การดําเนินการโดยใช้ภาษาธรรมชาติ
  4. ตรวจสอบการเชื่อมต่อโดยใช้พร้อมท์การทดสอบ

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

ก่อนตั้งค่าและสืบค้นเซิร์ฟเวอร์ 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}%"