Zarządzanie wyzwalaczami agenta (Platform MCP)
Użyj tego narzędzia, aby zarządzać wyzwalaczami przypisanymi do agenta platformy monday.com. Wyzwalacze określają, kiedy agent uruchamia się automatycznie.
To narzędzie działa ze schematem API monday.com dev (preview). W katalogu agent_catalog pojawiają się tylko wyzwalacze, które można dodać programowo. Wyzwalacze OAuth i innych firm (Slack, Gmail, Salesforce itp.) wymagają konfiguracji przez użytkownika w interfejsie monday.com i nie można nimi zarządzać tutaj.
| Akcja | Wymagane pola | Opis |
|---|---|---|
list |
agent_id |
Zwraca aktywne wyzwalacze wraz z node_id, block_reference_id, nazwą i podsumowaniem pól. |
add |
agent_id, block_reference_id |
Przypisuje do agenta typ wyzwalacza. |
remove |
agent_id, node_id |
Odpina instancję wyzwalacza na podstawie node_id (nie block_reference_id). |
Aby dodać wyzwalacz: wywołaj w agent_catalog action: "list_triggers", aby znaleźć block_reference_id, field_schemas i required_fields; zbierz od użytkownika wymagane wartości pól, a następnie wywołaj action: "add". Odpowiedź add zawiera tylko { success } - jeśli potrzebujesz node_id nowej instancji, wywołaj później action: "list".
Parametry
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
| action | enum |
Tak | Jedna z wartości: list, add, remove. |
| agent_id | string |
Tak | Unikalny identyfikator agenta. |
| block_reference_id | string |
Warunkowo | Wymagany dla add. Wartość block_reference_id typu wyzwalacza pobrana z agent_catalog za pomocą action: "list_triggers". Nigdy nie zgaduj tej wartości. |
| field_values | object |
Nie | Używane z add, gdy typ wyzwalacza ma wymagane pola. Obiekt klucz-wartość o strukturze opisanej przez field_schemas w katalogu. Pola skalarne przyjmują wartości typu string/number/boolean; pola wyboru przyjmują wartość w formacie {'{ "value": ". |
| node_id | string |
Warunkowo | Wymagany dla remove. Wartość node_id instancji wyzwalacza - pobierz ją za pomocą action: "list". Każda instancja ma unikalne node_id. |
Przykłady
Wyświetl wyzwalacze przypisane do agenta:
{
"action": "list",
"agent_id": "7"
}
Dodaj wyzwalacz za pomocą odwołania z katalogu:
{
"action": "add",
"agent_id": "7",
"block_reference_id": "status-change-ref",
"field_values": { "board_id": "42" }
}
Usuń instancję wyzwalacza:
{
"action": "remove",
"agent_id": "7",
"node_id": "node-abc"
}
Powiązane narzędzia
- agent_catalog - znajdź dostępne typy wyzwalaczy i wymagane dla nich
field_values. - manage_agent_skills - zarządzaj umiejętnościami, z których może korzystać agent.
- manage_agent - zarządzaj samym agentem.
Odpowiednik programowy
To narzędzie odpowiada zapytaniu agent_active_triggers oraz mutacjom add_trigger_to_agent / remove_trigger_from_agent w schemacie API monday.com dev (preview). Nie ma jeszcze stabilnego, publicznego odpowiednika w GraphQL.