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 Produkte oder Tools von API-based AI Agent anbieten möchten, die in Amazon Bedrock AgentCore 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:
-
Konvertieren Sie 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-based AI-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:
-
Two-legged OAuth-Authentifizierung mit einer der folgenden Konfigurationen:
-
Client-ID, geheimer Client-Schlüssel und Discovery-URL
-
Client-ID, geheimer Client-Schlüssel, 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.
Anforderungen an die OpenAPI-Spezifikation
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 | |
| multipart/form-Daten | ||
| x-www-form-url-encodiert | ||
| Parameters | Einfache Pfadparameter und grundlegende Abfrageparameter wie /boolesche Typen string/number | Serialisierung komplexer Pfadparameter |
| Komplexe Arrays mit Abfrageparametern | ||
| 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 |
| Min/max Wertevalidierung | ||
| Sicherheit | N/A | Sicherheitsschemata auf Spezifikationsebene |
| Mehrere Sicherheitsschemata | ||
| OAuth 2.0 auf Spezifikationsebene | ||
| API-Schlüssel auf Spezifikationsebene | ||
| HTTP-Basic-Authentifizierung auf Spezifikationsebene | ||
| Konfiguration des Servers | 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 bei AWS Partner Central
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-fähige MCP-Serverprodukte 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.
