

# 使用 CLI 建立 AgentCore 閘道
<a name="gateway-create-cli"></a>

您可以使用 AgentCore CLI 建立具有簡化命令的閘道。CLI 會自動處理常見的組態，包括 IAM 角色建立和授權設定。

**Example**  

1. 未經授權建立閘道：

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

   使用 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
   ```

   語意搜尋預設為啟用。若要停用它，請傳遞 `--no-semantic-search`旗標：

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

1. 您也可以使用 AgentCore CLI 互動式終端機 UI。執行 `agentcore`以開啟 TUI，然後選取**新增**，然後選擇**閘道** ：

1. 在**新增資源**功能表中，選取**閘道**，然後按 **Enter** 鍵。  
![TUI 新增資源功能表，反白顯示閘道](http://docs.aws.amazon.com/zh_tw/bedrock-agentcore/latest/devguide/images/tui/gateway-add-resource.png)

1. 輸入閘道的名稱，然後按 **Enter** 鍵。  
![TUI 閘道精靈使用文字輸入命名步驟](http://docs.aws.amazon.com/zh_tw/bedrock-agentcore/latest/devguide/images/tui/gateway-add-name.png)

1. 選取閘道的授權方類型。選擇**無** 、**自訂 JWT** 或 **IAM** ，然後按 **Enter**。  
![TUI 閘道精靈 授權方步驟顯示未選取](http://docs.aws.amazon.com/zh_tw/bedrock-agentcore/latest/devguide/images/tui/gateway-add-auth-none.png)

1. （選用） 設定進階設定，例如語意搜尋和偵錯例外狀況層級。使用**空格**切換選項，然後按 **Enter** 繼續。  
![啟用語意搜尋的 TUI 閘道精靈進階組態步驟](http://docs.aws.amazon.com/zh_tw/bedrock-agentcore/latest/devguide/images/tui/gateway-add-advanced.png)

1. 檢閱閘道組態摘要，然後按 **Enter** 鍵確認。  
![TUI 閘道精靈檢閱組態摘要](http://docs.aws.amazon.com/zh_tw/bedrock-agentcore/latest/devguide/images/tui/gateway-add-confirm.png)

建立閘道之後，您可以使用 `agentcore add gateway-target`命令新增目標。如需 CLI 命令的詳細資訊，請參閱 [ AgentCore Gateway 入門](gateway-quick-start.md)。