Referencje użytkownika (zapowiedź)

Note

Ten artykuł opisuje cechy stosowane w przepływach agentów lub przepływach agentów zasilanych standardową wiązką.

Ważna

Jest to funkcja w wersji zapoznawczej.

• Microsoft udostępnia funkcje w wersji zapoznawczej przed ich oficjalnym wydaniem, aby klienci mogli uzyskać wcześniejszy dostęp i przekazać opinie.
• Funkcje w wersji zapoznawczej mają ograniczone funkcje i nie są przeznaczone do użytku produkcyjnego.
• Microsoft może zmienić nazwy i parametry narzędzia MCP w wersji zapoznawczej. Unikaj zakodowanych na sztywno zależności. Microsoft obsługuje scenariusze.
• Funkcje w wersji zapoznawczej podlegają dodatkowym warunkom użytkowania firmy Microsoft.

Przegląd

Identyfikator serwera	Adres URL na poziomie dzierżawcy	nazwa wyświetlana	Description
mcp_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	User	Narzędzia do samoświadomości i świadomości organizacyjnej. Użyj tego narzędzia, aby uzyskać dostęp do profili użytkowników w swojej organizacji i wykonywać różne działania, takie jak pobieranie Twojego profilu, profilu użytkownika, menedżera użytkownika lub listy jego bezpośrednich podwładnych.

Dostępne narzędzia

mcp_graph_getDirectReports

Wyświetla listę bezpośrednich raportów określonego użytkownika w katalogu. Musisz podać albo identyfikator obiektu użytkownika (GUID), albo jego userPrincipalName (UPN podobny do adresu e-mail). Nie używaj me jako userIdentifier.

Wymagane parametry:

• userIdentifier: Identyfikator obiektu użytkownika (GUID) lub userPrincipalName (UPN)

Note

Nie wysyłaj me jako userIdentifier. Jeśli jest dostępna tylko nazwa wyświetlana, najpierw wyszukaj użytkownika, aby uzyskać userPrincipalName lub identyfikator obiektu.

Parametry opcjonalne:

• Wybierz: Rozdzielona przecinkami lista właściwości do zwrócenia (na przykład id, , displayName, mail, jobTitle, userPrincipalName)
• Maksimum: Liczba elementów do zwrócenia na stronę

mcp_graph_getMyManager

Pobiera menedżera zalogowanego użytkownika (wywołującego). Ten punkt dostępu zawsze zwraca menedżera bieżącego kontekstu użytkownika.

Parametry opcjonalne:

• Wybierz: Lista rozdzielona przecinkami właściwości menedżera do zwrotu

mcp_graph_getMyProfile

Pobiera szczegóły profilu zalogowanego użytkownika (wywołującego). Ten punkt końcowy zawsze zwraca profil bieżącego kontekstu użytkownika.

Parametry opcjonalne:

• wybrać: Rozdzielona przecinkami lista właściwości profilu użytkownika
• Rozwiń: Rozwiń powiązane tabele (na przykład menedżer, directReports)

mcp_graph_getUserProfile

Pobiera profil określonego użytkownika w katalogu. Musisz podać albo identyfikator obiektu użytkownika (GUID), albo jego userPrincipalName (UPN podobny do adresu e-mail). Nie używaj me jako userIdentifier. W przypadku zalogowanych użytkowników użyj polecenia mcp_graph_getMyProfile.

Wymagane parametry:

• userIdentifier: Identyfikator obiektu użytkownika (GUID) lub userPrincipalName (UPN)

Note

Nie wysyłaj mnie. Jeśli jest dostępna tylko nazwa wyświetlana, najpierw wyszukaj użytkownika.

Parametry opcjonalne:

• wybierz: Lista właściwości użytkownika rozdzielona przecinkami, które mają zostać zwrócone
• Rozwiń: Rozwiń powiązaną tabelę (manager OR directReports). Można rozwinąć tylko jedną właściwość na żądanie.

mcp_graph_getUsersManager

Pobiera menedżera określonego użytkownika w katalogu. Podaj albo identyfikator obiektu użytkownika (GUID), albo jego userPrincipalName (UPN podobny do adresu e-mail). Nie używaj me jako userIdentifier. W przypadku zalogowanych użytkowników użyj polecenia mcp_graph_getMyManager.

Wymagane parametry:

• userIdentifier: Identyfikator obiektu użytkownika (GUID) lub userPrincipalName (UPN)

Note

Nie wysyłaj mnie. Jeśli jest dostępna tylko nazwa wyświetlana, najpierw wyszukaj użytkownika.

Parametry opcjonalne:

• Wybierz: Rozdzielona przecinkami lista właściwości, które mają być zwracane dla menedżera, takich jak id, displayName, mail, , jobTitleuserPrincipalName

