View a markdown version of this page

Activar la depuración de mensajes - Base amazónica AgentCore
Ejemplo de respuestas de gateway con la depuración activada y desactivada

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Activar la depuración de mensajes

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 del 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 del destino. Tras activar los mensajes de depuración, si se produce un problema al invocar la puerta de enlace, la respuesta mostrará mensajes que te ayudarán a depurar.

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

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

  • Si usa 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 usas la AWS CLI o un AWS SDK, establece el exceptionLevel valor como DEBUG cuando realizas una UpdateGateway solicitud CreateGateway o.

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

Para desactivar la depuración de mensajes, realiza una de las siguientes acciones:

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

  • En la AWS CLI o en un AWS SDK, omite este exceptionLevel campo cuando realices una depuración CreateGateway o UpdateGateway solicites que se desactive.

Ejemplo de respuestas de gateway con la depuración activada y desactivada

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

  • Depuración activada: se mostrarí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: en la respuesta aparecería un mensaje de error genérico en el text campo del contenido, como en el ejemplo siguiente:

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