Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Gunakan Skema JSON Kondisi Aktivasi Loop Manusia dengan Amazon Textract
catatan
Amazon SageMaker A2I tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan seperti biasa. AWS terus berinvestasi dalam peningkatan keamanan dan ketersediaan untuk A2I, tetapi kami tidak berencana untuk memperkenalkan fitur baru.
Saat digunakan dengan Amazon A2I, AnalyzeDocument operasi mendukung input berikut dalam ConditionType parameter:
-
ImportantFormKeyConfidenceCheck— Gunakan kondisi ini untuk membuat loop manusia ketika kepercayaan inferensi berada dalam kisaran tertentu untuk kunci formulir dokumen dan blok kata. K unci formulir adalah kata apa pun dalam dokumen yang terkait dengan input. Input disebut nilai. Bersama-sama, kunci bentuk dan nilai disebut sebagai pasangan kun ci-nilai. Blok kata mengacu pada kata-kata yang dikenali Amazon Textract di dalam blok teks yang terdeteksi. Untuk mempelajari lebih lanjut tentang blok dokumen Amazon Textract, lihat Dok umen dan Blokir Objek di Panduan Pengembang Amazon Textract. -
MissingImportantFormKey— Gunakan kondisi ini untuk membuat loop manusia ketika Amazon Textract tidak mengidentifikasi kunci atau alias terkait di dalam dokumen. -
Sampling— Gunakan kondisi ini untuk menentukan persentase formulir yang akan dikirim ke manusia untuk ditinjau, terlepas dari skor kepercayaan inferensi. Gunakan kondisi ini untuk melakukan hal berikut:-
Audit model ML Anda dengan mengambil sampel secara acak semua formulir yang dianalisis oleh model Anda dan mengirimkan persentase tertentu kepada manusia untuk ditinjau.
-
Dengan menggunakan
ImportantFormKeyConfidenceCheckkondisi tersebut, ambil sampel secara acak persentase dari kesimpulan yang memenuhi kondisi yang ditentukanImportantFormKeyConfidenceCheckuntuk memulai loop manusia dan hanya mengirim persentase yang ditentukan kepada manusia untuk ditinjau.
-
catatan
Jika Anda mengirim permintaan yang sama ke AnalyzeDocument beberapa kali, hasilnya Sampling tidak berubah untuk inferensi input itu. Misalnya, jika Anda membuat AnalyzeDocument permintaan sekali, dan Sampling tidak memulai loop manusia, permintaan berikutnya ke AnalyzeDocument dengan konfigurasi yang sama tidak memulai loop manusia.
ImportantFormKeyConfidenceCheckInput dan Hasil
Men ImportantFormKeyConfidenceCheck ConditionType dukung sebagai berikutConditionParameters:
-
ImportantFormKey— String yang mewakili kunci dalam pasangan kunci-nilai yang terdeteksi oleh Amazon Textract yang perlu ditinjau oleh pekerja manusia. Jika nilai parameter ini adalah nilai catch-all khusus (*), maka semua kunci dianggap cocok dengan kondisi tersebut. Anda dapat menggunakan ini untuk memodelkan kasus di mana pasangan kunci-nilai yang memenuhi ambang kepercayaan tertentu memerlukan tinjauan manusia. -
ImportantFormKeyAliases- Array yang mewakili ejaan alternatif atau setara logis untuk kunci formulir penting. -
KeyValueBlockConfidenceEquals -
KeyValueBlockConfidenceLessThan -
KeyValueBlockConfidenceLessThanEquals -
KeyValueBlockConfidenceGreaterThan -
KeyValueBlockConfidenceGreaterThanEquals -
WordBlockConfidenceEquals -
WordBlockConfidenceLessThan -
WordBlockConfidenceLessThanEquals -
WordBlockConfidenceGreaterThan -
WordBlockConfidenceGreaterThanEquals
Saat Anda menggunakan ImportantFormKeyConfidenceCheckConditionType, Amazon A2I mengirimkan blok nilai kunci dan kesimpulan blok kata dari blok nilai kunci dan alias terkait yang Anda tentukan dalam dan untuk ditinjau oleh manusia. ImportantFormKey ImportantFormKeyAliases
Saat membuat definisi alur, jika Anda menggunakan templat tugas pekerja default yang disediakan di bagian alur kerja peninjauan manusia di konsol Amazon SageMaker AI, kesimpulan nilai kunci dan blok yang dikirim untuk ditinjau oleh manusia oleh kondisi aktivasi ini disertakan dalam UI pekerja. Jika Anda menggunakan templat tugas pekerja khusus, Anda harus menyertakan {{ task.input.selectedAiServiceResponse.blocks
}} elemen untuk menyertakan data input nilai awal (kesimpulan) dari Amazon Textract. Untuk contoh template kustom yang menggunakan elemen input ini, lihatContoh Template Kustom untuk Amazon Textract.
MissingImportantFormKeyInput dan Hasil
Men MissingImportantFormKey ConditionType dukung sebagai berikutConditionParameters:
-
ImportantFormKey— String yang mewakili kunci dalam pasangan kunci-nilai yang terdeteksi oleh Amazon Textract yang perlu ditinjau oleh pekerja manusia. -
ImportantFormKeyAliases- Array yang mewakili ejaan alternatif atau setara logis untuk kunci formulir penting.
Saat Anda menggunakan MissingImportantFormKeyConditionType, jika kunci masuk ImportantFormKey atau alias tidak termasuk dalam ImportantFormKeyAliases inferensi Amazon Textract, formulir itu dikirim ke manusia untuk ditinjau dan tidak ada pasangan kunci-nilai yang diprediksi disertakan. Misalnya, jika Amazon Textract hanya mengidentifikasi Address dan Phone dalam formulir, tetapi hilang ImportantFormKey Name (dalam jenis MissingImportantFormKey kondisi) formulir itu akan dikirim ke manusia untuk ditinjau tanpa ada kunci formulir yang terdeteksi (AddressdanPhone).
Jika Anda menggunakan templat tugas pekerja default yang disediakan di konsol SageMaker AI, tugas dibuat meminta pekerja untuk mengidentifikasi kunci masuk ImportantFormKey dan nilai terkait. Jika Anda menggunakan template tugas pekerja kustom, Anda perlu menyertakan elemen HTML <task.input.humanLoopContext> khusus untuk mengonfigurasi tugas ini.
Input dan Hasil Pengambilan Sampel
Men Sampling ConditionType dukung RandomSamplingPercentageConditionParameters. Masukan untuk RandomSamplingPercentage harus bilangan real antara 0,01 dan 100. Angka ini mewakili persentase data yang memenuhi syarat untuk tinjauan manusia dan dikirim ke manusia untuk ditinjau. Jika Anda menggunakan Sampling kondisi tanpa kondisi lain, angka ini mewakili persentase dari semua kesimpulan yang dihasilkan oleh AnalyzeDocument operasi dari permintaan tunggal yang dikirim ke manusia untuk ditinjau.
Jika Anda menentukan Sampling kondisi tanpa jenis kondisi lain, semua kesimpulan nilai kunci dan blok dikirim ke pekerja untuk ditinjau.
Saat membuat definisi alur, jika Anda menggunakan templat tugas pekerja default yang disediakan di bagian alur kerja peninjauan manusia di konsol SageMaker AI, semua kesimpulan nilai kunci dan blok yang dikirim untuk ditinjau oleh manusia oleh kondisi aktivasi ini disertakan dalam UI pekerja. Jika Anda menggunakan templat tugas pekerja khusus, Anda harus menyertakan {{ task.input.selectedAiServiceResponse.blocks
}} elemen untuk menyertakan data input nilai awal (kesimpulan) dari Amazon Textract. Untuk contoh template kustom yang menggunakan elemen input ini, lihatContoh Template Kustom untuk Amazon Textract.
Contoh
Sementara hanya satu kondisi yang perlu dievaluasi true untuk memulai loop manusia, Amazon A2I mengevaluasi semua kondisi untuk setiap objek yang dianalisis oleh Amazon Textract. Peninjau manusia diminta untuk meninjau kunci formulir penting untuk semua kondisi yang dievaluasi. true
Contoh 1: Mendeteksi kunci formulir penting dengan skor kepercayaan dalam rentang tertentu yang memulai loop manusia
Contoh berikut menunjukkan HumanLoopActivationConditions JSON yang memulai loop manusia jika salah satu dari tiga kondisi berikut terpenuhi:
-
Amazon Textract
AnalyzeDocumentAPI mengembalikan pasangan kunci-nilai yang kuncinya adalah salahEmployee NamesatuEmployeeName,, atau, dengan kepercayaan blok nilai kunci kurang dari 60 dan kepercayaan masing-masing blok kata yang membentuk kunci dan nilai kurang dari 85.Name -
Amazon Textract
AnalyzeDocumentAPI mengembalikan pasangan kunci-nilai yang kuncinya adalah salahPay Datesatu daripay-date,,, atau, dengan kepercayaan blok nilai kunci kurang dari 65 dan kepercayaan masing-masing blok kata yang membentuk kunci dan nilai kurang dari 85.PayDateDateOfPay -
Amazon Textract
AnalyzeDocumentAPI mengembalikan pasangan kunci-nilai yang kuncinya adalah salahGross PaysatuGrossAmount,, atau, dengan kepercayaan blok nilai kunci kurang dari 60 dan kepercayaan masing-masing blok kata yang membentuk kunci dan nilai kurang dari 85.GrossPay
{ "Conditions": [ { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey":"Employee Name", "ImportantFormKeyAliases": ["Name","EmployeeName"], "KeyValueBlockConfidenceLessThan": 60, "WordBlockConfidenceLessThan": 85 } }, { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey": "Pay Date", "ImportantFormKeyAliases": [ "PayDate", "DateOfPay", "pay-date" ], "KeyValueBlockConfidenceLessThan": 65, "WordBlockConfidenceLessThan": 85 } }, { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey": "Gross Pay", "ImportantFormKeyAliases": [ "GrossPay", "GrossAmount" ], "KeyValueBlockConfidenceLessThan": 60, "WordBlockConfidenceLessThan": 85 } } ] }
Contoh 2: Gunakan ImportantFormKeyConfidenceCheck
Dalam contoh berikut, jika Amazon Textract mendeteksi pasangan kunci-nilai yang kepercayaannya untuk blok nilai-kunci kurang dari 60 dan kurang dari 90 untuk blok kata yang mendasarinya, itu menciptakan loop manusia. Peninjau manusia diminta untuk meninjau semua bentuk pasangan kunci-nilai yang cocok dengan perbandingan nilai kepercayaan.
{ "Conditions": [ { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey": "*", "KeyValueBlockConfidenceLessThan": 60, "WordBlockConfidenceLessThan": 90 } } ] }
Contoh 3: Gunakan Sampling
Dalam contoh berikut, 5% kesimpulan yang dihasilkan dari AnalyzeDocument permintaan Amazon Textract dikirim ke pekerja manusia untuk ditinjau. Semua pasangan kunci-nilai yang terdeteksi yang dikembalikan oleh Amazon Textract dikirim ke pekerja untuk ditinjau.
{ "Conditions": [ { "ConditionType": "Sampling", "ConditionParameters": { "RandomSamplingPercentage": 5 } } ] }
Contoh 4: Gunakan MissingImportantFormKey
Dalam contoh berikut, jika Mailing Address atau aliasnya,Mailing
Address:, hilang dari kunci yang terdeteksi oleh Amazon Textract, peninjauan manusia dimulai. Saat menggunakan template tugas pekerja default, UI pekerja meminta pekerja untuk mengidentifikasi kunci Mailing Address atau Mailing Address: dan nilai terkaitnya.
{ "ConditionType": "MissingImportantFormKey", "ConditionParameters": { "ImportantFormKey": "Mailing Address", "ImportantFormKeyAliases": ["Mailing Address:"] } }
Contoh 5: Gunakan Sampling dan ImportantFormKeyConfidenceCheck dengan And operator
Dalam contoh ini, 5% pasangan kunci-nilai yang terdeteksi oleh Amazon Textract yang kuncinya adalah salah Pay Date satu daripay-date,,, atau, dengan kepercayaan blok nilai-kunci kurang dari 65 dan kepercayaan masing-masing blok kata yang membentuk kunci dan nilai kurang dari 85, dikirim ke pekerja untuk ditinjau. PayDate DateOfPay
{ "Conditions": [ { "And": [ { "ConditionType": "Sampling", "ConditionParameters": { "RandomSamplingPercentage": 5 } }, { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey": "Pay Date", "ImportantFormKeyAliases": [ "PayDate", "DateOfPay", "pay-date" ], "KeyValueBlockConfidenceLessThan": 65, "WordBlockConfidenceLessThan": 85 } } ] } ] }
Contoh 6: Gunakan Sampling dan ImportantFormKeyConfidenceCheck dengan And operator
Gunakan contoh ini untuk mengonfigurasi alur kerja peninjauan manusia agar selalu mengirim kesimpulan kepercayaan rendah dari pasangan kunci-nilai tertentu untuk tinjauan manusia dan sampel inferensi kepercayaan tinggi dari pasangan kunci-nilai pada tingkat yang ditentukan.
Dalam contoh berikut, tinjauan manusia dimulai dengan salah satu cara berikut:
-
Key-value pasangan yang terdeteksi yang kuncinya adalah salah satu dari
Pay DatePayDateDateOfPay,pay-date,, atau, dengan nilai kunci dan kepercayaan blok kata kurang dari 60, dikirim untuk ditinjau oleh manusia. Hanya kunciPay Dateformulir (dan aliasnya) dan nilai terkait yang dikirim ke pekerja untuk ditinjau. -
5% pasangan kunci-nilai yang terdeteksi yang kuncinya adalah salah satu dari
Pay Date,PayDate,DateOfPay, ataupay-date, dengan kepercayaan kunci-nilai dan blok kata lebih besar dari 90, dikirim untuk ditinjau oleh manusia. Hanya kunciPay Dateformulir (dan aliasnya) dan nilai terkait yang dikirim ke pekerja untuk ditinjau.
{ "Conditions": [ { "Or": [ { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey": "Pay Date", "ImportantFormKeyAliases": [ "PayDate", "DateOfPay", "pay-date" ], "KeyValueBlockConfidenceLessThan": 60, "WordBlockConfidenceLessThan": 60 } }, { "And": [ { "ConditionType": "Sampling", "ConditionParameters": { "RandomSamplingPercentage": 5 } }, { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey": "Pay Date", "ImportantFormKeyAliases": [ "PayDate", "DateOfPay", "pay-date" ], "KeyValueBlockConfidenceLessThan": 90 "WordBlockConfidenceGreaterThan": 90 } } ] } ] } ] }
Contoh 7: Gunakan Sampling dan ImportantFormKeyConfidenceCheck dengan Or operator
Dalam contoh berikut, AnalyzeDocument operasi Amazon Textract mengembalikan pasangan kunci-nilai yang kuncinya adalah salah satu dari Pay Date PayDateDateOfPay,pay-date,, atau, dengan kepercayaan blok nilai kunci kurang dari 65 dan kepercayaan masing-masing blok kata yang membentuk kunci dan nilai kurang dari 85. Selain itu, 5% dari semua bentuk lain memulai loop manusia. Untuk setiap formulir yang dipilih secara acak, semua pasangan kunci-nilai yang terdeteksi untuk formulir itu dikirim ke manusia untuk ditinjau.
{ "Conditions": [ { "Or": [ { "ConditionType": "Sampling", "ConditionParameters": { "RandomSamplingPercentage": 5 } }, { "ConditionType": "ImportantFormKeyConfidenceCheck", "ConditionParameters": { "ImportantFormKey": "Pay Date", "ImportantFormKeyAliases": [ "PayDate", "DateOfPay", "pay-date" ], "KeyValueBlockConfidenceLessThan": 65, "WordBlockConfidenceLessThan": 85 } } } ] } ] }