เครื่องมืออ้างอิง MCP Server สําหรับ Customer Insights - Data

เซิร์ฟเวอร์ MCP หนึ่งเครื่องให้บริการทั้ง Customer Insights - Data และ Customer Insights - Journeys ดังนั้นเจ้าหน้าที่ในแอปใดแอปหนึ่งสามารถเรียกใช้เครื่องมือใดก็ได้ที่ระบุไว้ที่นี่

Customer Insights Model Context Protocol (MCP) Server เปิดเผยความสามารถของ Dynamics 365 Customer Insights - Data และ Customer Insights - Journeys ในฐานะเครื่องมือที่สามารถเรียกใช้ได้สําหรับเอเจนต์ AI และไคลเอนต์โมเดลภาษาขนาดใหญ่ (LLM)

มีเซิร์ฟเวอร์ MCP เดียวสําหรับทั้งสองแอป แทนที่จะเรียกใช้ API ภายในโดยตรง ตัวแทนของคุณจะทํางานผ่านอินเทอร์เฟซที่ปลอดภัยเดียวที่ใช้กฎเดียวกับที่ Customer Insights บังคับใช้ในทุกที่ รวมถึงกฎความยินยอมที่บังคับใช้ในระหว่างการดําเนินการเดินทาง

ผ่าน MCP ตัวแทนสามารถ:

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

เครื่องมือโดยสรุป

เครื่องมือ แสดงชื่อเรื่อง การทำงานของมัน อ่านอย่างเดียว
find_customer ค้นหาลูกค้า ค้นหาโปรไฟล์ลูกค้าที่เป็นหนึ่งเดียวโดยใช้ชื่อจริงหรือนามสกุล ใช่
get_customer_by_source_id แก้ไขลูกค้าตามรหัสต้นทาง แก้ไขรหัสลูกค้าแบบรวมจากรหัสระเบียนระบบต้นทาง ใช่
get_customer_by_contact แก้ไขลูกค้าผ่านการติดต่อ แก้ไขรหัสลูกค้าแบบรวมจาก GUID ของผู้ติดต่อ Dataverse ใช่
get_customer_details รับข้อมูลลูกค้า คืนมุมมอง Customer 360 แบบเต็มสําหรับลูกค้าหนึ่งราย ใช่
get_customer_segments รับกลุ่มลูกค้า แสดงรายการกลุ่มลูกค้าที่ลูกค้าเป็นสมาชิก ใช่
get_customer_measures รับมาตรการสําหรับลูกค้า คืนค่าการวัดและตัวชี้วัดที่คํานวณได้ ใช่
get_customer_predictions รับการคาดการณ์ลูกค้า คืนค่าการทํานายการเรียนรู้ของเครื่อง เช่น ความน่าจะเป็นการเลิกใช้ ใช่
get_cluster_information รับข้อมูลคลัสเตอร์ คืนค่าสมาชิกคลัสเตอร์ เช่น ครัวเรือน และสมาชิกอื่น ๆ ใช่
list_data_sources รายการแหล่งข้อมูล แสดงรายการแหล่งข้อมูลที่นําเข้าและจํานวนระเบียนของข้อมูลเหล่านั้น ใช่
check_consent ตรวจสอบความยินยอม ตรวจสอบความยินยอมสําหรับจุดติดต่อ ช่องทาง วัตถุประสงค์ และหัวข้อ ใช่
get_unsubscribe_link รับลิงก์ยกเลิกการรับข่าวสาร สร้างลิงก์ยกเลิกการสมัครที่เป็นไปตามข้อกําหนดสําหรับผู้รับ ใช่
create_journey สร้างการเดินทาง ยืนยัน เติมเต็ม และสร้างเส้นทาง ไม่ใช่
validate_email ตรวจสอบอีเมล ตรวจสอบอีเมลที่มีอยู่โดยไม่ต้องเปลี่ยนแปลง ใช่

