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

ใช้เซิร์ฟเวอร์ Remote Model Context Protocol (MCP) สําหรับ ตัวแทนปฏิบัติการ เพื่อกําหนดค่าเป้าหมายและคําสั่ง จัดการแหล่งข้อมูลความรู้และการดําเนินการ สร้างคู่มือ และควบคุมการตรวจสอบผ่านภาษาธรรมชาติ

ตัวแทนการดําเนินงานแสดงจุดสิ้นสุด MCP สองจุด:

• จุดสิ้นสุด การกําหนดค่า สําหรับการอ่านและอัปเดตการตั้งค่าของตัวแทนและสร้างคู่มือการทํางาน
• จุดสิ้นสุด การสืบค้น สําหรับตรวจสอบสถานะของเอเจนต์และการดําเนินการตรวจสอบ

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

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

Prerequisites

ก่อนตั้งค่าและใช้เซิร์ฟเวอร์ MCP โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

• <ค 0>Visual Studio Code

• GitHub Copilot ใน Visual Studio Code

• การเชื่อมต่อแหล่งข้อมูล

• เจ้าหน้าที่ปฏิบัติการในพื้นที่ทํางาน Fabric ที่คุณมีบทบาทเป็นผู้ร่วมสร้างหรือผู้ดูแลระบบ

  โปรดสังเกต Workspace ID และ Operations Agent ID จาก URL รายการ Fabric รูปแบบ URL คือ https://app.fabric.microsoft.com/groups/<Workspace ID>/operationsagents/<Item ID>.

การรับรองความถูกต้อง

เซิร์ฟเวอร์ใช้ OAuth กําหนดค่าไคลเอนต์ MCP ของคุณเพื่อรับและส่งโทเค็น Microsoft Entra ID ที่ถูกต้อง GitHub Copilot จะจัดการโทเค็นนี้โดยอัตโนมัติ

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

เชื่อมต่อกับเซิร์ฟเวอร์ MCP ของเอเจนต์ปฏิบัติการ

แต่ละเอเจนต์ปฏิบัติการจะเปิดเผยจุดสิ้นสุด MCP แบบ HTTP สองจุด: จุดหนึ่งสําหรับการกําหนดค่าและอีกจุดสําหรับการค้นหา

URL ของเซิร์ฟเวอร์

https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/configure
https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/query

การกําหนดค่าไคลเอ็นต์ MCP

เพิ่มคําจํากัดความเซิร์ฟเวอร์ MCP ระยะไกลทั้งสองรายการลงในไฟล์กําหนดค่าไคลเอนต์ MCP ใน Visual Studio Code ให้ใช้.vscode/mcp.jsonสําหรับการกําหนดค่าพื้นที่ทํางาน หรือใช้โปรไฟล์ผู้ใช้ของคุณสําหรับการกําหนดค่าผู้ใช้ สําหรับข้อมูลเพิ่มเติม โปรดดูที่เอกสารอ้างอิงการกําหนดค่า Visual Studio Code MCP

{
  "servers": {
    "operations-agent-configure": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/configure"
    },
    "operations-agent-query": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/workspaces/<Workspace ID>/operationsAgents/<Item ID>/query"
    }
  }
}

เครื่องมือที่พร้อมใช้งาน

เซิร์ฟเวอร์ MCP ของเอเจนต์ปฏิบัติการเปิดเผยเครื่องมือที่เอเจนต์ AI สามารถใช้ในการกําหนดค่าและดําเนินการเอเจนต์ปฏิบัติการ เครื่องมือเหล่านี้กระจายอยู่ในจุดเชื่อมต่อการกําหนดค่าและการค้นหา

กําหนดค่าเซิร์ฟเวอร์

ใช้จุดสิ้นสุดการกําหนดค่าเพื่ออ่านและอัปเดตการตั้งค่าของตัวแทน จัดการแหล่งข้อมูลความรู้และการดําเนินการ

เซิร์ฟเวอร์คิวรี

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

การเชื่อมต่อแหล่งข้อมูล

ตัวแทนการดําเนินงานต้องการแหล่งข้อมูลที่เชื่อมต่อก่อนจึงจะสามารถสร้างคู่มือการเล่นได้ คุณสามารถเชื่อมต่อแหล่งข้อมูลได้สองวิธี:

• Fabric UI: เชื่อมต่อแหล่งข้อมูลจากตัวแก้ไขตัวแทนภายใต้ แหล่งข้อมูล

• เครื่องมือ MCP: ใช้เครื่องมือเพื่อเพิ่มadd_or_update_eventhouse_knowledge_sourceฐานข้อมูล KQL หรือบ้านกิจกรรม หรือadd_or_update_fabric_ontology_knowledge_sourceเพื่อเพิ่มออนโทโลยี Fabric

ตัวอย่าง: กําหนดค่าตัวแทน

พร้อมท์ตัวอย่าง:

"ตั้งค่าคําแนะนําของตัวแทนเป็น: ตรวจสอบความพร้อมของจักรยานที่สถานีทั้งหมดของเราสําหรับความพร้อมของจักรยานที่ต่ํา แจ้งเตือนเมื่อมีจักรยานน้อยกว่า 3 คันที่สถานีใดก็ได้"

การตอบสนอง :

โทร set_agent_instructions และยืนยันว่าคําแนะนําได้รับการอัปเดตแล้ว

พร้อมท์ตัวอย่าง:

"เพิ่มแหล่งความรู้ Eventhouse ที่เรียกมา MyDB เพื่อให้ตัวแทนตรวจสอบข้อมูลจักรยานของฉันได้"

การตอบสนอง :

เรียก add_or_update_eventhouse_knowledge_source และยืนยันว่าแหล่งข้อมูลเชื่อมต่อแล้ว

