View a markdown version of this page

開啟偵錯訊息 - Amazon Bedrock AgentCore
開啟和關閉偵錯的範例閘道回應

開啟偵錯訊息

當您的閘道正在開發中時，您可以開啟偵錯訊息，以傳回目標組態問題的詳細資訊，包括 lambda 函數錯誤、輸出授權方錯誤、目標規格參數驗證錯誤。開啟偵錯訊息後，如果您叫用閘道時發生問題，回應將傳回訊息以協助您偵錯。

若要開啟偵錯訊息，請執行下列其中一項操作：

  • 如果您使用 AgentCore CLI 建立閘道，偵錯會自動開啟。

  • 如果您使用 AWS 管理主控台建立閘道，預設會開啟偵錯。選項位於閘道詳細資訊區段中的其他組態下。

  • 如果您使用 AWS CLI 或 AWS SDK，請將值設定為提出 CreateGateway 或 UpdateGateway 請求DEBUG時exceptionLevel的值。

當您完成偵錯閘道時，您可以更新閘道以關閉偵錯訊息，因此傳送給最終使用者的訊息只會顯示未指定的內部錯誤。

若要關閉偵錯訊息，請執行下列其中一項操作：

  • 在 AWS 管理主控台中，當您建立或編輯閘道時，請在閘道詳細資訊區段中展開其他組態，並取消勾選例外狀況層級偵錯旁的核取方塊。

  • 在 AWS CLI 或 AWS SDK 中，當您發出CreateGateway或UpdateGateway請求關閉偵錯時，請省略 exceptionLevel 欄位。

開啟和關閉偵錯的範例閘道回應

例如，假設使用者沒有叫用閘道目標 Lambda 函數的許可。呼叫此函數的請求會根據偵錯是開啟還是關閉，傳回不同的訊息：

  • 除錯 - 詳細的錯誤訊息會在內容的 text 欄位中傳回，也會在回應的 _meta欄位中傳回，如下列範例所示：

    {
  "jsonrpc": "2.0",
  "id": 24,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Access denied while invoking Lambda function arn:aws:lambda:us-west-2:123456789012:function:TestGatewayLambda. Check the permissions on the Lambda function and Gateway execution role, and retry the request."
      }
    ],
    "_meta": {
      "debug": {
        "type": "text",
        "text": "Access denied while invoking Lambda function arn:aws:lambda:us-west-2:123456789012:function:TestGatewayLambda. Check the permissions on the Lambda function and Gateway execution role, and retry the request."
      }
    },
    "isError": true
  }
}

  • 除錯 – 回應中內容的 text 欄位會傳回一般錯誤訊息，如下列範例所示：

    {
  "jsonrpc": "2.0",
  "id": 24,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "An internal error occurred. Please retry later."
      }
    ],
    "isError": true
  }
}