View a markdown version of this page

Erstellen Sie ein AgentCore Gateway mit der CLI - Amazon Grundgestein AgentCore

Erstellen Sie ein AgentCore Gateway mit der CLI

Sie können die AgentCore CLI verwenden, um Gateways mit vereinfachten Befehlen zu erstellen. Die CLI verarbeitet allgemeine Konfigurationen automatisch, einschließlich der Erstellung von IAM-Rollen und der Einrichtung der Autorisierung.

Beispiel
AgentCore CLI

  1. Erstellen Sie ein Gateway ohne Autorisierung:

    agentcore add gateway \
  --name MyGateway \
  --authorizer-type NONE \
  --runtimes MyAgent
agentcore deploy

    Erstellen Sie ein Gateway mit JWT-Autorisierung:

    agentcore add gateway \
  --name MyGateway \
  --authorizer-type CUSTOM_JWT \
  --discovery-url https://your-idp.example.com/.well-known/openid-configuration \
  --allowed-audience your-audience
agentcore deploy

    Die semantische Suche ist standardmäßig aktiviert. Um sie zu deaktivieren, geben Sie die --no-semantic-search Flagge weiter:

    agentcore add gateway \
  --name MyGateway \
  --authorizer-type NONE \
  --runtimes MyAgent \
  --no-semantic-search
agentcore deploy
Interactive

  1. Sie können auch die interaktive AgentCore CLI-Terminal-Benutzeroberfläche verwenden. Führen Sie den Befehl aus, agentcore um die TUI zu öffnen, wählen Sie dann Hinzufügen und dann Gateway aus:

  2. Wählen Sie im Menü „Ressource hinzufügen“ die Option Gateway aus und drücken Sie die Eingabetaste.

    Das TUI-Menü „Ressource hinzufügen“ mit hervorgehobenem Gateway

  3. Geben Sie einen Namen für Ihr Gateway ein und drücken Sie die Eingabetaste.

    TUI-Gateway-Assistent: Name, Schritt mit Texteingabe

  4. Wählen Sie den Autorisierungstyp für Ihr Gateway aus. Wählen Sie „Keine“, „Benutzerdefiniertes JWT“ oder „IAM“ und drücken Sie dann die Eingabetaste.

    Im Schritt Authorizer des TUI-Gateway-Assistenten wird „Keine ausgewählt“ angezeigt

  5. (Optional) Konfigurieren Sie erweiterte Einstellungen wie die semantische Suche und die Debug-Ausnahmestufe. Verwenden Sie die Leertaste, um zwischen den Optionen umzuschalten, und drücken Sie dann die Eingabetaste, um fortzufahren.

    Schritt „Erweiterte Konfiguration“ des TUI-Gateway-Assistenten mit aktivierter semantischer Suche

  6. Überprüfen Sie die Zusammenfassung der Gateway-Konfiguration und drücken Sie zur Bestätigung die Eingabetaste.

    TUI-Gateway-Assistent: Zusammenfassung der Konfiguration überprüfen

Nachdem Sie das Gateway erstellt haben, können Sie mit dem agentcore add gateway-target Befehl Ziele hinzufügen. Weitere Informationen zu CLI-Befehlen finden Sie unter Erste Schritte mit AgentCore Gateway.