เอกสารอ้างอิงสำหรับผู้ใช้ Work IQ (พรีวิว)

สําคัญ

คุณลักษณะนี้เป็นคุณลักษณะพรีวิว

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

ภาพรวม

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

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

mcp_graph_getDirectReports

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

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

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

หมายเหตุ

อย่าส่ง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)

หมายเหตุ

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

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

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

mcp_graph_getUsersManager

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

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

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

หมายเหตุ

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

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

• เลือก: รายการคุณสมบัติที่ใช้จุลภาคเป็นตัวคั่นเพื่อส่งกลับสําหรับผู้จัดการ เช่น 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 ต้องเป็น 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 เพื่อรับคุณสมบัติที่เฉพาะเจาะจง
• ใช้การขยายเพื่อรวม manager หรือ directReports

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

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