ข้อมูลอ้างอิงผู้ใช้ (ตัวอย่าง)

Note

บทความนี้อธิบายคุณสมบัติที่ใช้ในเอเจนต์หรือการไหลของเอเจนต์ที่ขับเคลื่อนโดยฮาร์เนสมาตรฐาน

Important

นี่เป็นฟีเจอร์ตัวอย่าง

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

Note

เครื่องมือ MCP Microsoft 365 เฉพาะสําหรับแอปพลิเคชัน (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User และ Word) มีไว้เพื่อความเข้ากันได้ย้อนหลังเท่านั้น และไม่ควรใช้ในสภาพแวดล้อมการผลิตหรือโครงการใหม่ สําหรับโครงการใหม่ที่ต้องการเข้าถึงทรัพยากร Microsoft 365 ให้ใช้ Work IQ MCP ร่วมกับ GitHub Copilot harness สําหรับข้อมูลเพิ่มเติม ดูที่ Work IQ MCP ใน Copilot Studio

Overview

ID ของเซิร์ฟเวอร์	URL ระดับผู้เช่า	ชื่อที่แสดง	คำอธิบาย
mcp_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	ผู้ใช้	เครื่องมือสําหรับความรู้ตนเองและความตระหนักรู้ในองค์กร ใช้เครื่องมือนี้เพื่อเข้าถึงโปรไฟล์ผู้ใช้ในองค์กรของคุณและดําเนินการต่าง ๆ เช่น การรับโปรไฟล์ของคุณ โปรไฟล์ผู้ใช้ ผู้จัดการของผู้ใช้ หรือผู้รายงานตรง

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

mcp_graph_getDirectReports

แสดงรายการรายงานโดยตรงของผู้ใช้ที่ระบุในไดเรกทอรี คุณต้องระบุ ID ออปเจ็กต์ (GUID) ของผู้ใช้หรือ (UPN ที่เหมือนอีเมล) ของพวกเขาuserPrincipalName อย่าใช้ me เป็นuserIdentifier

พารามิเตอร์ที่จําเป็น:

• userIdentifier: ID ออปเจ็กต์ของผู้ใช้ (GUID) หรือ userPrincipalName (UPN)

Note

อย่าส่งmeเป็นuserIdentifier หากมีเพียงชื่อที่แสดง ให้ค้นหาผู้ใช้ก่อนเพื่อให้ได้ userPrincipalName หรือรหัสออบเจ็กต์

พารามิเตอร์ตัวเลือก:

• เลือก: รายการคุณสมบัติที่ใช้จุลภาคเป็นตัวคั่นในการส่งกลับ (ตัวอย่างเช่น id, displayNamemail, , , jobTitle) userPrincipalName
• ด้านบน: จํานวนรายการที่จะแสดงต่อหนึ่งหน้า

mcp_graph_getMyManager

เรียกใช้ผู้จัดการของผู้ใช้ที่ลงชื่อเข้าใช้ (ผู้เรียก) จุดสิ้นสุดนี้จะส่งกลับผู้จัดการของบริบทผู้ใช้ปัจจุบันเสมอ

พารามิเตอร์ตัวเลือก:

• เลือก: รายการคุณสมบัติผู้จัดการที่ใช้จุลภาคเป็นตัวคั่นเพื่อส่งกลับ

mcp_graph_getMyProfile

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

พารามิเตอร์ตัวเลือก:

• เลือก: รายการคุณสมบัติโปรไฟล์ผู้ใช้ที่ใช้จุลภาคเป็นตัวคั่น
• ขยาย: ขยายตารางที่เกี่ยวข้อง (ตัวอย่างเช่น ผู้จัดการ) directReports

mcp_graph_getUserProfile

เรียกใช้โปรไฟล์ของผู้ใช้ที่ระบุในไดเรกทอรี คุณต้องระบุ ID ออปเจ็กต์ (GUID) ของผู้ใช้หรือ (UPN ที่เหมือนอีเมล) ของพวกเขาuserPrincipalName อย่าใช้ me เป็นuserIdentifier สําหรับผู้ใช้ที่ลงชื่อเข้าใช้ ให้ใช้mcp_graph_getMyProfile

