Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Amazon Bedrock Gateway AgentCore
Dieses Dokument enthält Informationen für AWS Marketplace Verkäufer, die API-basierte AI-Agent-Produkte oder -Tools anbieten möchten, die in Amazon AgentCore Bedrock Gateway integriert werden können.
-Übersicht
Amazon Bedrock AgentCore Gateway unterstützt Entwickler dabei, Tools in großem Umfang zu entwickeln, bereitzustellen, zu entdecken und Verbindungen zu ihnen herzustellen. Der Service ermöglicht Ihnen:
-
Konvertierung APIs, Lambda-Funktionen und bestehende Dienste in Model Context Protocol (MCP) -kompatible Tools
-
Stellen Sie Tools für Agenten über Gateway-Endpunkte zur Verfügung
-
Nutzen Sie eine umfassende Eingangs- und Ausgangsauthentifizierung in einem vollständig verwalteten Service
KI-Agenten verwenden diese Tools, um Aufgaben wie die folgenden auszuführen:
-
Datenbanken abfragen
-
Senden von Nachrichten
-
Dokumente analysieren
Weitere Informationen finden Sie im Amazon Bedrock AgentCore Developer Guide.
Integration mit Bedrock Gateway AgentCore
Sie können die Amazon Bedrock AgentCore Gateway-Integration für Ihre SaaS-API-basierten KI-Agentenprodukte je nach Produkt auf eine der folgenden Arten aktivieren:
-
Wenn Sie einen MCP-Server anbieten, der die zweistufige OAuth Authentifizierung unterstützt, können Sie sich dafür entscheiden, Ihren Käufern die Integration ohne zusätzliche Anforderungen anzubieten. Der MCP-Serverendpunkt, den Sie im Rahmen Ihres Angebotsprozesses angeben, wird für die Integration verwendet. Sie müssen jedoch sicherstellen, dass Ihr MCP-Server die unten aufgeführten Anforderungen erfüllt. Weitere Informationen finden Sie unter MCP-Serverziele.
Für alle anderen Agenten oder Tools können Sie eine OpenAPI-Spezifikation angeben, um die Integration zu ermöglichen.
MCP-Serveranforderungen
Ihr MCP-Server muss die folgenden Anforderungen erfüllen:
-
Zweibeinige OAuth Authentifizierung mit einer der folgenden Konfigurationen:
-
Client-ID, geheimer Client-Schlüssel und Discovery-URL
-
Client-ID, Client-Geheimnis, Aussteller, Autorisierungsendpunkt und Token-Endpunkt.
-
-
Der MCP-Server muss über Toolfunktionen verfügen.
-
Unterstützte MCP-Protokollversionen: 2025-06-18 und 2025-03-26.
-
Für die angegebene URL oder den Endpunkt des Servers sollte die URL codiert sein. Das Gateway verwendet dieselbe URL, um den Server aufzurufen.
OpenAPI-Spezifikationsanforderungen
Ihre OpenAPI-Spezifikation muss:
-
operationIdFelder für alle Operationen einschließen -
Seien Sie frei von semantischen Fehlern
-
Fügen Sie eine gültige sichere Endpunkt-URL (https) in das Serverattribut ein
Die folgende Tabelle zeigt unterstützte und nicht unterstützte OpenAPI-Funktionen:
| Kategorie | Unterstützt | Nicht unterstützt |
|---|---|---|
| Version | 3.0 und 3.1 | 2 |
| Schemadefinitionen | Grundlegende Datentypen (Zeichenfolge, Zahl, Boolean usw.) | Eine der Spezifikationen |
| Feldvalidierung erforderlich | Beliebige OF-Spezifikationen | |
| Verschachtelte Objekte | ||
| Arrays mit Artikelspezifikationen | ||
| Standard-HTTP-Methoden | ||
| Medientypen | application/json | Benutzerdefinierte Medientypen |
| application/xml | Binäre Medientypen | |
| mehrteilige Daten/Formulardaten | ||
| x-www-form-urlencoded | ||
| Parameters | Einfache Pfadparameter und grundlegende Abfrageparameter wie Typen string/number/boolean | Serialisierung komplexer Pfadparameter |
| Komplexe Abfrageparameter-Arrays | ||
| Serialisierung von Header-Parametern | ||
| Serialisierung von Cookie-Parametern | ||
| Anforderung und Antwort | JSON-Körper | |
| XML-Körper | ||
| Standard-HTTP-Statuscodes | ||
| Validierung | Grundlegende Feldvalidierung | Überprüfung des Regex-Musters |
| Validierung des Min-/Max-Werts | ||
| Sicherheit | – | Sicherheitsschemata auf Spezifikationsebene |
| Mehrere Sicherheitsschemata | ||
| OAuth 2.0 auf Spezifikationsebene | ||
| API-Schlüssel auf Spezifikationsebene | ||
| HTTP-Basic-Authentifizierung auf Spezifikationsebene | ||
| Serverkonfiguration | Grundlegende URL | |
| URL mit Platzhaltern |
AgentCore Bedrock Gateway aktivieren
Bevor Sie die Gateway-Integration aktivieren, testen Sie Ihre OpenAPI-Spezifikation oder Ihren MCP-Server mit Amazon Bedrock AgentCore Gateway, indem Sie die folgenden Aufgaben ausführen:
Um die Gateway-Integration zu aktivieren
-
Melden Sie sich beim AWS Marketplace Management Portal
an. -
Öffnen Sie die Seite AI-Agenten und Tools
. -
Wählen Sie auf der Registerkarte AI-Agenten und -Tools-Produkte das Produkt aus, das Sie ändern möchten.
-
Wählen Sie in der Dropdownliste Änderungen anfordern die Option Versandoptionen aktualisieren aus.
-
Wählen Sie Tool für die Amazon AgentCore Bedrock-Integration aktivieren.
-
Laden Sie Ihre OpenAPI-Spezifikation hoch. Für zweibeinige OAuth MCP Server-Produkte ist dies nicht erforderlich, und es ist nur der MCP-Endpunkt erforderlich.
-
Wählen Sie Absenden aus.
Nach dem Absenden wird der Status der Anfrage auf der Registerkarte Anfragen als Wird geprüft angezeigt. Wenn die Bearbeitung abgeschlossen ist, ändert sich der Status in Erfolgreich.
