View a markdown version of this page

Crea un AgentCore gateway utilizzando la CLI - Fondamento Amazon AgentCore

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea un AgentCore gateway utilizzando la CLI

È possibile utilizzare la AgentCore CLI per creare gateway con comandi semplificati. La CLI gestisce automaticamente le configurazioni comuni, inclusa la creazione dei ruoli IAM e la configurazione delle autorizzazioni.

Esempio
AgentCore CLI

  1. Crea un gateway senza autorizzazione:

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

    Crea un gateway con autorizzazione 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 ricerca semantica è abilitata per impostazione predefinita. Per disattivarla, passa il --no-semantic-search flag:

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

  1. È inoltre possibile utilizzare l'interfaccia utente interattiva del terminale AgentCore CLI. Esegui agentcore per aprire la TUI, quindi seleziona aggiungi e scegli Gateway:

  2. Nel menu Aggiungi risorsa, seleziona Gateway e premi Invio.

    Menu TUI Add Resource con Gateway evidenziato

  3. Inserisci un nome per il tuo gateway e premi Invio.

    Procedura guidata TUI Gateway Denominazione della fase con immissione di testo

  4. Seleziona il tipo di autorizzazione per il tuo gateway. Scegli Nessuno, JWT personalizzato o IAM , quindi premi Invio.

    TUI gateway wizard (passaggio di autorizzazione) che mostra l'opzione Nessuno selezionato

  5. (Facoltativo) Configura impostazioni avanzate come la ricerca semantica e il livello di eccezione di debug. Usa lo spazio per attivare o disattivare le opzioni, quindi premi Invio per continuare.

    TUI gateway wizard (fase di configurazione avanzata con ricerca semantica abilitata)

  6. Rivedi il riepilogo della configurazione del gateway e premi Invio per confermare.

    Guida guidata del gateway TUI (Revisione del riepilogo della configurazione)

Dopo aver creato il gateway, è possibile aggiungere destinazioni utilizzando il agentcore add gateway-target comando. Per ulteriori informazioni sui comandi CLI, consulta la Guida introduttiva a AgentCore Gateway.