View a markdown version of this page

Aktifkan pesan debugging - Batu Dasar Amazon AgentCore
Contoh respons gateway dengan debugging dihidupkan dan dimatikan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Aktifkan pesan debugging

Saat gateway Anda sedang dalam pengembangan, Anda dapat mengaktifkan pesan debugging untuk mengembalikan detail tentang masalah konfigurasi target, termasuk kesalahan fungsi lambda, kesalahan otorizer keluar, kesalahan validasi parameter spesifikasi target. Setelah mengaktifkan pesan debugging, jika terjadi masalah saat Anda memanggil gateway Anda, respons akan mengembalikan pesan untuk membantu Anda men-debug.

Untuk mengaktifkan pesan debugging, lakukan salah satu hal berikut:

  • Jika Anda menggunakan AgentCore CLI untuk membuat gateway, debugging secara otomatis diaktifkan.

  • Jika Anda menggunakan Konsol AWS Manajemen untuk membuat gateway, debugging diaktifkan secara default. Opsi ini ada di bawah Konfigurasi tambahan di bagian detail Gateway.

  • Jika Anda menggunakan AWS CLI atau AWS SDK, tetapkan nil exceptionLevel ainya seperti DEBUG saat Anda membuat UpdateGateway permintaan CreateGateway atau.

Setelah selesai men-debug gateway Anda, Anda dapat memperbarui gateway untuk mematikan pesan debugging, sehingga pesan ke pengguna akhir hanya menunjukkan kesalahan internal yang tidak ditentukan.

Untuk mematikan pesan debugging, lakukan salah satu hal berikut:

  • Di Konsol AWS Manajemen, perluas Konfigur asi tambahan di bagian Detail Gateway saat Anda membuat atau mengedit gateway dan hapus centang pada kotak centang di samping debug tingkat pengecualian.

  • Di AWS CLI atau AWS SDK, hilangkan exceptionLevel bidang saat Anda membuat CreateGateway atau UpdateGateway meminta untuk mematikan debugging.

Contoh respons gateway dengan debugging dihidupkan dan dimatikan

Sebagai contoh, misalkan pengguna tidak memiliki izin untuk memanggil fungsi Lambda yang ditargetkan oleh gateway. Permintaan yang memanggil fungsi ini akan mengembalikan pesan yang berbeda tergantung pada apakah debugging aktif atau nonaktif:

  • Debugging aktif - Pesan kesalahan terperinci akan dikembalikan di text bidang konten dan juga di _meta bidang dalam respons, seperti dalam contoh berikut:

    {
  "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 - Pesan kesalahan umum akan dikembalikan di text bidang konten dalam respons, seperti dalam contoh berikut:

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