Fügen Sie eine API-Gateway-REST-API als Ziel für Amazon Bedrock AgentCore Gateway hinzu - Amazon API Gateway
ÜberlegungenFügen Sie eine API-Stufe als Ziel für ein AgentCore Gateway hinzu

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.

Fügen Sie eine API-Gateway-REST-API als Ziel für Amazon Bedrock AgentCore Gateway hinzu

Ein Amazon Bedrock AgentCore Gateway bietet Entwicklern von KI-Agenten eine sichere Möglichkeit, Ihren API-Gateway-REST APIs als Model Context Protocol (MCP) -kompatible Tools bereitzustellen. AgentCore Gateway verwendet Ziele, um Tools zu definieren. Wenn Sie Ihre Phase als Ziel hinzufügen, wird Ihr Gateway zu einer einzigen MCP-URL, die einem Agenten den Zugriff auf die Tools ermöglicht. Weitere Informationen finden Sie unter API Gateway REST API-Stufen als Ziele im Amazon Bedrock AgentCore Gateway Developer Guide.

API-Gateway-Ziele verbinden Ihr AgentCore Gateway mit Phasen Ihres REST APIs. Sie können die gesamte Phase als Ziel einbeziehen oder Ressourcen auswählen. Nachdem Sie das API-Gateway-Ziel erstellt haben, übersetzt AgentCore Gateway eingehende MCP-Anfragen in HTTP-Anfragen und kümmert sich um die Formatierung der Antwort. MCP-Clients können die API-Dokumentation mithilfe der tools/list Methode abrufen und mithilfe der Methode aufrufen APIs . tools/call

Überlegungen

Die folgenden Überlegungen können sich auf Ihre Verwendung auswirken, wenn Sie einem Gateway eine Phase als Ziel hinzufügen: AgentCore

  • Sie müssen bereits über ein AgentCore Gateway verfügen.

  • Nur öffentliche APIs REST-Dateien werden unterstützt.

  • Der Standardendpunkt Ihrer API kann nicht deaktiviert werden.

  • Für jede Methode Ihrer API muss entweder ein Operationsname definiert sein, oder Sie müssen eine Namensüberschreibung erstellen, wenn Sie Ihre Phase als Ziel hinzufügen. Dieser Name wird als Name des Tools verwendet, mit dem Agenten mit Ihrer Methode interagieren.

  • Sie können die TypenAPI_KEY,NO_AUTH, oder GATEWAY_IAM_ROLE Credential Provider für Outbound Auth verwenden, um Ihrem Gateway den Zugriff auf Ihre API zu ermöglichen. Der Anbieter für API_KEY Anmeldeinformationen wird von Gateway definiert. AgentCore Sie können Ihren vorhandenen API-Gateway-API-Schlüssel verwenden. Weitere Informationen finden Sie unter Outbound Auth einrichten.

  • Wenn Sie einen Amazon Cognito Cognito-Benutzerpool oder einen Lambda-Autorisierer verwenden, um den Zugriff auf Ihre API zu kontrollieren, können MCP-Clients nicht darauf zugreifen.

  • Ihre API muss sich im selben Konto und in derselben Region wie Ihr Gateway befinden. AgentCore

Fügen Sie eine API-Stufe als Ziel für ein AgentCore Gateway hinzu

Das folgende Verfahren zeigt, wie Sie eine API-Stufe als Ziel für ein AgentCore Gateway hinzufügen.

So fügen Sie eine API-Stufe als Ziel für ein AgentCore Gateway hinzu

  1. Melden Sie sich bei der API Gateway Gateway-Konsole unter https://console.aws.amazon.com/apigatewayan.

  2. Wählen Sie eine REST-API aus, die in einer Phase bereitgestellt wird.

  3. Klicken Sie im Hauptnavigationsbereich auf Stufen.

  4. Wählen Sie Stage-Aktionen und dann Create MCP-Ziel aus.

  5. Wählen Sie für AgentCore Gateway ein AgentCore Gateway aus.

  6. Geben Sie unter Zielname einen Zielnamen ein.

  7. Geben Sie unter Zielbeschreibung eine Beschreibung ein.

  8. Behalten Sie die bereitgestellte API und die bereitgestellte Phase bei.

  9. Wählen Sie unter API-Ressourcen auswählen die Ressourcen Ihrer API aus, auf die Agenten, die Ihr AgentCore Gateway verwenden, zugreifen können.

    Wenn Sie keine Ressource auswählen, kann ein Agent die Dokumentation nicht einsehen oder den Endpunkt aufrufen.

  10. Die Kombination aus Ressource und Methode sind die Operationen für das Tool. Wenn Ihre Operation keinen Namen hat, erstellen Sie eine Namensüberschreibung.

    Sie können auch einen Operationsnamen für eine Methode definieren, wenn Sie sie erstellen.

  11. Wählen Sie für die Konfiguration „Outbound Auth“ entweder „IAM-Rolle“, „Keine Autorisierung“ oder „API-Schlüssel“.

  12. Wählen Sie Ziel erstellen.

Um alle AgentCore Gateways anzuzeigen, die Zugriff auf Ihre haben APIs, wählen Sie im Hauptnavigationsbereich den Abschnitt MCP-Ziele aus. In diesem Abschnitt können Sie ein MCP-Ziel für jede API in Ihrer Region erstellen, die in einer Phase bereitgestellt wird. Wählen Sie Create MCP-Ziel aus und folgen Sie den vorherigen Schritten.

Sie können auch die verfügbaren Tools für Ihr Ziel anzeigen und Ihr Ziel in der AgentCore Gateway-Konsole bearbeiten. Weitere Informationen finden Sie unter Ziele zu einem vorhandenen AgentCore Gateway hinzufügen.