create_journey เป็นเครื่องมือเดียวที่เขียนข้อมูล มันไม่ใช่แค่การอ่านอย่างเดียว ไม่ทําลาย หรือทําลายล้าง ดังนั้นการเรียกมันสองครั้งจึงสร้างสองเส้นทาง เครื่องมืออื่น ๆ จะอ่านข้อมูลเท่านั้น

วิธีที่เครื่องมือประกอบกัน

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

ขั้นตอนที่ 1: แก้ไขรหัสลูกค้าแบบรวม

เลือกเครื่องมือที่ตรงกับสิ่งที่คุณรู้เกี่ยวกับลูกค้าอยู่แล้ว:

  • find_customer เมื่อคุณมีชื่อของบุคคล
  • get_customer_by_contact เมื่อคุณมี GUID ติดต่อ Dataverse
  • get_customer_by_source_id เมื่อคุณมี Record ID จากระบบต้นทางที่ถูกนําเข้า เช่น ระบบ loyalty หรือ ERP

หากคุณไม่ทราบชื่อเอนทิตีต้นทางใดที่ถูกต้อง ให้เรียกใช้ list_data_sources ก่อน

ขั้นตอนที่ 2: ดึงข้อมูลลูกค้า

หลังจากที่คุณแก้ไข ID แล้ว ให้เรียกใช้เครื่องมือเหล่านี้:

  • get_customer_details สําหรับโปรไฟล์และแหล่งที่มาของข้อมูลทั้งหมด
  • get_customer_segments สําหรับสมาชิกเซกเมนต์
  • get_customer_measures สําหรับค่าตัวชี้วัดและการวัด
  • get_customer_predictions สําหรับคะแนน AI และการเรียนรู้ของเครื่อง
  • get_cluster_information สําหรับการเป็นสมาชิกคลัสเตอร์

เครื่องมือโปรไฟล์ลูกค้า

เครื่องมือเหล่านี้อ่านข้อมูล จากเอนทิตีเสมือนของ Dataverse ซึ่งสะท้อนข้อมูลลูกค้าแบบรวมศูนย์แบบเรียลไทม์

ค้นหาลูกค้า

find_customer

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

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

แก้ไขลูกค้าตามรหัสต้นทาง

get_customer_by_source_id

แก้ไขรหัสลูกค้าแบบรวมจากตัวระบุระเบียนในระบบต้นทางที่นําเข้ามา ใช้เมื่อคุณมี ID จากแหล่ง เช่น ระบบสะสมคะแนนหรือ ERP และต้องการโปรไฟล์ Customer Insights ที่ตรงกัน

เรียกใช้ list_data_sources ก่อนเพื่อค้นหาชื่อเอนทิตีต้นทางที่ถูกต้อง เช่น contact, lead, หรือตารางที่กําหนดเอง

แก้ไขลูกค้าผ่านการติดต่อ

get_customer_by_contact

แก้ไขรหัสลูกค้าแบบรวมจาก GUID ติดต่อของ Dataverse ใช้เมื่อเวิร์กโฟลว์เริ่มต้นด้วยบันทึกผู้ติดต่อและต้องการโปรไฟล์ Customer Insights ที่เกี่ยวข้อง

เครื่องมือนี้เป็นทางลัดสําหรับget_customer_by_source_idที่เอนทิตีต้นทางตั้งค่าเป็นcontact

รับข้อมูลลูกค้า

get_customer_details

ส่งคืนมุมมอง Customer 360 แบบสมบูรณ์สําหรับลูกค้ารวมหนึ่งราย ผลลัพธ์ประกอบด้วย:

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

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

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

รับกลุ่มลูกค้า

get_customer_segments

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

รับมาตรการสําหรับลูกค้า

get_customer_measures

การคืนสินค้าคํานวณมาตรวัดลูกค้าและตัวชี้วัด KPI เช่น มูลค่าตลอดอายุการใช้งาน จํานวนคําสั่งซื้อ และคะแนนการมีส่วนร่วม เครื่องมือนี้รวมมาตรการที่เก็บไว้ในรูปแบบข้อมูล Customer Insights ที่รองรับให้เป็นผลลัพธ์เดียว

