View a markdown version of this page

Activar los mensajes de depuración - Amazon Bedrock AgentCore
Ejemplos de respuestas de puerta de enlace con la depuración activada y desactivada

Activar los mensajes de depuración

Mientras su puerta de enlace esté en desarrollo, puede activar los mensajes de depuración para obtener información sobre los problemas de configuración de destino, incluidos los errores de la función lambda, los errores del autorizador de salida y los errores de validación de los parámetros de especificación de destino. Tras activar los mensajes de depuración, si se produce un problema al invocar la puerta de enlace, la respuesta devolverá mensajes que le ayudarán a realizar la depuración.

Para activar los mensajes de depuración, realiza una de las siguientes acciones:

  • Si usa la AgentCore CLI para crear una puerta de enlace, la depuración se activa automáticamente.

  • Si utiliza la consola AWS de administración para crear una puerta de enlace, la depuración está activada de forma predeterminada. La opción se encuentra en Configuraciones adicionales, en la sección de detalles de la puerta de enlace.

  • Si usa la AWS CLI o un AWS SDK, establezca el exceptionLevel valor como DEBUG cuando realiza una UpdateGatewaysolicitud CreateGatewayo.

Cuando termines de depurar la puerta de enlace, puedes actualizarla para que desactive los mensajes de depuración, de forma que el mensaje al usuario final solo muestre un error interno no especificado.

Para desactivar los mensajes de depuración, realice una de las siguientes acciones:

  • En la consola AWS de administración, expanda Configuraciones adicionales en la sección de detalles de la puerta de enlace cuando cree o edite una puerta de enlace y desactive la casilla de verificación situada junto a la depuración a nivel de excepción.

  • En la AWS CLI o en un AWS SDK, omita el exceptionLevel campo cuando realice una CreateGateway UpdateGateway solicitud para desactivar la depuración.

Ejemplos de respuestas de puerta de enlace con la depuración activada y desactivada

Como ejemplo, supongamos que el usuario no tiene permisos para invocar una función Lambda a la que apunta la puerta de enlace. Una solicitud que llame a esta función devolverá un mensaje diferente en función de si la depuración está activada o desactivada:

  • Depuración activada: se devolvería un mensaje de error detallado en el text campo del contenido y también en el _meta campo de la respuesta, como en el siguiente ejemplo:

    {
  "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
  }
}

  • Depuración desactivada: se devolvería un mensaje de error genérico en el text campo del contenido de la respuesta, como en el siguiente ejemplo:

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