View a markdown version of this page

Création d'une AgentCore passerelle à l'aide de la CLI - Base rocheuse de l'Amazonie AgentCore

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'une AgentCore passerelle à l'aide de la CLI

Vous pouvez utiliser l' AgentCore interface de ligne de commande pour créer des passerelles à l'aide de commandes simplifiées. La CLI gère automatiquement les configurations courantes, notamment la création de rôles IAM et la configuration des autorisations.

Exemple
AgentCore CLI

  1. Créez une passerelle sans autorisation :

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

    Créez une passerelle avec l'autorisation JWT :

    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

    La recherche sémantique est activée par défaut. Pour le désactiver, passez le --no-semantic-search drapeau :

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

  1. Vous pouvez également utiliser l' AgentCore interface utilisateur interactive du terminal CLI. Exécutez agentcore pour ouvrir le TUI, puis sélectionnez Ajouter et choisissez Gateway  :

  2. Dans le menu Ajouter une ressource, sélectionnez Gateway et appuyez sur Entrée.

    Menu TUI Ajouter une ressource avec Gateway en surbrillance

  3. Entrez le nom de votre passerelle et appuyez sur Entrée.

    TUI Gateway Wizard Nom de l'étape avec saisie de texte

  4. Sélectionnez le type d'autorisation pour votre passerelle. Choisissez Aucun, Custom JWT ou IAM, puis appuyez sur Entrée.

    Étape d'autorisation de l'assistant de passerelle TUI indiquant « Aucune sélection »

  5. (Facultatif) Configurez les paramètres avancés tels que la recherche sémantique et le niveau d'exception de débogage. Utilisez l'espace pour basculer entre les options, puis appuyez sur Entrée pour continuer.

    Étape de configuration avancée de l'assistant de passerelle TUI avec la recherche sémantique activée

  6. Consultez le résumé de la configuration de la passerelle et appuyez sur Entrée pour confirmer.

    Résumé de la configuration de l'assistant TUI Gateway Review

Après avoir créé la passerelle, vous pouvez ajouter des cibles à l'aide de la agentcore add gateway-target commande. Pour plus d'informations sur les commandes CLI, consultez la section Commencer à utiliser AgentCore Gateway.