หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
หมายเหตุ
เครื่องมือนี้พร้อมใช้งานตามค่าเริ่มต้นบนเซิร์ฟเวอร์ MCP ต่อไปนี้: Dynamics 365 Customer Service
เครื่องมือและตัวอย่างในเอกสารนี้แสดงให้เห็นถึงความสามารถในปัจจุบัน ชื่อเครื่องมือ คําอธิบาย พารามิเตอร์ รูปแบบการตอบกลับ และฟังก์ชันการทํางานที่พร้อมใช้งานสามารถเปลี่ยนแปลงได้เมื่อเวลาผ่านไป
เมื่อคุณสร้างเอเจนต์ การผสานรวม หรือตรรกะการประสานรวม อย่าฮาร์ดโค้ดการขึ้นต่อกันกับชื่อเครื่องมือ โครงสร้างพารามิเตอร์ ข้อมูลเมตาของเครื่องมือ หรือสคีมาการตอบสนองที่เฉพาะเจาะจง ให้ออกแบบโซลูชันของคุณเพื่อค้นหาและใช้เครื่องมือที่มีอยู่ในขณะรันไทม์แทน
เมื่อแพลตฟอร์มมีการพัฒนา Microsoft อาจเพิ่ม ลบ เปลี่ยนชื่อ หรือแก้ไขเครื่องมือและข้อมูลเมตาของเครื่องมือ การออกแบบเทียบกับความสามารถแทนที่จะเป็นตัวระบุเครื่องมือเฉพาะจะช่วยรักษาความเข้ากันได้ระหว่างการอัปเดตบริการ
ใช้ความสามารถนี้เมื่อคุณต้องการเปลี่ยนค่าฟิลด์ในเรกคอร์ด Dataverse ใดๆ โดยตรงจากการแชท
การทำงานของมัน
ผู้ช่วยจะอัปเดตฟิลด์อย่างน้อยหนึ่งฟิลด์ในเรกคอร์ดที่คุณระบุ วิธีนี้ใช้ได้กับเอนทิตีชนิดใดก็ได้ รวมถึงลูกค้าองค์กร ผู้ติดต่อ โอกาสทางการขาย ลูกค้าเป้าหมาย และตารางแบบกําหนดเอง คุณบอกผู้ช่วยว่าเรกคอร์ดใดที่จะปรับปรุงและฟิลด์ใดที่จะเปลี่ยนแปลง และใช้การปรับปรุงโดยตรงใน Dynamics 365
สําหรับการอัปเดตเฉพาะกรณีและปัญหา ผู้ช่วยจะใช้เครื่องมือการอัปเดตกรณีและปัญหาเฉพาะที่มีการตรวจสอบความถูกต้องที่สมบูรณ์ยิ่งขึ้น เครื่องมือนี้เป็นทางเลือกสําหรับเอนทิตีชนิดอื่นๆ ทั้งหมด
ลองใช้ข้อความแจ้งเช่น
- "อัปเดตหมายเลขโทรศัพท์ในบัญชี Contoso"
- "เปลี่ยนตําแหน่งงานของจอร์แดนเป็นวิศวกรอาวุโส"
- "กําหนดรายได้โดยประมาณในโอกาสนี้เป็น 50000"
- "อัปเดตที่อยู่อีเมลในรายชื่อติดต่อนี้"
- "เปลี่ยนสถานะในข้อมูลลูกค้านี้เป็นคุณสมบัติ"
- "ตั้งค่าฟิลด์คําอธิบายในเรกคอร์ดนี้"
สิ่งที่คุณจะเห็นในแชท
ผู้ช่วยจะแสดงเรกคอร์ดที่อัปเดตเป็นฟอร์มแบบโต้ตอบในการแชท โดยแสดงฟิลด์หลังจากใช้การอัปเดตแล้ว
เคล็ดลับที่เป็นประโยชน์
- เจาะจงเกี่ยวกับฟิลด์ที่จะเปลี่ยนและค่าใหม่ควรเป็นอย่างไร
- ผู้ช่วยจะขอการยืนยันก่อนใช้การอัปเดต
- คุณสามารถอัปเดตหลายฟิลด์ในคําขอเดียว เช่น "เปลี่ยนโทรศัพท์เป็น 555-0100 และเปลี่ยนเมืองเป็นซีแอตเทิล"
- สําหรับการอัปเดตกรณี เพียงอธิบายการเปลี่ยนแปลงอย่างเป็นธรรมชาติ ผู้ช่วยเลือกเครื่องมือที่เหมาะสม
Tip
หลังจากใช้การอัปเดตแล้ว ผู้ช่วยจะแสดงเรกคอร์ดที่อัปเดตเพื่อให้คุณสามารถตรวจสอบการเปลี่ยนแปลงได้
สิ่งที่จะเกิดขึ้นต่อไป
หลังจากใช้การอัปเดตแล้ว คุณสามารถดําเนินการต่อด้วยข้อความแจ้งเช่น:
- "แสดงบันทึกนี้อีกครั้ง"
- "อัปเดตฟิลด์อื่น"
- "เรกคอร์ดรายการสําหรับชนิดเอนทิตีนี้"
- "เปิดเรกคอร์ดนี้ใน Dynamics 365"
สิ่งนี้เปลี่ยนแปลงข้อมูลหรือไม่
ใช่ สิ่งนี้จะอัปเดตข้อมูลเรกคอร์ด Dataverse
ผู้ช่วยใช้การเปลี่ยนแปลงฟิลด์โดยตรงกับเรกคอร์ด Dataverse ผู้ช่วยขอการยืนยันก่อนทําการเปลี่ยนแปลง
สิ่งที่คุณทําได้จากคอมโพเนนต์แอปในแชท
จากฟอร์มเรกคอร์ดที่อัปเดตในแชท คุณสามารถ:
- ยืนยันว่าการอัปเดตถูกนําไปใช้อย่างถูกต้อง
- ตรวจทานค่าเขตข้อมูลปัจจุบันของระเบียน
- ทํางานกับเรกคอร์ดในแชทต่อไปโดยใช้ข้อความแจ้งติดตามผล
ข้อกำหนดเบื้องต้น
เครื่องมือนี้พร้อมใช้งานบนเซิร์ฟเวอร์ MCP ของ Dynamics 365 Customer Service ดูรายละเอียดในหมายเหตุความพร้อมใช้งานที่ด้านบนของหน้านี้ ไม่จําเป็นต้องมีการกําหนดค่าเพิ่มเติม
สรุปเครื่องมือ
| ทรัพย์สิน | ค่า |
|---|---|
| ชื่อที่ผู้ใช้เห็น | อัปเดตเรกคอร์ดเอนทิตี |
| ชื่อเครื่องมือภายใน | update_entity_record |
| จุดประสงค์ | อัปเดตฟิลด์อย่างน้อยหนึ่งฟิลด์ในเรกคอร์ดเอนทิตี Dataverse โดย GUID |
ลักษณะการทํางานของเครื่องมือ
อัปเดตฟิลด์อย่างน้อยหนึ่งฟิลด์ในเรกคอร์ดเอนทิตี Dataverse โดย GUID ใช้เมื่อเครื่องมืออัปเดตเฉพาะโดเมน (เช่น update_case) ไม่ครอบคลุมฟิลด์หรือเอนทิตีที่ร้องขอ หรือเมื่อเอนทิตีไม่มีเครื่องมืออัปเดตเฉพาะ ทํางานสําหรับลูกค้าองค์กร ผู้ติดต่อ โอกาสทางการขาย ลูกค้าเป้าหมาย ตารางแบบกําหนดเอง และเอนทิตี Dataverse อื่นๆ
คำ อธิบาย
| คำอธิบายประกอบ | ค่า | ความหมาย |
|---|---|---|
readOnlyHint |
false |
เครื่องมือนี้จะแก้ไขข้อมูล |
destructiveHint |
false |
เครื่องมือนี้อัปเดตข้อมูลโดยไม่มีพฤติกรรมการลบแบบฮาร์ดลบ |
idempotentHint |
true |
การโทรซ้ําด้วยอินพุตเดียวกันจะมีผลสุดท้ายเหมือนกัน |
openWorldHint |
ไม่ได้ตั้งค่า | ใช้ค่าเริ่มต้น (คิวรี Dataverse) |
แนวคิดการป้อนข้อมูล
ชนิดเอนทิตี้
| การป้อนข้อมูล | คำอธิบาย | จำเป็นต้องระบุ |
|---|---|---|
entityLogicalName |
entityLogicalName (สตริง จําเป็น) ชื่อตรรกะของเอนทิตี Dataverse (เช่น account, contact, ) opportunity |
ใช่ |
ตัวระบุเรกคอร์ด
| การป้อนข้อมูล | คำอธิบาย | จำเป็นต้องระบุ |
|---|---|---|
recordId |
recordId (สตริง จําเป็น) GUID ของเรกคอร์ดที่จะอัปเดต |
ใช่ |
การอัปเดตฟิลด์
| การป้อนข้อมูล | คำอธิบาย | จำเป็นต้องระบุ |
|---|---|---|
fields |
fields (ต้องมีแผนที่คีย์-ค่า) แมปของชื่อตรรกะของฟิลด์กับค่าใหม่ ตัวอย่าง: { "telephone1": "555-0100", "jobtitle": "Senior Engineer" } |
ใช่ |
การตอบสนองและพฤติกรรม UI
เครื่องมือนี้แสดงฟอร์มแอปในการแชทแบบโต้ตอบที่แสดงเรกคอร์ดที่อัปเดต
เครื่องมือ MCP นี้ได้รับการสนับสนุนโดยแอป MCP
ชนิดของการตอบสนอง
ฟอร์มแบบโต้ตอบ (มุมมองรายละเอียด)
ฟอร์มจะแสดงเรกคอร์ดหลังจากใช้การอัปเดตแล้ว
บันทึกการกําหนดเส้นทาง
ใช้สําหรับ update_entity_record :
- การอัปเดตฟิลด์ในเอนทิตีชนิดใดก็ได้โดยไม่ต้องใช้เครื่องมืออัปเดตเฉพาะ
- การอัปเดตช่องที่ไม่ครอบคลุมโดยเครื่องมืออัปเดตเฉพาะโดเมน
อย่าใช้ update_entity_record เมื่อ:
-
การอัปเดตฟิลด์กรณีและปัญหา - ต้องการ
update_caseสําหรับฟิลด์เฉพาะกรณีและปัญหา -
การลบเรกคอร์ด - กําหนดเส้นทางไปยัง
delete_entity_record
เครื่องมือที่เกี่ยวข้อง
| เครื่องมือ | ความสัมพันธ์ |
|---|---|
get_entity_record |
ดูเรกคอร์ดก่อนหรือหลังการอัปเดต |
get_account |
ดูระเบียนบัญชีก่อนหรือหลังการอัปเดต |
get_contact |
ดูเรกคอร์ดผู้ติดต่อก่อนหรือหลังการอัปเดต |
delete_entity_record |
ลบเรกคอร์ดแทนการอัปเดต |
update_case |
เครื่องมืออัปเดตกรณีและปัญหาเฉพาะพร้อมตรรกะเฉพาะกรณีและปัญหา |
การจําแนกประเภทการกลายพันธุ์ของข้อมูล
การดําเนินการเขียน (ไม่ทําลาย, idempotent)
เครื่องมือนี้จะแก้ไขข้อมูล การอัปเดตจะถูกนําไปใช้โดยตรงกับเรกคอร์ด Dataverse การดําเนินการเป็น idempotent การเรียกซ้ําด้วยอินพุตเดียวกันจะให้ผลลัพธ์เดียวกัน