View a markdown version of this page

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

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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 di funzione lambda, errori di autorizzazione di uscita, errori di convalida dei parametri di specifica di destinazione. Dopo aver attivato i messaggi di debug, se si verifica un problema quando richiami il gateway, la risposta restituirà dei messaggi per aiutarti a eseguire il debug.

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

  • Se utilizzi 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 dei dettagli del gateway.

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

Al termine del debug del gateway, è possibile 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, effettuate 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 fai una CreateGateway richiesta or per disattivare il debug. UpdateGateway

Esempi di risposte del gateway con il 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 attivo o disattivato:

  • Debug attivo: verrà restituito un messaggio di errore dettagliato 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
  }
}

  • Debugging off: verrebbe restituito un messaggio di errore generico nel text campo del contenuto della risposta, come nell'esempio seguente:

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