Respon titik akhir untuk data tabular

Setelah pekerjaan pemrosesan SageMaker Clarify menerima respons pemanggilan titik akhir inferensi, ia mendeserialisasi muatan respons dan mengekstrak prediksi darinya. Gunakan accept_type parameter konfigurasi analisis untuk menentukan format data dari muatan respons. Jika tidak accept_type disediakan, pekerjaan pemrosesan SageMaker Clarify akan menggunakan nilai parameter content_type sebagai format keluaran model. Untuk informasi selengkapnya tentang accept_type, lihat File Konfigurasi Analisis.

Prediksi dapat terdiri dari label yang diprediksi untuk analisis bias, atau nilai probabilitas (skor) untuk analisis kepentingan fitur. Dalam konfigurasi predictor analisis, tiga parameter berikut mengekstrak prediksi.

• Parameter probability digunakan untuk menemukan nilai probabilitas (skor) dalam respons titik akhir.

• Parameter label digunakan untuk menemukan label yang diprediksi dalam respons titik akhir.

• (Opsional) Parameter label_headers menyediakan label yang diprediksi untuk model multiclass.

Pedoman berikut berkaitan dengan respons titik akhir dalam format CSV, JSON Lines, dan JSON.

Respons Endpoint dalam format CSV

Jika payload respons dalam format CSV (tipe MIME:text/csv), tugas pemrosesan SageMaker Clarify melakukan deserialisasi setiap baris. Kemudian mengekstrak prediksi dari data deserialisasi menggunakan indeks kolom yang disediakan dalam konfigurasi analisis. Baris dalam muatan respons harus sesuai dengan catatan dalam payload permintaan.

Tabel berikut memberikan contoh data respons dalam format yang berbeda dan untuk jenis masalah yang berbeda. Data Anda dapat bervariasi dari contoh-contoh ini, selama prediksi dapat diekstraksi sesuai dengan konfigurasi analisis.

Bagian berikut menunjukkan contoh respons titik akhir dalam format CSV.

Respons titik akhir dalam format CSV dan hanya berisi probabilitas

Tabel berikut adalah contoh respons titik akhir untuk masalah regresi dan klasifikasi biner.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekor tunggal.	'0,6'
Dua catatan (menghasilkan satu baris, dibagi dengan koma).	'0,6,0,3'
Dua catatan (menghasilkan dua baris).	'0,6\n0,3'

Untuk contoh sebelumnya, titik akhir menghasilkan nilai probabilitas tunggal (skor) dari label yang diprediksi. Untuk mengekstrak probabilitas menggunakan indeks dan menggunakannya untuk analisis kepentingan fitur, atur parameter konfigurasi analisis probability ke indeks kolom. 0 Probabilitas ini juga dapat digunakan untuk analisis bias jika dikonversi ke nilai biner dengan menggunakan parameter. probability_threshold Untuk informasi selengkapnya tentang probability_threshold, lihat File Konfigurasi Analisis.

Tabel berikut adalah contoh respon endpoint untuk masalah multiclass.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal model multiclass (tiga kelas).	'0.1,0.6,0.3'
Dua catatan model multiclass (tiga kelas).	'0.1,0.6,0.3\n0.2,0.5,0.3'

Untuk contoh sebelumnya, titik akhir mengeluarkan daftar probabilitas (skor). Jika tidak ada indeks yang disediakan, semua nilai diekstraksi dan digunakan untuk analisis kepentingan fitur. Jika parameter konfigurasi analisis label_headers disediakan. Kemudian pekerjaan pemrosesan SageMaker Clarify dapat memilih tajuk label probabilitas maksimal sebagai label yang diprediksi, yang dapat digunakan untuk analisis bias. Untuk informasi selengkapnya tentang label_headers, lihat File Konfigurasi Analisis.

Respons titik akhir dalam format CSV dan hanya berisi label yang diprediksi

Tabel berikut adalah contoh respons titik akhir untuk masalah regresi dan klasifikasi biner.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'1'
Dua catatan (hasil dalam satu baris, dibagi dengan koma)	'1,0'
Dua catatan (menghasilkan dua baris)	'1\n0'

Untuk contoh sebelumnya, titik akhir mengeluarkan label yang diprediksi, bukan probabilitas. Atur label parameter predictor konfigurasi ke indeks kolom 0 sehingga label yang diprediksi dapat diekstraksi menggunakan indeks dan digunakan untuk analisis bias.

