Zarządzanie agentem (Platform MCP)
Użyj tego narzędzia do pełnego zarządzania agentami platformy monday - od utworzenia, przez odczyt i aktualizację, po usunięcie, zmianę stanu i uruchomienie. Agenci platformy monday to tworzone przez użytkowników narzędzia do koordynowania pracy. Każdy ma profil (nazwę, rolę i awatar), cel oraz plan działania zapisany w Markdownie. Agentów w stanie ACTIVE można uruchamiać automatycznie. Nie są to lokalni agenci LangChain ani MCP.
To narzędzie korzysta ze schematu API monday.com w wersji deweloperskiej (preview). Akcja delete jest trwała i nieodwracalna - gdy użytkownik poda agenta z nazwy, zawsze najpierw użyj action: "get", aby potwierdzić właściwy agent_id przed usunięciem.
Parametr action wybiera operację. Przekazuj tylko pola, które dotyczą wybranej akcji.
| Akcja | Wymagane pola | Opis |
|---|---|---|
create |
prompt |
Tworzy agenta wygenerowanego przez AI. Na podstawie promptu platforma generuje profil, cel i plan. |
create_blank |
- | Tworzy agenta zdefiniowanego ręcznie (przekaż name, role itd.). |
get |
agent_id (pomiń, aby wyświetlić listę własnych agentów) |
Pobiera agenta o podanym ID lub wyświetla listę agentów, których jesteś właścicielem. |
update |
agent_id i co najmniej jedno pole, które można zmienić |
Modyfikuje name, role, role_description, plan lub agent_model. |
delete |
agent_id |
Trwale usuwa agenta (nieodwracalnie). |
activate |
agent_id |
Zmienia stan agenta na ACTIVE. |
deactivate |
agent_id |
Zmienia stan agenta na INACTIVE. |
run |
agent_id |
Ręcznie umieszcza uruchomienie agenta w kolejce (bez oczekiwania na wynik). |
Utworzeni agenci domyślnie mają stan INACTIVE. Aby można było ich uruchamiać, użyj następnie action: "activate" i przekaż zwrócony agent_id. Stan agenta to ACTIVE, INACTIVE, ARCHIVED lub FAILED (DELETED pojawia się wyłącznie jako wartość zwracana przez akcję delete).
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| action | enum |
Tak | Jedna z wartości: create, create_blank, get, update, delete, activate, deactivate, run. |
| agent_id | string |
Warunkowo | Wymagany dla akcji update, delete, activate, deactivate i run. Użyj go razem z get, aby pobrać konkretnego agenta. Pomiń go przy get, aby wyświetlić listę własnych agentów. |
| prompt | string |
Warunkowo | Wymagany dla akcji create. Opis w języku naturalnym tego, co agent ma robić. |
| agent_model | enum |
Nie | Używany z akcją create lub update. Pomiń go, chyba że użytkownik wyraźnie poda prawidłowy model obsługiwany przez monday. |
| name | string |
Nie | Używany z akcją create_blank lub update. Nazwa agenta wyświetlana w interfejsie. |
| role | string |
Nie | Używany z akcją create_blank lub update. Krótka nazwa roli (np. "Customer Success Bot"). |
| role_description | string |
Nie | Używany z akcją create_blank lub update. Szczegółowy opis roli agenta. |
| avatar_url | string |
Nie | Używany z akcją create_blank. Adres URL awatara z HTTPS. Preferuj dapulse-res.cloudinary.com lub cdn.monday.com. |
| gender | enum |
Nie | Używany z akcją create_blank. male lub female - wskazówka dotycząca wygenerowanego awatara lub nazwy, jeśli pola profilu nie zostały podane. |
| background_color | string |
Nie | Używany z akcją create_blank. Kod szesnastkowy zapisany małymi literami, np. "#9450fd". |
| user_prompt | string |
Nie | Używany z akcją create_blank. Zapisywany jako metadane; nie jest używany do generowania przez AI. |
| plan | string |
Nie | Używany z akcją update. Nowy plan działania w Markdownie, opisujący kolejne kroki. |
Przykłady
Utwórz agenta wygenerowanego przez AI:
{
"action": "create",
"prompt": "Run my daily standup every weekday at 9am."
}
Aktywuj agenta po utworzeniu:
{
"action": "activate",
"agent_id": "7"
}
Wyświetl listę agentów, których jesteś właścicielem:
{
"action": "get"
}
Powiązane narzędzia
- agent_catalog - przeglądaj dostępne typy wyzwalaczy i umiejętności, zanim przypiszesz je do agenta.
- manage_agent_triggers - zarządzaj wyzwalaczami, które automatycznie uruchamiają tego agenta.
- manage_agent_skills - zarządzaj umiejętnościami, z których może korzystać ten agent.
- manage_agent_knowledge - zarządzaj tablicami i dokumentami, do których ten agent ma dostęp.
Odpowiednik programistyczny
To narzędzie odpowiada mutacjom i zapytaniom dotyczącym agentów w schemacie API monday.com w wersji deweloperskiej (preview) (create_agent, create_blank_agent, agents, update_agent, delete_agent, activate_agent, deactivate_agent, run_agent). Nie ma jeszcze stabilnego, publicznego odpowiednika w GraphQL.