Wyświetlanie użytkowników i zespołów (Platform MCP)
Użyj tego narzędzia, aby wyszukać użytkowników lub zespoły według identyfikatora, nazwy albo powiązania z bieżącym użytkownikiem. Odpowiedź zawiera profile użytkowników (imię i nazwisko, stanowisko, informację o uprawnieniach administratora i członkostwie w zespołach) oraz szczegóły zespołów (nazwę, właścicieli i opcjonalnie listę członków). Możesz wskazać konkretnego użytkownika za pomocą identyfikatora, wyszukać go po nazwie, pobrać informacje o bieżącym użytkowniku lub wyświetlić określone zespoły.
OBOWIĄZKOWE NAJLEPSZE PRAKTYKI - zawsze stosuj poniższą kolejność priorytetów parametrów:
getMe- używaj, gdy prośba dotyczy bieżącego użytkownika. Ten parametr działa samodzielnie i wyklucza wszystkie pozostałe.userIds- używaj, gdy w kontekście masz konkretne identyfikatory użytkowników. To rozwiązanie ma pierwszeństwo przed wyszukiwaniem po nazwie.name- używaj do wyszukiwania użytkowników według przybliżonej nazwy. Dotyczy wyłącznie użytkowników. Ten parametr działa samodzielnie i nie można łączyć go z innymi. Nie używajnamedo wyszukiwania zespołów - w tym celu użyjteamIds.teamIds+teamsOnly- używaj, gdy masz konkretne identyfikatory zespołów. Jeśli znasz konkretne identyfikatory, nie pobieraj wszystkich zespołów.- Brak parametrów - tylko w ostateczności. Unikaj ogólnych zapytań, które zwracają pełną listę użytkowników i zespołów.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| getMe | boolean |
Nie | Zwraca profil bieżącego użytkownika, w tym informacje o jego członkostwie w zespołach. Najwyższy priorytet - używaj, gdy prośba dotyczy „mnie” lub „moich zespołów”. Wyklucza wszystkie pozostałe parametry. |
| userIds | array |
Nie | Tablica konkretnych identyfikatorów użytkowników do pobrania (maks. 500). Zawsze używaj, gdy identyfikatory użytkowników są dostępne w kontekście. Zwraca profile użytkowników, w tym informacje o ich członkostwie w zespołach. |
| name | string |
Nie | Wyszukiwanie użytkowników według przybliżonej nazwy. Dotyczy wyłącznie użytkowników. Działa samodzielnie - nie można łączyć go z innymi parametrami. Nie używaj go do wyszukiwania zespołów. |
| teamIds | array |
Nie | Tablica konkretnych identyfikatorów zespołów do pobrania (maks. 500). Zawsze używaj, gdy znasz identyfikatory zespołów. Zwraca szczegóły zespołów, w tym informacje o właścicielach i opcjonalnie o członkach. |
| includeTeams | boolean |
Nie | Pobiera wszystkie zespoły na koncie wraz z użytkownikami. Unikaj tej opcji - używaj jej tylko w ostateczności. Aby pobrać zespoły konkretnego użytkownika, wyszukaj tego użytkownika za pomocą userIds. |
| teamsOnly | boolean |
Nie | Zwraca tylko zespoły, bez użytkowników. Połącz z teamIds, aby wyszukać konkretne zespoły, albo z includeTeamMembers, aby pobrać pełne informacje o członkach. |
| includeTeamMembers | boolean |
Nie | Ustaw na true tylko wtedy, gdy potrzebujesz pełnych informacji o członkach zespołów, a nie tylko ich nazw i identyfikatorów. |
Przykład
Pobierz informacje o bieżącym użytkowniku:
{
"getMe": true
}
Narzędzie zwróciło identyfikator bieżącego użytkownika (48202303), imię i nazwisko (Daniel Hai), stanowisko (Product Manager) oraz informacje o uprawnieniach administratora i statusie gościa.
Wyszukaj konkretnych użytkowników według identyfikatora:
{
"userIds": ["48202303", "66347492"]
}
Wyszukaj użytkownika według nazwy:
{
"name": "Daniel"
}
Pobierz konkretne zespoły:
{
"teamIds": ["12345", "67890"],
"teamsOnly": true
}
Odpowiednik programistyczny
Użyj GraphQL API, aby uzyskać ten sam wynik:
query {
users(ids: [48202303]) {
id
name
title
email
is_admin
is_guest
enabled
teams {
id
name
}
}
}
Aby pobrać zespoły, użyj zapytania teams:
query {
teams(ids: [12345]) {
id
name
picture_url
owners {
id
name
}
users {
id
name
}
}
}
Pełną dokumentację znajdziesz na stronach Użytkownicy i Zespoły.