พร้อมท์ตัวอย่าง:

"เพิ่มการกระทําเพื่อให้เอเจนต์ใช้ <URL หรือคําอธิบายของรายการ> Fabric พร้อมพารามิเตอร์ Location"

การตอบสนอง :

เรียกและ add_or_update_agent_action ยืนยันว่ามีการเพิ่มการดําเนินการโดยเก็บพารามิเตอร์ไว้

ตัวอย่าง: สร้างและตรวจสอบคู่มือการวางแผนกลยุทธ์

พร้อมท์ตัวอย่าง:

"สร้างคู่มือสําหรับตัวแทนนี้"

การตอบสนอง :

เรียกgenerate_playbookและส่งคืน Playbook ID พร้อมสถานะInProgress โดยทั่วไปการสร้างจะใช้เวลาหนึ่งถึงสามนาที

พร้อมท์ตัวอย่าง:

"สถานะการสร้าง playbook คืออะไร"

การตอบสนอง :

การโทร get_generate_playbook_status และรายงานความคืบหน้า ทําซ้ําจนกว่าสถานะจะเป็นCompleted

พร้อมท์ตัวอย่าง:

"แสดงสรุปและกฎของคู่มือการวางแผนให้ฉันดู"

การตอบสนอง :

เรียก get_playbook_summary และ get_playbook_rules ส่งคืนเอนทิตีธุรกิจ อภิธานศัพท์ และกฎการตรวจสอบ

พร้อมท์ตัวอย่าง:

"แสดงรายละเอียดของกฎ playbook แรกให้ฉันดู"

การตอบสนอง :

เรียกใช้ get_rule_details ด้วยรหัสกฎและส่งคืนเงื่อนไขและการผูกแบบเต็ม

ตัวอย่าง: จัดการการตรวจสอบ

ต่อไปนี้เป็นตัวอย่างข้อความแจ้งบางส่วน:

• "สถานะปัจจุบันของเจ้าหน้าที่ปฏิบัติการนี้เป็นอย่างไร"

• "เริ่มตัวแทน"

• "หยุดตัวแทน"

• "แสดงการผ่าตัดล่าสุดให้ฉันดู"

• "รับรายละเอียดเกี่ยวกับการดําเนินการล่าสุด"

• "ให้ภาพที่สมบูรณ์แก่ฉัน: คําแนะนํา แหล่งความรู้ การกระทํา คู่มือการเล่น และสถานะ"

พรอมต์สุดท้ายจะเชื่อมโยงเครื่องมือหลายอย่างในปลายทางทั้งสองและสังเคราะห์ผลลัพธ์เป็นบทสรุปเดียว

ข้อจำกัด

• การกําหนดค่าต่อรายการ: URL ของเซิร์ฟเวอร์ MCP แต่ละคู่จะนําไปใช้กับเอเจนต์การดําเนินการเดียว เมื่อต้องการทํางานกับเอเจนต์หลายตัว คุณต้องกําหนดค่ารายการเซิร์ฟเวอร์ MCP แยกต่างหากสําหรับแต่ละเอเจนต์

• แหล่งข้อมูลที่จําเป็นสําหรับ Playbook: ตัวแทนไม่สามารถสร้าง Playbook ได้จนกว่าจะมีการเชื่อมต่อแหล่งข้อมูลองค์ความรู้อย่างน้อยหนึ่งแหล่ง การพยายามสร้าง Playbook โดยไม่มีแหล่งข้อมูลจะส่งกลับข้อผิดพลาด

• แหล่งข้อมูลความรู้ที่รองรับ: คุณสามารถเชื่อมต่อแหล่งข้อมูลฐานข้อมูล eventhouse หรือ KQL กับแหล่งข้อมูลออนโทโลยีของ Fabric ได้ แหล่งข้อมูลชนิดอื่นไม่ได้รับการสนับสนุนในขณะนี้

• การกําหนดค่าด้วยตนเองเท่านั้น: คุณต้องเพิ่ม URL ของเซิร์ฟเวอร์ MCP ลงในไฟล์การกําหนดค่าไคลเอ็นต์ด้วยตนเอง การค้นหาอัตโนมัติไม่พร้อมใช้งาน

เคล็ดลับ

• เชื่อมต่อเซิร์ฟเวอร์ MCP ของอีเวนต์เฮาส์ด้วย: หากแหล่งข้อมูลของคุณเป็นอีเวนต์เฮาส์ Fabric การเชื่อมต่อเซิร์ฟเวอร์ MCP ของอีเวนต์เฮาส์ควบคู่ไปกับเอเจนต์การดําเนินงานจะช่วยปรับปรุงผลลัพธ์ได้อย่างมาก จากนั้นตัวแทนของคุณสามารถตรวจสอบสคีมาฐานข้อมูล ข้อมูลตัวอย่าง และตรวจสอบความถูกต้องของคิวรี KQL

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

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

• ตรวจสอบสถานะก่อนดําเนินการ: ใช้เพื่อ get_agent_state ยืนยันว่าตัวแทนเป็น Active หรือ Inactive ก่อนที่คุณจะเริ่มหรือหยุดการตรวจสอบ

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

• MCP ใน Real-Time Intelligence (พรีวิว) คืออะไร
• สร้างและกําหนดค่าตัวแทนการดําเนินงาน
• เริ่มต้นใช้งานเซิร์ฟเวอร์ MCP ระยะไกลสําหรับบ้านเหตุการณ์
• เริ่มต้นใช้งานเซิร์ฟเวอร์ MCP ระยะไกลสําหรับ Activator
• เพิ่มและจัดการเซิร์ฟเวอร์ MCP ใน VS Code
• การเพิ่มเซิร์ฟเวอร์ MCP สําหรับ GitHub Copilot CLI