Respons titik akhir dalam format CSV dan berisi label dan probabilitas yang diprediksi

Tabel berikut adalah contoh respons titik akhir untuk masalah regresi dan klasifikasi biner.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'1,0.6'
Dua catatan	'1,0.6\n0,0.3'

Untuk contoh sebelumnya, titik akhir mengeluarkan label yang diprediksi diikuti oleh probabilitasnya. Atur label parameter predictor konfigurasi ke indeks kolom0, dan atur probability ke indeks kolom 1 untuk mengekstrak kedua nilai parameter.

Respons titik akhir dalam format CSV dan berisi label dan probabilitas yang diprediksi (multiclass)

Model multiclass yang dilatih oleh Amazon SageMaker Autopilot dapat dikonfigurasi untuk menampilkan representasi string dari daftar label dan probabilitas yang diprediksi. Contoh tabel berikut menunjukkan contoh respon endpoint dari model yang dikonfigurasi untuk outputpredicted_label,, probabilitylabels, danprobabilities.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'"dog” ,0.6, "[\ 'cat\ ',\ 'dog\',\ 'fish\ ']”, "[0.1, 0.6, 0.3]"'
Dua catatan	'"dog” ,0.6, "[\ 'cat\ ',\ 'dog\',\ 'fish\ ']”, "[0.1, 0.6, 0.3]”\n“" kucing” ,0.7, [\ 'cat\',\ 'dog\ ',\ 'ikan\']”, "[0.7, 0.2, 0.1]" '

Untuk contoh sebelumnya, pekerjaan pemrosesan SageMaker Clarify dapat dikonfigurasi dengan cara berikut untuk mengekstrak prediksi.

Untuk analisis bias, contoh sebelumnya dapat dikonfigurasi sebagai salah satu dari berikut ini.

• Atur label parameter predictor konfigurasi 0 untuk mengekstrak label yang diprediksi.

• Atur parameter 2 untuk mengekstrak label yang diprediksi, dan atur probability 3 untuk mengekstrak probabilitas yang sesuai. Pekerjaan pemrosesan SageMaker Clarify dapat secara otomatis menentukan label yang diprediksi dengan mengidentifikasi label dengan nilai probabilitas tertinggi. Mengacu pada contoh sebelumnya dari catatan tunggal, model memprediksi tiga label:cat,, dan dogfish, dengan probabilitas yang sesuai dari0.1,, 0.6 dan. 0.3 Berdasarkan probabilitas ini, label yang diprediksi adalahdog, karena memiliki nilai probabilitas tertinggi. 0.6

• Setel probability 3 untuk mengekstrak probabilitas. Jika label_headers disediakan, maka pekerjaan pemrosesan SageMaker Clarify dapat secara otomatis menentukan label yang diprediksi dengan mengidentifikasi header label dengan nilai probabilitas tertinggi.

Untuk analisis kepentingan fitur, contoh sebelumnya dapat dikonfigurasi sebagai berikut.

• Atur probability untuk 3 mengekstrak probabilitas semua label yang diprediksi. Kemudian, atribusi fitur akan dihitung untuk semua label. Jika pelanggan tidak menentukanlabel_headers, maka label yang diprediksi akan digunakan sebagai header label dalam laporan analisis.

Respons Endpoint dalam format JSON Lines

Jika payload respons dalam format JSON Lines (tipe MIME:application/jsonlines), tugas pemrosesan SageMaker Clarify mendeserialisasi setiap baris sebagai JSON. Kemudian mengekstrak prediksi dari data deserialisasi menggunakan JMESPath ekspresi yang disediakan dalam konfigurasi analisis. Baris dalam muatan respons harus sesuai dengan catatan dalam payload permintaan. Tabel berikut menunjukkan contoh data respons dalam format yang berbeda. Data Anda dapat bervariasi dari contoh-contoh ini, selama prediksi dapat diekstraksi sesuai dengan konfigurasi analisis.

Bagian berikut menunjukkan contoh respons titik akhir dalam format JSON Lines.

Respons titik akhir dalam format JSON Lines dan hanya berisi probabilitas

Tabel berikut adalah contoh respons titik akhir yang hanya menampilkan nilai probabilitas (skor).

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'{"skor” :0.6}'
Dua catatan	'{"score” :0.6}\n{"skor” :0.3}'