พารามิเตอร์ที่จําเป็น:

• userIdentifier: ID ออปเจ็กต์ของผู้ใช้ (GUID) หรือ userPrincipalName (UPN)

Note

อย่าส่ง ฉันมา หากมีเพียงชื่อที่ใช้แสดง ให้ค้นหาผู้ใช้ก่อน

พารามิเตอร์ตัวเลือก:

• เลือก: รายการคุณสมบัติผู้ใช้ที่ใช้จุลภาคเป็นตัวคั่นเพื่อส่งกลับ
• ขยาย: ขยายตารางที่เกี่ยวข้อง (ผู้จัดการ หรือ directReports) สามารถขยายคุณสมบัติได้เพียงหนึ่งรายการต่อคำขอเท่านั้น

mcp_graph_getUsersManager

เรียกใช้ผู้จัดการของผู้ใช้ที่ระบุในไดเรกทอรี ระบุ ID ออบเจ็กต์ของผู้ใช้ (GUID) หรือ (UPN ที่คล้ายกับอีเมล) ของพวกเขาuserPrincipalName อย่าใช้ me เป็นuserIdentifier สําหรับผู้ใช้ที่ลงชื่อเข้าใช้ ให้ใช้mcp_graph_getMyManager

พารามิเตอร์ที่จําเป็น:

• userIdentifier: ID ออปเจ็กต์ของผู้ใช้ (GUID) หรือ userPrincipalName (UPN)

Note

อย่าส่ง ฉันมา หากมีเพียงชื่อที่ใช้แสดง ให้ค้นหาผู้ใช้ก่อน

พารามิเตอร์ตัวเลือก:

• เลือก: รายการคุณสมบัติที่ใช้จุลภาคเป็นตัวคั่นเพื่อส่งกลับสําหรับผู้จัดการ เช่น id, displayName, mail, , jobTitleuserPrincipalName

mcp_graph_listUsers (รายการผู้ใช้กราฟ)

เรียกใช้รายการของผู้ใช้ในองค์กร รองรับตัวเลือกคิวรีเช่น $select, $filter, $top, $orderby ค่าเริ่มต้นของ ConsistencyLevel คือ eventual

พารามิเตอร์ตัวเลือก:

• ด้านบน: แสดงเฉพาะผู้ใช้ n คนแรก
• เลือก: รายการคุณสมบัติผู้ใช้ที่ใช้จุลภาคเป็นตัวคั่นเพื่อส่งกลับ
• ตัว กรอง: กรองผู้ใช้ตามคุณสมบัติ เช่น startswith(displayName,'A')
• orderby: ผลลัพธ์ของลําดับตามคุณสมบัติที่กําหนด เช่น displayName
• ค้นหา: การค้นหาแบบข้อความอิสระสำหรับผู้ใช้ รูปแบบ: "คุณสมบัติ:ค่า" เช่น displayName:Neha เพื่อค้นหาชื่อที่แสดงที่มี Neha รองรับพารามิเตอร์หลายรายการโดยมีช่องว่าง กฎการแสดงแทน: ถ้า $search ล้มเหลว หรือไม่แสดงผลลัพธ์ ให้ลองใหม่โดยอัตโนมัติด้วย$filter
• จำนวน: รวมจํานวนของรายการ (จริงหรือเท็จ)
• ความสอดคล้องกันระดับ: ส่วนหัวที่จําเป็นสําหรับคิวรีขั้นสูง (ค่าเริ่มต้น: ในที่สุด)

คุณลักษณะสำคัญ

การรู้จักตนเอง

• รับโปรไฟล์ของผู้ใช้ที่ลงชื่อเข้าใช้
• ดึงข้อมูลผู้จัดการของผู้ใช้ที่ลงชื่อเข้าใช้อยู่
• เข้าถึงข้อมูลบริบทของผู้ใช้ปัจจุบัน
• ไม่จําเป็นต้องมีตัวระบุผู้ใช้

โปรไฟล์ผู้ใช้