ใช้เพื่อดึงค่ารวม เช่น ยอดซื้อรวม มูลค่าคําสั่งซื้อเฉลี่ย หรือตัวชี้วัดธุรกิจที่กําหนดเอง

รับการคาดการณ์ลูกค้า

get_customer_predictions

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

รับข้อมูลคลัสเตอร์

get_cluster_information

คืนค่าคลัสเตอร์ที่ลูกค้าเป็นสมาชิก พร้อมกับสมาชิกคนอื่น ๆ ของแต่ละคลัสเตอร์และคะแนนความชอบของพวกเขา ประเภทคลัสเตอร์ถูกค้นพบแบบไดนามิกจากเมตาดาต้าโมเดล Customer Insights

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

รายการแหล่งข้อมูล

list_data_sources

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

ไม่จําเป็นต้องป้อนข้อมูล ใช้เครื่องมือนี้เพื่อค้นหาชื่อเอนทิตีต้นทางที่ถูกต้องก่อนที่คุณจะเรียกใช้get_customer_by_source_id

เครื่องมือเหล่านี้มอบหมายงานให้กับบริการความยินยอมหลังบ้านเดียวกับที่ Customer Insights - Journeys ใช้ในการดําเนินการตามเส้นทาง ดังนั้นการตัดสินใจของเจ้าหน้าที่จึงสอดคล้องกับสิ่งที่การเดินทางจะทําเสมอ บริการความยินยอมสามารถทํางานได้อย่างอิสระจากการติดตั้ง Customer Insights เต็มรูปแบบ ดังนั้นเครื่องมือเหล่านี้จึงพร้อมใช้งานแม้ในสภาพแวดล้อมที่มีการติดตั้งเพียง Dynamics 365 Sales หรือ Contact Center เท่านั้น

check_consent

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

กรณีการใช้งานทั่วไป

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

ตัวอย่าง

ตรวจสอบความยินยอมสําหรับจุด +111111111ติดต่อ โปรไฟล์ 7f4a6355-1811-4cde-bde3-fee8c85f56b1การปฏิบัติตามกฎระเบียบ วัตถุประสงค์ Commercial (10000000-0000-0000-0000-000000000003), ชนิดของ SMSช่องทาง หน่วย c507f51d-8f0c-ee11-8f6e-6045bd6ef763ธุรกิจ และหัวข้อ Commercial Topic 001 (23db4a4d-ba9f-f011-bbd3-6045bd194648)

ผลลัพธ์:

พารามิเตอร์ มูลค่า
จุดติดต่อ +111111111
ชนิดช่องทาง SMS
รหัสโปรไฟล์การปฏิบัติตามกฎระเบียบ 7f4a6355-1811-4cde-bde3-fee8c85f56b1
วัตถุประสงค์ เชิงพาณิชย์ (ID: 10000000-0000-0000-0000-0000000003)
หัวข้อ หัวข้อเชิงพาณิชย์ 001 (ID: 23db4a4d-ba9f-f011-bbd3-6045bd194648)
หน่วยธุรกิจ c507f51d-8f0c-ee11-8f6e-6045bd6ef763
ยินยอม ✅ อนุญาต

จุดติดต่อได้รับความยินยอมแบบเลือกเข้าร่วมที่จําเป็นสําหรับ ทั้งหัวข้อเชิงพาณิชย์ และ หัวข้อเชิงพาณิชย์ 001 ดังนั้นการ ส่งข้อความ SMS ไปยังจุดติดต่อนี้จึงได้รับอนุญาตภายใต้การตั้งค่าการปฏิบัติตามข้อกําหนดปัจจุบัน

get_unsubscribe_link

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

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

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

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

กรณีการใช้งานทั่วไป

ตัวแทนการติดต่อจะสร้างข้อความและโทร get_unsubscribe_link เพื่อฝังลิงก์ยกเลิกการติดต่อแบบคลิกเดียวในเนื้อหาข้อความ

ตัวอย่าง

