W opisanym wspólnie przez AWS i MoEngage wdrożeniu AgentCore Gateway przekształca operacje wewnętrznych interfejsów REST, opisane w specyfikacjach OpenAPI, w narzędzia MCP dla agentów. Role IAM i polityki Cedar określają, z których narzędzi każdy agent może korzystać, a żądania do wewnętrznych API przechodzą prywatną ścieżką sieciową.

Jak MoEngage zamienia API w narzędzia dla agentów

Zespoły MoEngage dopisują do istniejących specyfikacji OpenAPI adnotację x-moe-mcp. Potok CI sprawdza adnotację, rejestruje cel w bramie i stosuje politykę Cedar. AgentCore Gateway tworzy na tej podstawie narzędzia zgodne z MCP, czyli protokołem wymiany informacji o narzędziach między modelami a aplikacjami.

Wdrożenie obsługuje około 400 zarejestrowanych operacji API i 10 agentów wewnętrznych. To osobne liczby od około 400 wewnętrznych interfejsów REST, które, jak podaje MoEngage, rozwijało 25 zespołów w siedmiu regionach AWS.

Jak role IAM i Cedar ograniczają dostęp

Każdy agent ma własną rolę IAM, czyli tożsamość używaną do uwierzytelniania w AWS. Wewnętrzne żądania do bramy są podpisywane za pomocą SigV4. Polityki Cedar sprawdzają uprawnienia po stronie serwera i sterują zarówno listą narzędzi udostępnianą agentowi, jak i możliwością ich wywołania.

Przykładowo polityka dla agenta sprawdzającego kampanie może pozwalać na narzędzia do odczytu kampanii, a blokować operacje zapisu. Dzięki temu agent otrzymuje dostęp dostosowany do swojego zadania, zamiast automatycznie korzystać z całego katalogu.

Kontekst organizacji, użytkownika, roli i bazy danych jest przekazywany w nagłówkach X-MOE-*, a nie w argumentach narzędzia, które model mógłby zmieniać. Tożsamość najemcy nie jest dołączana do zapytań o listę narzędzi ani do wyszukiwania semantycznego; pojawia się przy wywołaniu tools/call.

Jak żądanie dociera do prywatnego API

Usługi agentów łączą się przez HTTPS z punktem końcowym interfejsu VPC i prywatny DNS. Następnie zarządzane wyjście AgentCore prowadzi przez Amazon VPC Lattice do wewnętrznych API. W opisanej ścieżce nie ma publicznego punktu końcowego.

Tożsamość i uprawnienia są więc obsługiwane osobno od routingu sieciowego: IAM i Cedar decydują o dostępie agenta do narzędzi, a endpoint VPC i VPC Lattice łączą bramę z usługami wewnętrznymi.

Opis dotyczy wewnętrznej bramy. Osobna, publiczna usługa MCP MoEngage korzysta według AWS z tokenów JWT opartych na OIDC w AgentCore Runtime. To odrębny sposób uwierzytelniania, nie ustawienie wewnętrznej ścieżki.

Jak agenci znajdują potrzebne narzędzia

Zamiast przekazywać agentowi pełny katalog, biblioteka kliencka udostępnia narzędzie meta o nazwie search_tools. Agent opisuje zadanie, a wyszukiwanie semantyczne zwraca pasujące narzędzia do dalszej pracy.

Ma to znaczenie przy katalogu obejmującym setki operacji: agent może najpierw znaleźć narzędzia odpowiednie do sprawdzenia kampanii, monitorowania dostarczania wiadomości lub tworzenia segmentu odbiorców, zamiast otrzymywać cały spis. Uprawnienia nadal zależą od roli agenta i polityk Cedar.

Co MoEngage podaje o nakładzie pracy

MoEngage szacuje, że uniknięcie utrzymywania ponad 20 osobnych serwerów MCP i konfigurowania sieci dla każdego API pozwoliło zaoszczędzić około sześciu miesięcy pracy zespołu platformowego. Firma podaje też, że wdrożenie nowego API zajmuje teraz godziny zamiast dni. Są to szacunki i opis procesu przypisane MoEngage.