使用者參考資料（預覽）

Overview

可用工具

mcp_graph_getDirectReports

列出目錄中指定使用者的直屬下屬。 你必須提供使用者的物件 ID（GUID）或其 userPrincipalName（類似電子郵件地址的 UPN）。 不要將 me 用作 userIdentifier。

必要參數：

• 使用者識別碼： 使用者的物件 ID（GUID）或 userPrincipalName （UPN）

選擇性參數：

• 選擇：以逗號分隔的回傳屬性清單（例如 id， ， displayNamemail， jobTitle， ） userPrincipalName
• 頂： 每頁需歸還的物品數量

mcp_graph_getMyManager

擷取已登入使用者 (即呼叫者) 的主管。 此端點總是回傳當前使用者上下文的管理者。

選擇性參數：

• select:要傳回的主管屬性清單，以逗號分隔

mcp_graph_getMyProfile

取得登入使用者（呼叫者）的個人資料。 此端點總是回傳當前使用者上下文的個人資料。

選擇性參數：

• 選取： 以逗號分隔的使用者檔案屬性列表
• 展開： 展開相關資料表（例如，管理器， directReports）

mcp_graph_getUserProfile

在目錄中取得指定使用者的個人資料。 你必須提供使用者的物件 ID（GUID）或其 userPrincipalName（類似電子郵件地址的 UPN）。 不要將 me 用作 userIdentifier。 登入使用者請使用 mcp_graph_getMyProfile。

必要參數：

• 使用者識別碼： 使用者的物件 ID（GUID）或 userPrincipalName （UPN）

選擇性參數：

• 選擇： 要回傳的使用者屬性逗號分隔的列表
• 展開： 展開相關資料表（管理器或 directReports）。 每次申請只能擴展一個物業。

mcp_graph_getUsersManager

取得目錄中指定使用者的管理者。 提供使用者的物件 ID（GUID）或其 userPrincipalName（類似電子郵件的 UPN）。 不要將 me 用作 userIdentifier。 登入使用者請使用 mcp_graph_getMyManager。

必要參數：

• 使用者識別碼： 使用者的物件 ID（GUID）或 userPrincipalName （UPN）

選擇性參數：

• select: 要為管理員傳回的以逗號分隔屬性清單，例如 id、displayName、mail、jobTitle、userPrincipalName

mcp_graph_listUsers

取得組織內的使用者名單。 支援查詢選項如 $select、 $filter、 $top$orderby、 。 預設 ConsistencyLevel 是最終的。

選擇性參數：

• 頂部： 只顯示前 n 位 使用者
• 選擇： 要回傳的使用者屬性逗號分隔的列表
• 篩選條件： 依屬性篩選使用者，例如 startswith(displayName,'A')
• Orderby： 依據給定性質排序，例如 displayName
• 搜尋： 用戶可使用的自由文本搜尋。 格式為 「property：value」，例如 displayName:Neha 用來搜尋包含 Neha 的顯示名稱。 支持多個帶有空格的屬性。 備用規則：若$search失敗或未回傳結果，則自動用 重試。$filter
• 計數： 包含項目數量（真或假）
• 一致性等級： 進階查詢必填標頭（預設：最終）

關鍵功能

自我認知

• 取得已登入用戶的個人檔案。
• 取得登入使用者的主管。
• 存取目前使用者的情境資訊。
• 不需要使用者識別碼。

使用者個人檔案

• 可依 ID 或 UPN 檢索任何使用者的個人資料。
• 存取使用者屬性如 displayName、 mail、 jobTitle、 等。
• 展開相關表格，例如 manager 和 directReports。
• 使用 $select 選取屬性。

組織階層

• 取得使用者的主管。
• 取得使用者的直屬部屬。
• 請熟悉報告架構。
• 經理與直屬下屬的關係。

使用者發現

• 列出組織內的使用者。
• 支援自動切換的自由文字搜尋。
• OData 過濾與排序。
• 分頁支援。
• 在結果中計算使用者數。

查詢功能

• 用於屬性選取的 OData $select。
• OData $filter用於使用者過濾。
• 用於相關實體的 OData $expand。
• OData $orderby用於分類。
• 具備後援機制的自由文字 $search。
• 支援最終一致性。

Notes

• 請對已登入的使用者使用 mcp_graph_getMyProfile，不要使用搭配 我 的 mcp_graph_getUserProfile。
• 使用 mcp_graph_getMyManager 表示已登入使用者的主管。
• userIdentifier 必須是物件 ID（GUID）或 userPrincipalName （UPN），不要使用顯示名稱。
• 如果只有顯示名稱，請先使用 mcp_graph_listUsers 查找該使用者。
• $expand 每個請求只能展開一個屬性（manager 或 directReports）。
• 如果搜尋失敗，$search 會自動切換至 $filter。
• 進階查詢需要將 ConsistencyLevel 設定為 eventual。
• 搜尋格式：「 property：value」 ，並加引號。

常見使用案例

查看我的資料

• 用來 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 取得使用者的直接下屬。
• 鏈結呼叫以導覽報告階層。