Untuk contoh sebelumnya, atur parameter konfigurasi analisis probability ke JMESPath ekspresi “skor” untuk mengekstrak nilainya.

Respons titik akhir dalam format JSON Lines dan hanya berisi label yang diprediksi

Tabel berikut adalah contoh respons titik akhir yang hanya menampilkan label yang diprediksi.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'{"prediksi” :1}'
Dua catatan	'{"prediksi” :1}\n{"prediksi” :0}'

Untuk contoh sebelumnya, atur label parameter konfigurasi prediktor ke JMESPath ekspresiprediction. Kemudian, pekerjaan pemrosesan SageMaker Clarify dapat mengekstrak label yang diprediksi untuk analisis bias. Untuk informasi selengkapnya, lihat File Konfigurasi Analisis.

Respons titik akhir dalam format JSON Lines dan berisi label dan probabilitas yang diprediksi

Tabel berikut adalah contoh respons titik akhir yang menampilkan label yang diprediksi dan skornya.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'{"prediksi” :1, "skor” :0.6}'
Dua catatan	'{"prediksi” :1, "skor” :0.6}\n{"prediksi” :0, "skor” :0.3}'

Untuk contoh sebelumnya, atur label parameter predictor konfigurasi ke JMESPath ekspresi “prediksi” untuk mengekstrak label yang diprediksi. Setel probability ke JMESPath ekspresi “skor” untuk mengekstrak probabilitas. Untuk informasi selengkapnya, lihat File Konfigurasi Analisis.

Respons titik akhir dalam format JSON Lines dan berisi label dan probabilitas yang diprediksi (multiclass)

Tabel berikut adalah contoh respons titik akhir dari model multiclass yang menghasilkan yang berikut:

• Daftar label yang diprediksi.

• Probabilitas, dan label prediksi yang dipilih dan probabilitasnya.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'{"predicted_label” :"dog”, "probabilitas” :0.6, "predicted_labels”: ["cat”, "dog”, "fish "], "probabilities”: [0.1,0.6,0.3]}'
Dua catatan	'{"predicted_label” :"dog”, "probabilitas” :0.6, "predicted_labels”: ["cat”, "dog”, "fish "], "probabilities”: [0.1,0.6,0.3]}\n{"predicted_label” :"cat”, "probabilitas” :0.7, "predicted_labels”: ["cat”, "dog”, "ikan "], "probabilitas”: [0.7,0.2,0.1]}'

Untuk contoh sebelumnya, pekerjaan pemrosesan SageMaker Clarify dapat dikonfigurasi dengan beberapa cara untuk mengekstrak prediksi.

Untuk analisis bias, contoh sebelumnya dapat dikonfigurasi sebagai salah satu dari berikut ini.

• Atur label parameter predictor konfigurasi ke JMESPath ekspresi “predicted_label” untuk mengekstrak label yang diprediksi.

• Setel parameter ke JMESPath ekspresi “predicted_labels” untuk mengekstrak label yang diprediksi. Atur probability ke JMESPath ekspresi “probabilitas” untuk mengekstrak probabilitas mereka. Pekerjaan SageMaker Clarify secara otomatis menentukan label yang diprediksi dengan mengidentifikasi label dengan nilai probabilitas tertinggi.

• Atur probability ke JMESPath ekspresi “probabilitas” untuk mengekstrak probabilitas mereka. Jika label_headers disediakan, maka pekerjaan pemrosesan SageMaker Clarify dapat secara otomatis menentukan label yang diprediksi dengan mengidentifikasi label dengan nilai probabilitas tertinggi.

Untuk analisis kepentingan fitur, lakukan hal berikut.

• Atur probability ke JMESPath ekspresi “probabilitas” untuk mengekstrak probabilitas mereka dari semua label yang diprediksi. Kemudian, atribusi fitur akan dihitung untuk semua label.

Respons Endpoint dalam format JSON

Jika payload respons dalam format JSON (tipe MIME:application/json), tugas pemrosesan SageMaker Clarify mendeserialisasi seluruh muatan sebagai JSON. Kemudian mengekstrak prediksi dari data deserialisasi menggunakan JMESPath ekspresi yang disediakan dalam konfigurasi analisis. Catatan dalam muatan respons harus sesuai dengan catatan dalam payload permintaan.