สร้างลิงค์ยกเลิกการสมัครสมาชิกสําหรับจุด +111111111ติดต่อ ชนิด Contact เอนทิตี (f56302b0-875e-f111-a826-7ced8d6d1623), แม่แบบ 226abb7d-855e-f111-a826-7ced8d6d1e7cข้อความ โปรไฟล์ 7f4a6355-1811-4cde-bde3-fee8c85f56b1การปฏิบัติตามกฎระเบียบ วัตถุประสงค์ 10000000-0000-0000-0000-000000000003หัวข้อ 23db4a4d-ba9f-f011-bbd3-6045bd194648และหน่วย c507f51d-8f0c-ee11-8f6e-6045bd6ef763ธุรกิจ

ผลลัพธ์:

พารามิเตอร์ มูลค่า
จุดติดต่อ +111111111
ชนิดเอนทิตี้ ติดต่อ
รหัสเอนทิตี f56302b0-875e-f111-a826-7ced8d6d1623
ID เทมเพลตข้อความ 226abb7d-855e-f111-a826-7ced8d6d1e7c
รหัสโปรไฟล์การปฏิบัติตามกฎระเบียบ 7f4a6355-1811-4cde-bde3-fee8c85f56b1
รหัสวัตถุประสงค์ 10000000-0000-0000-0000-000000000003
รหัสหัวข้อ 23db4a4d-ba9f-f011-bbd3-6045bd194648
รหัสหน่วยธุรกิจ c507f51d-8f0c-ee11-8f6e-6045bd6ef763

ลิงก์ยกเลิกการสมัครที่สร้างขึ้น:

https://public-fra.mkt.dynamics.com/api/v2.0/orgs/7b2fdebc-d216-ee11-a66d-0022483903fc/consent/preferences?contextId=fd436906-0633-42a9-8426-c3a6edca0100

เครื่องมือการเดินทางและอีเมล

สร้างการเดินทาง

create_journey

ตรวจสอบข้อมูลการเดินทาง JSON ทั้งหมด เพิ่มความสมบูรณ์ ตรวจสอบข้อมูลที่เสริมแล้วอีกครั้ง และสร้างบันทึกการเดินทาง Customer Insights - Journeys คําตอบประกอบด้วยรหัสการเดินทางที่สร้างขึ้นและผลการตรวจสอบ

Important

create_journey เป็นเครื่องมือเดียวใน Customer Insights MCP Server ที่สร้างข้อมูล มันไม่ใช่ idempotent ดังนั้นการลองโทรซ้ําเมื่อโทรล้มเหลวอาจสร้างเส้นทางซ้ําได้ ให้เจ้าหน้าที่ของคุณยืนยันผลลัพธ์ก่อนที่จะลองใหม่อีกครั้ง

ตรวจสอบอีเมล

validate_email

ตรวจสอบความถูกต้องของอีเมล Customer Insights - Journeys ที่มีอยู่โดยไม่ต้องแก้ไข คําขอประกอบด้วยอีเมล ข้อความ ส่วนของเนื้อหา ตัวแทน และบริบทการตรวจสอบ คําตอบประกอบด้วยผลการตรวจสอบระดับข้อความและตัวแทน

ใช้มันเพื่อจับปัญหาเนื้อหา เช่น ตัวแทนที่ยังไม่ได้รับการแก้ไข ก่อนที่การเดินทางจะส่งข้อความ

ตัวอย่างเวิร์กโฟลว์

ค้นหาลูกค้าตามชื่อและรับโปรไฟล์แบบเต็ม

  1. โทร find_customerจากนั้นเลือกลูกค้าที่ตรงกันและบันทึกรหัสประจําตัวเดียวกันของพวกเขา
  2. โทร get_customer_details สอบถามข้อมูลโปรไฟล์ กลุ่มเป้าหมาย มาตรการ และแหล่งที่มา

เพิ่มผู้ติดต่อ Dataverse ที่รู้จัก

  1. โทร get_customer_by_contact เพื่อแก้ไขรหัสผู้ติดต่อเป็นรหัสลูกค้าแบบรวม
  2. โทรget_customer_predictionsget_cluster_informationสอบถามคะแนนการเลิกใช้บริการ คะแนนมูลค่าตลอดอายุการใช้งานของลูกค้า และสมาชิกคลัสเตอร์

