View a markdown version of this page

Aktifkan pesan debugging - Batuan Dasar Amazon AgentCore
Contoh respons gateway dengan debugging diaktifkan dan dimatikan

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 otorisasi jalan keluar, kesalahan validasi parameter spesifikasi target. Setelah mengaktifkan pesan debugging, jika terjadi masalah saat Anda memanggil gateway, 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 dihidupkan.

  • Jika Anda menggunakan AWS Management Console 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 exceptionLevel nilainya seperti DEBUG saat Anda membuat CreateGatewaypermintaan atau. UpdateGateway

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

Untuk mematikan pesan debugging, lakukan salah satu hal berikut:

  • Di Konsol AWS Manajemen, perluas Konfigurasi 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 diaktifkan dan dimatikan

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

  • Debugging on - Pesan kesalahan terperinci akan dikembalikan di text bidang konten dan juga di _meta bidang dalam respons, seperti pada 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 pada contoh berikut:

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