mcp_graph_listUsers

Pobiera listę użytkowników w organizacji. Obsługuje opcje zapytań, takie jak $select, , $filter$top, $orderby. Wartość domyślna ConsistencyLevel to ostateczna.

Parametry opcjonalne:

• Do góry: Pokaż tylko pierwszych n użytkowników
• wybierz: Lista właściwości użytkownika rozdzielona przecinkami, które mają zostać zwrócone
• Filtr: Filtrowanie użytkowników według właściwości, takich jak startswith(displayName,'A')
• Orderby: Kolejność wyników według danej właściwości, takiej jak displayName
• szukać: Wyszukiwanie bez tekstu dla użytkowników. Format: "property:value", na przykład displayName:Neha, aby wyszukać nazwy wyświetlane zawierające Neha. Obsługuje wiele właściwości ze spacjami. Reguła rezerwowa: jeśli $search nie powiedzie się lub nie zwróci żadnych wyników, automatycznie spróbuj ponownie za pomocą polecenia $filter.
• Liczba: Uwzględnij liczbę elementów (prawda lub fałsz)
• ConsistencyLevel: Wymagany nagłówek dla zapytań zaawansowanych (wartość domyślna: ostateczna)

Kluczowe funkcje

Samoświadomość

• Uzyskaj profil zalogowany użytkownika.
• Pobierz menedżera zalogowanych użytkowników.
• Uzyskaj dostęp do bieżących informacji kontekstowych użytkownika.
• Nie ma potrzeby identyfikatorów użytkowników.

Profile użytkowników

• Pobierz profil dowolnego użytkownika na podstawie identyfikatora lub nazwy UPN.
• Uzyskaj dostęp do właściwości użytkownika, takich jak displayName, mail, jobTitlei inne.
• Rozwiń powiązane tabele, takie jak manager i directReports.
• Wybierz właściwości przy użyciu polecenia $select.

Hierarchia organizacyjna

• Pobierz menedżera użytkownika.
• Pobieranie bezpośrednich raportów użytkownika.
• Nawigowanie po strukturze raportowania.
• Relacje między menedżerem a bezpośrednim podwładnym.

Odnajdywanie użytkowników

• Wpisz użytkowników w organizacji.
• Wyszukiwanie pełnotekstowe z automatycznym mechanizmem awaryjnym.
• Filtrowanie i porządkowanie OData.
• Obsługa stronicowania.
• Zlicz użytkowników w wynikach.

Możliwości zapytań

• OData $select do wybierania właściwości.
• $filter OData na potrzeby filtrowania użytkowników.
• OData $expand dla powiązanych encji.
• Sortowanie za pomocą parametru $orderby w OData.
• Wyszukiwanie pełnotekstowe $search z mechanizmem rezerwowym.
• Obsługa spójności ostatecznej.

Notatki

• Używanie mcp_graph_getMyProfile dla zalogowanego użytkownika, nie mcp_graph_getUserProfile dla mnie.
• Użycie mcp_graph_getMyManager dla menedżera zalogowanego użytkownika.
• userIdentifier musi być ID obiektu (GUID) lub userPrincipalName (UPN), nie używaj nazwy wyświetlanej.
• Jeśli dostępna jest tylko nazwa wyświetlana, najpierw użyj mcp_graph_listUsers, aby wyszukać użytkownika.
• $expand może rozwinąć tylko jedną właściwość na żądanie (manager lub directReports).
• $search ma automatyczny powrót do $filter , jeśli wyszukiwanie nie powiedzie się.
• ConsistencyLevel eventual jest wymagany dla zapytań zaawansowanych.
• Format wyszukiwania: "property:value" z cudzysłowami.

Typowe przypadki użycia

Pobieranie moich informacji

• Użyj mcp_graph_getMyProfile do uzyskania profilu aktualnego użytkownika.
• Użyj mcp_graph_getMyManager do pobrania menedżera obecnego użytkownika.

Znajdowanie użytkownika

• Użyj mcp_graph_listUsers z parametrem wyszukiwania.

  Przykład: search='"displayName:John"' aby znaleźć użytkowników o nazwie John.

• Pobierz userPrincipalName lub identyfikator obiektu z wyników.

Pobieranie szczegółów użytkownika

• Użyj mcp_graph_getUserProfile z userIdentifier.
• Użyj polecenia select , aby uzyskać określone właściwości.
• Użyj expand, aby dołączyć manager lub directReports.

Pobierz strukturę organizacyjną

• Użyj mcp_graph_getUsersManager, aby uzyskać przełożonego użytkownika.
• Użyj mcp_graph_getDirectReports, aby uzyskać listę osób bezpośrednio podlegających użytkownikowi.
• Łączenie wywołań w celu nawigowania po hierarchii raportowania.