Pokaż przypisania (Show Assign, interfejs MCP Platform)
To wewnętrzny komponent interfejsu. Serwer Platform MCP wywołuje go automatycznie - nie wywołuj go bezpośrednio.
show-assign wyświetla w czacie interaktywny interfejs przypisywania z listą elementów i sugerowanymi osobami. Serwer MCP wywołuje to narzędzie, gdy użytkownik chce przypisać zadania, sprawdzić przypisania lub skorzystać z interaktywnego widoku przypisań. Sugestie przypisania uwzględniają szczegóły zadań, takie jak nazwa i kontekst, oraz informacje o osobach, takie jak stanowisko i dostępność.
Przed wywołaniem show-assign serwer MCP zazwyczaj wywołuje list_users_and_teams, aby pobrać prawdziwe identyfikatory i imiona oraz nazwiska użytkowników. Pola user.id i user.name muszą zawierać prawidłowe, niepuste wartości pochodzące od rzeczywistych użytkowników systemu - nie można używać wartości zastępczych ani zmyślonych.
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| title | string |
Tak | Tytuł tablicy lub kontekstu wyświetlany u góry interfejsu przypisywania. |
| assignments | array |
Tak | Tablica obiektów przypisujących elementy do użytkowników. Każdy wpis wymaga pól itemId, itemName oraz obiektu user. |
| assignments[].itemId | string |
Tak | Identyfikator elementu monday.com. Musi być niepustym ciągiem znaków. |
| assignments[].itemName | string |
Tak | Nazwa wyświetlana elementu lub zadania. |
| assignments[].user.id | string |
Tak | Identyfikator użytkownika, któremu przypisujesz element. Musi to być prawdziwy identyfikator użytkownika z konta. |
| assignments[].user.name | string |
Tak | Prawdziwe imię i nazwisko użytkownika, któremu przypisujesz element. |
| assignments[].user.avatarUrl | string |
Nie | Adres URL awatara użytkownika (photo_tiny lub photo_thumb z obiektu użytkownika). |
| assignments[].user.jobTitle | string |
Nie | Stanowisko użytkownika. Ta informacja pomaga tworzyć inteligentne sugestie przypisania. |
Przykład
Wyświetl interfejs przypisywania dla tablicy sprintu:
{
"title": "Q2 Sprint Board",
"assignments": [
{
"itemId": "987654321",
"itemName": "Design new onboarding flow",
"user": {
"id": "12345678",
"name": "Sarah Chen",
"avatarUrl": "https://example.com/avatars/sarah.jpg",
"jobTitle": "Product Designer"
}
},
{
"itemId": "987654322",
"itemName": "Fix login bug on mobile",
"user": {
"id": "23456789",
"name": "Alex Rivera",
"jobTitle": "Frontend Engineer"
}
}
]
}
W interaktywnym panelu widać listę zadań i sugerowane osoby, którym można je przypisać. Jeśli są dostępne, panel wyświetla imię i nazwisko użytkownika, awatar oraz stanowisko. Użytkownicy mogą sprawdzić i potwierdzić przypisania bezpośrednio w interfejsie.
Odpowiednik programowy
Nie ma bezpośredniego odpowiednika API do wyświetlania interfejsu przypisywania - ten komponent działa tylko w interfejsie czatu MCP. Aby programowo przypisać użytkownika do elementu, użyj mutacji change_column_value i wskaż kolumnę osób:
mutation {
change_column_value(
board_id: 12406666,
item_id: 987654321,
column_id: "person",
value: "{\"personsAndTeams\":[{\"id\":12345678,\"kind\":\"person\"}]}"
) {
id
}
}
Więcej informacji znajdziesz w dokumentacji kolumny osób w dokumentacji API monday.com.