Bagian berikut menunjukkan contoh respons titik akhir dalam format JSON. Bagian berisi tabel dengan contoh data respons dalam format yang berbeda dan untuk jenis masalah yang berbeda. Data Anda dapat bervariasi dari contoh-contoh ini, selama prediksi dapat diekstraksi sesuai dengan konfigurasi analisis.

Respons titik akhir dalam format JSON dan hanya berisi probabilitas

Tabel berikut adalah contoh respons dari titik akhir yang hanya menampilkan nilai probabilitas (skor).

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'[0,6]'
Dua catatan	'[0.6,0.3]'

Untuk contoh sebelumnya, tidak ada jeda baris di payload respons. Sebagai gantinya, satu objek JSON berisi daftar skor, satu untuk setiap catatan dalam permintaan. Atur parameter konfigurasi analisis probability ke JMESPath ekspresi “[*]” untuk mengekstrak nilainya.

Respons titik akhir dalam format JSON dan hanya berisi label yang diprediksi

Tabel berikut adalah contoh respons dari titik akhir yang hanya menampilkan label yang diprediksi.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'{"predicted_labels”: [1]}'
Dua catatan	'{"predicted_labels”: [1,0]}'

Setel label parameter predictor konfigurasi ke JMESPath ekspresi “predicted_labels”, dan kemudian pekerjaan pemrosesan SageMaker Clarify dapat mengekstrak label yang diprediksi untuk analisis bias.

Respons titik akhir adalah format JSON dan berisi label dan probabilitas yang diprediksi

Tabel berikut adalah contoh respons dari titik akhir yang menampilkan label yang diprediksi dan skornya.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'{"predictions”: [{"label” :1, "skor” :0.6}'
Dua catatan	'{"predictions”: [{"label” :1, "score” :0.6}, {"label” :0, "score” :0.3}]}'

Untuk contoh sebelumnya, atur label parameter predictor konfigurasi ke JMESPath ekspresi “predictions [*] .label” untuk mengekstrak label yang diprediksi. Setel probability ke JMESPath ekspresi “prediksi [*] .score” untuk mengekstrak probabilitas.

Respons titik akhir dalam format JSON dan berisi label dan probabilitas yang diprediksi (multiclass)

Tabel berikut adalah contoh respons dari titik akhir yang dari model multiclass yang menghasilkan yang berikut:

• Daftar label yang diprediksi.

• Probabilitas, dan label prediksi yang dipilih dan probabilitasnya.

Muatan permintaan titik akhir	Muatan respons titik akhir (representasi string)
Rekaman tunggal	'[{"predicted_label” :"dog”, "probabilitas” :0.6, "predicted_labels”: ["cat”, "dog”, "fish "], "probabilities”: [0.1,0.6,0.3]}]'
Dua catatan	'[{"predicted_label” :"dog”, "probabilitas” :0.6, "predicted_labels”: ["cat”, "dog”, "fish "], "probabilities”: [0.1,0.6,0.3]}, {"predicted_label” :"cat”, "probabilitas” :0.7, "predicted_labels”: ["cat”, "dog”, "ikan "], "probabilitas”: [0.7,0.2,0.1]}]'

Pekerjaan pemrosesan SageMaker Clarify dapat dikonfigurasi dengan beberapa cara untuk mengekstrak prediksi.

Untuk analisis bias, contoh sebelumnya dapat dikonfigurasi sebagai salah satu dari berikut ini.

• Setel label parameter predictor konfigurasi ke JMESPath ekspresi “[*] .predicted_label” untuk mengekstrak label yang diprediksi.

• Setel parameter ke JMESPath ekspresi “[*] .predicted_labels” untuk mengekstrak label yang diprediksi. Setel probability ke JMESPath ekspresi “[*] .probabilities” untuk mengekstrak probabilitasnya. Pekerjaan pemrosesan SageMaker Clarify dapat secara otomatis menentukan label yang diprediksi dengan mengidentifikasi label dengan nilai kedekatan tertinggi.

• Setel probability ke JMESPath ekspresi “[*] .probabilities” untuk mengekstrak probabilitasnya. Jika label_headers disediakan, maka pekerjaan pemrosesan SageMaker Clarify dapat secara otomatis menentukan label yang diprediksi dengan mengidentifikasi label dengan nilai probabilitas tertinggi.

Untuk analisis kepentingan fitur, atur probability ke JMESPath ekspresi “[*] .probabilitas” untuk mengekstrak probabilitas mereka dari semua label yang diprediksi. Kemudian, atribusi fitur akan dihitung untuk semua label.