แก้ไขระเบียนจากระบบต้นทางอื่น

  1. โทร list_data_sources เพื่อค้นหาชื่อเอนทิตีต้นทางที่ถูกต้อง
  2. โทร get_customer_by_source_id เพื่อแก้ไขระเบียนต้นทางเป็นรหัสลูกค้าแบบรวม
  3. การโทร get_customer_segments หรือ get_customer_measures เพื่อบริบทของเซกเมนต์และ KPI

ส่งข้อความที่สอดคล้องกัน

  1. แก้ไขปัญหาลูกค้าด้วยเครื่องมือแก้ไขหนึ่งตัว
  2. โทรเพื่อ check_consent ยืนยันว่าผู้ติดต่อได้เลือกใช้งานตามวัตถุประสงค์ หัวข้อ ช่อง และจุดติดต่อที่คุณต้องการใช้
  3. โทร get_unsubscribe_link เพื่อรับลิงก์การเลือกออกส่วนบุคคล
  4. เขียนและส่งข้อความที่ฝังลิงก์ไว้

สร้างและตรวจสอบการเดินทาง

  1. โทร create_journey พร้อมกับภาระเดินทาง
  2. โทร validate_email ไปที่อีเมลที่การเดินทางใช้เพื่อยืนยันว่าเนื้อหาได้รับการแก้ไขอย่างถูกต้อง

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

เซิร์ฟเวอร์ MCP ข้อมูลเชิงลึกของลูกค้าถูกสร้างขึ้นบนรูปแบบ API แบบกําหนดเอง Dataverse ซึ่งใช้สอง API ที่กําหนดเองสําหรับการโต้ตอบกับเครื่องมือ:

  • เครื่องมือรายการ: ระบุเครื่องมือ MCP ทั้งหมดที่ลงทะเบียนบนเซิร์ฟเวอร์
  • เครื่องมือเรียก: รันเครื่องมือ MCP เฉพาะโดยใช้ชื่อ โดยส่งอาร์กิวเมนต์เป็น JSON

คําจํากัดความของเซิร์ฟเวอร์อยู่ในโซลูชันพื้นฐาน (CxpClient) ซึ่งจัดส่งไปยังทุกองค์กร Dynamics 365 ผู้ให้บริการเครื่องมือจาก Customer Insights - Data และ Customer Insights - Journeys ถูกเพิ่มเข้ามาเป็นส่วนขยายโซลูชัน

ภาพรวมสถาปัตยกรรม

เซิร์ฟเวอร์เป็นไปตามสถาปัตยกรรมแบบชั้น:

  1. ชั้นโพรโทคอล: API แบบกําหนดเองและปลั๊กอิน Dataverse จัดการการปฏิบัติตามโพรโทคอล MCP
  2. ชั้นรีจิสทรี: ค้นหาผู้ให้บริการเครื่องมือที่มีอยู่ขณะรันไทม์ผ่านการค้นหาอัตโนมัติแบบสะท้อนกลับ
  3. เลเยอร์เครื่องมือ: ตัวครอบ MCP ที่ตรวจสอบอินพุตและมอบสิทธิ์ไปยังบริการ
  4. ชั้นบริการ: ตรรกะทางธุรกิจที่เรียกใช้บริการ Customer Insights พื้นฐาน
  5. ชั้นข้อมูล: เอนทิตีเสมือนของ Dataverse และการจัดเก็บข้อมูล Dataverse

Security

เซิร์ฟเวอร์ MCP บังคับใช้ความปลอดภัยในหลายชั้น:

เลเยอร์ คำอธิบาย
ความปลอดภัยการขนส่ง (mTLS) การตรวจสอบสิทธิ์โดยใช้ใบรับรองในชั้นขนส่งร่วมกันระหว่างไคลเอนต์และ Dataverse
สิทธิ์ API แบบกําหนดเอง แพลตฟอร์มจะตรวจสอบสิทธิ์ของผู้ใช้ก่อนที่จะอนุญาตให้ค้นหาหรือรันเครื่องมือ
การตรวจสอบระดับเครื่องมือ แต่ละเครื่องมือจะตรวจสอบสิทธิ์เฉพาะของแต่ละเอนทิตี เช่น การเข้าถึงการอ่านเพื่อวัตถุประสงค์การขอความยินยอม
การรักษาความปลอดภัยระดับข้อมูล ความปลอดภัยระดับแถวช่วยให้ผู้ใช้เข้าถึงเฉพาะข้อมูลที่ได้รับอนุญาตให้ดูเท่านั้น

Note

มีการบังคับใช้การกำหนดสิทธิ์ภายในลอจิกของเครื่องมือโดยใช้บริบทผู้ใช้ของผู้เรียกใช้ เซิร์ฟเวอร์ MCP จะไม่ยกระดับสิทธิ์โดยปริยาย เครื่องมือทําหน้าที่เป็นเพียงภาพลวงตา ไม่เคยทําอะไรเกินกว่าที่ผู้ใช้ที่โทรได้รับอนุญาต

Prerequisites

ก่อนใช้เครื่องมือ โปรดตรวจสอบให้แน่ใจว่าคุณมี:

  • สภาพแวดล้อม Customer Insights ของ Dynamics 365 สําหรับเครื่องมือความยินยอม สภาพแวดล้อม Dynamics 365 ที่มีการปรับใช้ Shared Consent ก็สามารถใช้งานได้ เช่น Dynamics 365 Sales ที่มี Shared Consent
  • การเข้าถึงตาราง Dataverse ที่รองรับเครื่องมือที่คุณวางแผนจะเรียกใช้
  • สําหรับเครื่องมือความยินยอม ควรมีโปรไฟล์การปฏิบัติตามข้อกําหนดอย่างน้อยหนึ่งโปรไฟล์พร้อมวัตถุประสงค์และหัวข้อ โปรไฟล์การปฏิบัติตามมาตรฐานเริ่มต้นประกอบด้วยวัตถุประสงค์ ทางการค้า ที่มีการบังคับใช้แบบจํากัด และวัตถุประสงค์ เชิงธุรกรรม ที่มีการบังคับใช้แบบไม่จํากัด เพื่อให้คุณสามารถเริ่มต้นได้ทันทีโดยไม่ต้องกําหนดค่าเพิ่มเติม
  • สิทธิ์บทบาทความปลอดภัยของ Dataverse ที่เครื่องมือต้องการสําหรับตัวตนของผู้ใช้หรือเอเจนต์

Limitations

คํานึงถึงข้อจํากัดเหล่านี้:

  • เครื่องมือจัดการความยินยอมครอบคลุมการตรวจสอบความยินยอมและการสร้างลิงก์สำหรับยกเลิกการสมัครรับ การอัปเดตความยินยอม การดําเนินการด้านการจัดการ เช่น การสร้างหรือลบวัตถุประสงค์และหัวข้อ และการดึงข้อมูลเมตาของโมเดลความยินยอม จะไม่ถูกเปิดเผยผ่าน MCP
  • ประสิทธิภาพ: การโทรผ่าน MCP อาจมีความหน่วงสูงกว่าการโทรบริการโดยตรงในระหว่างการดําเนินการเส้นทาง นําสิ่งนี้มาพิจารณาเมื่อคุณออกแบบสถานการณ์ที่มีปริมาณงานสูง
  • เซิร์ฟเวอร์ MCP เดียว: เซิร์ฟเวอร์เดียวครอบคลุมทั้ง Customer Insights - Journeys และ Customer Insights - Data และเครื่องมือทั้งหมดใช้ขอบเขตระดับเซิร์ฟเวอร์เดียวกัน การควบคุมการอนุญาตระดับเครื่องมือจะควบคุมการเข้าถึงเครื่องมือแต่ละรายการ

ขั้นตอนต่อไป