View a markdown version of this page

Ativar mensagens de depuração - Amazon Bedrock AgentCore
Exemplo de respostas do gateway com a depuração ativada e desativada

Ativar mensagens de depuração

Enquanto seu gateway estiver em desenvolvimento, você pode ativar as mensagens de depuração para retornar detalhes sobre problemas de configuração de destino, incluindo erros da função lambda, erros do autorizador de saída e erros de validação do parâmetro de especificação do alvo. Depois de ativar as mensagens de depuração, se ocorrer um problema ao invocar seu gateway, a resposta retornará mensagens para ajudá-lo a depurar.

Para ativar as mensagens de depuração, faça o seguinte:

  • Se você usar a AgentCore CLI para criar um gateway, a depuração será ativada automaticamente.

  • Se você usar o AWS Management Console para criar um gateway, a depuração será ativada por padrão. A opção está em Configurações adicionais na seção Detalhes do gateway.

  • Se você usa a AWS CLI ou um AWS SDK, defina o exceptionLevel valor como DEBUG quando você faz uma CreateGatewaysolicitação or. UpdateGateway

Quando terminar de depurar seu gateway, você pode atualizar o gateway para desativar as mensagens de depuração, de forma que a mensagem para o usuário final mostre apenas um erro interno não especificado.

Para desativar as mensagens de depuração, faça o seguinte:

  • No AWS Management Console, expanda Configurações adicionais na seção Detalhes do gateway ao criar ou editar um gateway e desmarque a caixa de seleção ao lado de Depuração em nível de exceção.

  • Na AWS CLI ou em um AWS SDK, omita o exceptionLevel campo ao fazer uma UpdateGateway solicitação CreateGateway ou para desativar a depuração.

Exemplo de respostas do gateway com a depuração ativada e desativada

Por exemplo, suponha que o usuário não tenha permissões para invocar uma função Lambda que seja direcionada pelo gateway. Uma solicitação que chama essa função retornaria uma mensagem diferente, dependendo se a depuração está ativada ou desativada:

  • Depuração ativada — Uma mensagem de erro detalhada seria retornada no text campo do conteúdo e também no _meta campo da resposta, como no exemplo a seguir:

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

  • Depuração desativada — Uma mensagem de erro genérica seria retornada no text campo do conteúdo na resposta, como no exemplo a seguir:

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