GetIntent - Amazon Lex V1
Minta SintaksParameter Permintaan URIIsi PermintaanSintaks ResponsElemen ResponsKesalahanLihat Juga

Jika Anda menggunakan Amazon Lex V2, lihat panduan Amazon Lex V2 sebagai gantinya.

 

Jika Anda menggunakan Amazon Lex V1, kami sarankan untuk meningkatkan bot Anda ke Amazon Lex V2. Kami tidak lagi menambahkan fitur baru ke V1 dan sangat menyarankan menggunakan V2 untuk semua bot baru.

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

GetIntent

Mengembalikan informasi tentang maksud. Selain nama maksud, Anda harus menentukan versi intent.

Operasi ini memerlukan izin untuk menjalankan tindakan lex:GetIntent.

Minta Sintaks

GET /intents/name/versions/version HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

name

Nama niat. Namanya peka huruf besar/kecil.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 100.

Pola: ^([A-Za-z]_?)+$

Diperlukan: Ya

version

Versi maksudnya.

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Pola: \$LATEST|[0-9]+

Wajib: Ya

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

checksum

Checksum dari maksud.

Jenis: String

conclusionStatement

Setelah fungsi Lambda yang ditentukan dalam fulfillmentActivity elemen memenuhi intent, Amazon Lex menyampaikan pernyataan ini kepada pengguna.

Tipe: Objek Statement

confirmationPrompt

Jika didefinisikan dalam bot, Amazon Lex menggunakan prompt untuk mengonfirmasi maksud sebelum memenuhi permintaan pengguna. Untuk informasi selengkapnya, lihat PutIntent.

Tipe: Objek Prompt

createdDate

Tanggal dimana niat itu dibuat.

Tipe: Timestamp

description

Deskripsi niat.

Jenis: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.

dialogCodeHook

Jika didefinisikan dalam bot, Amazon Amazon Lex memanggil fungsi Lambda ini untuk setiap input pengguna. Untuk informasi selengkapnya, lihat PutIntent.

Tipe: Objek CodeHook

followUpPrompt

Jika didefinisikan dalam bot, Amazon Lex menggunakan prompt ini untuk meminta aktivitas pengguna tambahan setelah maksud terpenuhi. Untuk informasi selengkapnya, lihat PutIntent.

Tipe: Objek FollowUpPrompt

fulfillmentActivity

Menjelaskan bagaimana niat terpenuhi. Untuk informasi selengkapnya, lihat PutIntent.

Tipe: Objek FulfillmentActivity

inputContexts

Larik InputContext objek yang mencantumkan konteks yang harus aktif untuk Amazon Lex untuk memilih maksud dalam percakapan dengan pengguna.

Tipe: Array objek InputContext

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 5 item.

kendraConfiguration

Informasi konfigurasi, jika ada, untuk terhubung ke indeks Amazon Kendra dengan maksud. AMAZON.KendraSearchIntent

Tipe: Objek KendraConfiguration

lastUpdatedDate

Tanggal niat diperbarui. Saat Anda membuat sumber daya, tanggal pembuatan dan tanggal terakhir diperbarui adalah sama.

Tipe: Timestamp

name

Nama niat.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.

Pola: ^([A-Za-z]_?)+$

outputContexts

Array OutputContext objek yang mencantumkan konteks yang mengaktifkan intent saat intent terpenuhi.

Tipe: Array objek OutputContext

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10 item.

parentIntentSignature

Pengenal unik untuk maksud bawaan.

Jenis: String

rejectionStatement

Jika pengguna menjawab “tidak” untuk pertanyaan yang didefinisikan dalamconfirmationPrompt, Amazon Lex merespons dengan pernyataan ini untuk mengakui bahwa maksud tersebut dibatalkan.

Tipe: Objek Statement

sampleUtterances

Larik contoh ucapan yang dikonfigurasi untuk maksud.

Tipe: Array string.

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1500 item.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 200.

slots

Array slot intent yang dikonfigurasi untuk maksud tersebut.

Tipe: Array objek Slot

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 100 item.

version

Versi maksudnya.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Pola: \$LATEST|[0-9]+

Kesalahan

BadRequestException

Permintaan tidak terbentuk dengan baik. Misalnya, nilai tidak valid atau bidang wajib hilang. Periksa nilai bidang, dan coba lagi.

Kode Status HTTP: 400

InternalFailureException

Terjadi kesalahan internal Amazon Lex. Coba permintaan Anda lagi.

Kode Status HTTP: 500

LimitExceededException

Permintaan melebihi batas. Coba permintaan Anda lagi.

Kode Status HTTP: 429

NotFoundException

Sumber daya yang ditentukan dalam permintaan tidak ditemukan. Periksa sumber daya dan coba lagi.

Kode Status HTTP: 404

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: