Platform Agent monday.com to agent AI, który może wykonywać działania na Twoim koncie, takie jak odczytywanie tablic, tworzenie elementów i zarządzanie obszarami roboczymi. Oprócz Platform MCP możesz teraz łączyć się z Platform Agentem przez protokół Agent2Agent (A2A) - otwarty standard, który umożliwia komunikację między agentami AI i klientami zgodnymi z A2A.

Użyj A2A, gdy chcesz, aby Twój agent lub aplikacja przekazały zadanie Platform Agentowi w języku naturalnym zamiast wywoływać poszczególne narzędzia.

Zasób	URL
Karta agenta	https://api.monday.com/platform-ai-gateway/a2a/platform-agent/.well-known/agent-card.json
Punkt końcowy (JSON-RPC)	https://api.monday.com/platform-ai-gateway/a2a/platform-agent/jsonrpc

Większość klientów A2A potrzebuje tylko URL-a karty agenta. Na podstawie karty odczytują punkt końcowy, obsługiwaną wersję protokołu i wymagania dotyczące uwierzytelniania.

---

Krok 1: Utwórz aplikację monday.com

Wystarczy zrobić to raz.

1. W Centrum deweloperów monday.com utwórz aplikację.
2. W sekcji OAuth i uprawnienia (OAuth & Permissions): * Włącz nowy przepływ OAuth (new OAuth flow) (OAuth 2.1). * Dodaj URL przekierowania. * Wybierz zakresy potrzebne w Twoim przypadku, na przykład me:read, boards:read, boards:write i workspaces:read.
3. Zapisz identyfikator klienta (client ID) i klucz tajny klienta (client secret).

---

Krok 2: Uzyskaj token dostępu użytkownika

Użyj standardowego przepływu autoryzacji OAuth 2.1 z kodem autoryzacyjnym i PKCE (S256). Większość klientów A2A uruchamia ten przepływ automatycznie na podstawie karty agenta.

Punkt końcowy	URL
Metadane serwera autoryzacji	https://auth.monday.com/oauth_ms/.well-known/oauth-authorization-server
Autoryzacja	https://auth.monday.com/oauth2/authorize
Token i odświeżanie	https://auth.monday.com/oauth_ms/oauth/token

Tokeny dostępu wygasają po 24 godzinach. Użyj tokenu odświeżania, aby uzyskać nowy token dostępu.

---

Krok 3: Wyślij wiadomość

Wywołaj metodę SendMessage w punkcie końcowym JSON-RPC. Przekaż token dostępu w nagłówku Authorization.

curl -X POST https://api.monday.com/platform-ai-gateway/a2a/platform-agent/jsonrpc \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"1","role":"ROLE_USER","parts":[{"text":"list my boards"}]}}}'

Odpowiedź agenta znajdziesz w result.message.parts[0].text.

Kontynuuj rozmowę

Aby kontynuować rozmowę, dołącz do kolejnej wiadomości contextId zwrócony w odpowiedzi. Agent pamięta wcześniejsze wiadomości w ramach tego samego kontekstu.

---

Krok 4: Ustaw strefę czasową i włącz pełny dostęp do zapisu (opcjonalnie)

Platform Agent obsługuje rozszerzenie opcji. Aby z niego skorzystać, aktywuj je za pomocą nagłówka A2A-Extensions:

A2A-Extensions: https://developer.monday.com/a2a/extensions/platform-agent-options/v1

Następnie przekaż opcje w polu metadata wiadomości, używając URI rozszerzenia jako klucza:

"metadata": {
  "https://developer.monday.com/a2a/extensions/platform-agent-options/v1": {
    "timezone": "America/New_York",
    "allApiWriteEnabled": true
  }
}

Opcja	Typ	Opis
timezone	String	Nazwa strefy czasowej IANA używana dla dat i godzin. Domyślnie UTC.
allApiWriteEnabled	Boolean	Udostępnia agentowi pełny zestaw narzędzi API monday.com do zapisu. Dostęp nadal ograniczają uprawnienia użytkownika. Domyślnie false.

Po zastosowaniu opcji odpowiedź zawiera ten sam nagłówek A2A-Extensions.

---

Warto wiedzieć

• Odpowiedzi blokujące: Żądanie zwraca wynik po zakończeniu pracy agenta. Zwykle trwa to kilka sekund, ale może zająć około minuty. Strumieniowanie i powiadomienia push nie są jeszcze obsługiwane.
• Kredyty AI: Każda wiadomość zużywa kredyty AI z konta monday.com użytkownika. Liczbę wykorzystanych kredytów zwraca nagłówek odpowiedzi X-Monday-Credits-Used. Na koncie musi być włączona funkcja AI.
• Błędy:
• Brakujący lub nieprawidłowy token zwraca kod HTTP 401.
• Konto z wyłączoną funkcją AI lub użytkownik bez wymaganych uprawnień otrzymuje kod HTTP 403.

---

Powiązane zasoby:

• Tworzenie rozwiązań AI na monday.com
• Tworzenie zewnętrznego agenta
• Łączenie się z serwerem monday MCP
• Uwierzytelnianie