• เรียกใช้โปรไฟล์ของผู้ใช้ใด ๆ ตาม ID หรือ UPN
• เข้าถึงคุณสมบัติของผู้ใช้เช่น displayName, mail, jobTitleและอื่น ๆ
• ขยายตารางที่เกี่ยวข้อง เช่น manager และdirectReports
• เลือกคุณสมบัติโดยใช้$select

ลําดับชั้นขององค์กร

• ดึงข้อมูลผู้จัดการของผู้ใช้
• รับรายงานโดยตรงของผู้ใช้
• นําทางโครงสร้างการรายงาน
• ผู้จัดการและความสัมพันธ์ระหว่างผู้จัดการกับผู้ใต้บังคับบัญชาโดยตรง

การค้นพบผู้ใช้

• แสดงรายชื่อผู้ใช้ในองค์กร
• การค้นหาด้วยข้อความอิสระพร้อมการสลับไปใช้ค่าเริ่มต้นโดยอัตโนมัติ
• การกรอง OData และการจัดลําดับ
• รองรับการแบ่งหน้า
• นับจํานวนผู้ใช้ในผลลัพธ์

ความสามารถในการสืบค้น

• OData $select สำหรับใช้ในการเลือกพร็อพเพอร์ตี
• $filter OData สําหรับการกรองของผู้ใช้
• OData $expand สำหรับเอนทิตีที่เกี่ยวข้อง
• $orderby OData สําหรับการเรียงลําดับ
• การค้นหา $search แบบข้อความอิสระพร้อมกลไกสำรอง
• การสนับสนุนความสอดคล้องกันในที่สุด

หมายเหตุ

• ใช้mcp_graph_getMyProfileสําหรับผู้ใช้ที่ลงชื่อเข้าใช้ ไม่ใช่mcp_graph_getUserProfileกับฉัน
• ใช้ mcp_graph_getMyManager สําหรับผู้จัดการของผู้ใช้ที่ลงชื่อเข้าใช้
• userIdentifier ต้องเป็น object ID (GUID) หรือ userPrincipalName (UPN) ห้ามใช้ชื่อแสดง
• ถ้ามีเพียงชื่อที่แสดงเท่านั้น ให้ใช้ mcp_graph_listUsers เพื่อค้นหาผู้ใช้ก่อน
• $expand สามารถขยายได้เพียงหนึ่งคุณสมบัติต่อคําขอ (manager หรือ directReports) เท่านั้น
• $search มีการย้อนกลับไปใช้ $filter โดยอัตโนมัติหากการค้นหาล้มเหลว
• จําเป็นต้องใช้ ConsistencyLevel eventual สําหรับคิวรีขั้นสูง
• รูปแบบการค้นหา: "คุณสมบัติ:ค่า" พร้อมเครื่องหมายอัญประกาศ

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

รับข้อมูลของฉัน

• ใช้ mcp_graph_getMyProfile เพื่อดึงโปรไฟล์ของผู้ใช้ปัจจุบัน
• ใช้ mcp_graph_getMyManager เพื่อดึงผู้จัดการของผู้ใช้ปัจจุบัน

ค้นหาผู้ใช้

• ใช้ mcp_graph_listUsers ร่วมกับพารามิเตอร์การค้นหา

  ตัวอย่าง: search='"displayName:John"' เพื่อค้นหาผู้ใช้ที่มีชื่อว่า John

• รับ userPrincipalName หรือรหัสออบเจ็กต์จากผลลัพธ์

รับรายละเอียดผู้ใช้

• ใช้ mcp_graph_getUserProfile กับ userIdentifier
• ใช้ select เพื่อรับคุณสมบัติที่เฉพาะเจาะจง
• ใช้ expand เพื่อรวม manager หรือ directReports

รับโครงสร้างองค์กร

• ใช้ mcp_graph_getUsersManager เพื่อรับผู้จัดการของผู้ใช้
• ใช้ mcp_graph_getDirectReports เพื่อรับรายงานโดยตรงของผู้ใช้
• การโทรสายโซ่เพื่อนําทางลําดับชั้นการรายงาน