View a markdown version of this page

Attiva i messaggi di debug - Amazon Bedrock AgentCore
Esempi di risposte del gateway con debug attivato e disattivato

Attiva i messaggi di debug

Mentre il gateway è in fase di sviluppo, puoi attivare i messaggi di debug per restituire dettagli sui problemi di configurazione di destinazione, inclusi errori della funzione lambda, errori dell'autorizzazione in uscita, errori di convalida dei parametri di specificazione del target. Dopo aver attivato i messaggi di debug, se si verifica un problema quando richiami il gateway, la risposta restituirà messaggi per aiutarti a eseguire il debug.

Per attivare i messaggi di debug, esegui una delle seguenti operazioni:

  • Se si utilizza la AgentCore CLI per creare un gateway, il debug viene attivato automaticamente.

  • Se si utilizza la console di AWS gestione per creare un gateway, il debug è attivato per impostazione predefinita. L'opzione si trova in Configurazioni aggiuntive nella sezione Dettagli del gateway.

  • Se utilizzi la AWS CLI o un AWS SDK, imposta il exceptionLevel valore come DEBUG quando effettui una CreateGatewayrichiesta or. UpdateGateway

Al termine del debug del gateway, puoi aggiornare il gateway per disattivare i messaggi di debug, in modo che il messaggio all'utente finale mostri solo un errore interno non specificato.

Per disattivare i messaggi di debug, esegui una delle seguenti operazioni:

  • Nella console di AWS gestione, espandi Configurazioni aggiuntive nella sezione Dettagli del gateway quando crei o modifichi un gateway e deseleziona la casella di controllo accanto a Debug a livello di eccezione.

  • Nella AWS CLI o in un AWS SDK, ometti il exceptionLevel campo quando effettui una UpdateGateway richiesta CreateGateway o richiedi di disattivare il debug.

Esempi di risposte del gateway con debug attivato e disattivato

Ad esempio, supponiamo che l'utente non disponga delle autorizzazioni per richiamare una funzione Lambda destinata al gateway. Una richiesta che richiama questa funzione restituirebbe un messaggio diverso a seconda che il debug sia attivato o disattivato:

  • Debug attivato: un messaggio di errore dettagliato verrà restituito nel text campo del contenuto e anche nel _meta campo della risposta, come nell'esempio seguente:

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

  • Debug disattivato: nella risposta verrebbe restituito un messaggio di errore generico nel text campo del contenuto, come nell'esempio seguente:

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