View a markdown version of this page

Gunakan Skema JSON Kondisi Aktivasi Loop Manusia dengan Amazon Textract - Amazon SageMaker AI

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 ImportantFormKeyConfidenceCheck kondisi tersebut, ambil sampel secara acak persentase dari kesimpulan yang memenuhi kondisi yang ditentukan ImportantFormKeyConfidenceCheck untuk 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 AnalyzeDocument API mengembalikan pasangan kunci-nilai yang kuncinya adalah salah Employee Name satuEmployeeName,, 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 AnalyzeDocument API mengembalikan pasangan kunci-nilai 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. PayDate DateOfPay

  • Amazon Textract AnalyzeDocument API mengembalikan pasangan kunci-nilai yang kuncinya adalah salah Gross Pay satuGrossAmount,, 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 Date PayDateDateOfPay,pay-date,, atau, dengan nilai kunci dan kepercayaan blok kata kurang dari 60, dikirim untuk ditinjau oleh manusia. Hanya kunci Pay Date formulir (dan aliasnya) dan nilai terkait yang dikirim ke pekerja untuk ditinjau.

  • 5% pasangan kunci-nilai yang terdeteksi yang kuncinya adalah salah satu dariPay Date,PayDate,DateOfPay, ataupay-date, dengan kepercayaan kunci-nilai dan blok kata lebih besar dari 90, dikirim untuk ditinjau oleh manusia. Hanya kunci Pay Date formulir (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 } } } ] } ] }