Document AI: Döngüdeki İnsan

1. Giriş

Document AI API, belgeler ve e-postalar gibi yapılandırılmamış verileri alıp bu verileri anlamayı, analiz etmeyi ve kullanmayı kolaylaştıran bir belge anlama çözümüdür.

Uzman incelemesiyle, belge işleme doğruluğunu artırabilir ve uzman incelemesi güvencesiyle daha iyi sonuçlar elde edebilirsiniz. Uzman incelemesi, doğruluğu artırabilir ve işletmelerin bu incelemeleri etkinleştirmek için özel olarak geliştirilmiş araçları kullanarak tahminleri değerlendirmesine yardımcı olabilir. Bu laboratuvarda, insan destekli yapılandırma ve yönetim araçlarını kullanarak işlemciden gelen sonuçları doğrulamak için insan incelemesiyle bir gider işlemcisi yapılandırıp test edeceksiniz.

NOT: Console kullanıcı arayüzü zaman içinde değişebilir. Bu nedenle, ortamınız biraz farklı görünebilir. Bu laboratuvarla ilgili herhangi bir sorunla karşılaşırsanız lütfen bildirin.

Ön koşullar

Bu codelab, diğer Document AI codelab'lerinde sunulan içeriklere dayanmaktadır.

Devam etmeden önce aşağıdaki Codelab'leri tamamlamanız önerilir.

• Document AI ile Optik Karakter Tanıma (OCR) (Python)
• Document AI ile Form Ayrıştırma (Python)
• Document AI ile Özel İşlemciler (Python)

Neler öğreneceksiniz?

• Bir işlemci için gerçek kişiler tarafından inceleme özelliğini yapılandırma
• İnsan incelemesi kullanıcı kaynak havuzu oluşturun.
• Test amaçlı bir gerçek kişi incelemesi görevi oluşturun.
• Kullanıcıya gerçek kişiler tarafından inceleme görevi atama
• Bir dokümanın gerçek kişiler tarafından incelenmesini sağlama

Gerekenler

• Google Cloud projesi
• Chrome veya Firefox gibi bir tarayıcı
• Python 3 bilgisi

2. Hazırlanma

Bu codelab'de, Giriş Codelab'inde listelenen Document AI kurulum adımlarını tamamladığınız varsayılır.

Lütfen devam etmeden önce aşağıdaki adımları tamamlayın:

• Cloud Shell'i başlatma
• Document AI ve Cloud Storage API'lerini etkinleştirme
• Python İstemci Kitaplığı'nı yükleme

Ayrıca Vertex AI API'yi de etkinleştirmeniz gerekir.

1. Konsolun üst kısmındaki arama çubuğunu kullanarak "Vertex AI API"yi arayın, ardından Google Cloud projenizde API'yi kullanmak için Etkinleştir'i tıklayın.
2. Alternatif olarak, API aşağıdaki gcloud komutu kullanılarak etkinleştirilebilir.

gcloud services enable aiplatform.googleapis.com

3. İşleyici oluşturma

Bu laboratuvarda kullanmak üzere önce bir Expense Processor örneği oluşturmanız gerekir.

1. Konsolda Document AI Platform Overview (Document AI Platform'a Genel Bakış) sayfasına gidin.
2. İşlemci Oluştur'u tıklayın, Özel'e gidin ve Gider Ayrıştırıcı'yı seçin.
3. codelab-expense-parser adını verin (veya hatırlayacağınız başka bir ad) ve listede size en yakın bölgeyi seçin.
4. İşleyicinizi oluşturmak için Oluştur'u tıklayın.
5. İşlemci kimliğini kopyalayın. Bunu daha sonra kodunuzda kullanmanız gerekir.
6. Cloud Shell'de, ad olarak PROJECT_ID-hitl-results kullanarak bir depolama alanı paketi oluşturun:

export PROJECT_ID=$(gcloud config get-value core/project)
gsutil mb gs://$PROJECT_ID-hitl-results

7. Kullanıcı hesabınızı, laboratuvar projenizdeki Vertex AI Admin IAM rolüne bağlayın.

export USER_ACCOUNT=$(gcloud config get-value core/account)
gcloud projects add-iam-policy-binding $PROJECT_ID --member=user:$USER_ACCOUNT --role=roles/aiplatform.admin

4. Sürecin parçası olan insanı yapılandırma

Bu görevde, daha önce oluşturduğunuz gider işleme birimi için insan incelemesi yapılandıracaksınız.

1. Konsolda Gezinme menüsü'nü açıp Document AI'ı seçin.
2. İnsan etkileşimli yapay zeka'yı tıklayın.
3. İşlemcinin İnsan İncelemesi sayfasını açmak için codelab-expense-parser simgesini tıklayın.
4. Configure Human-in-the-Loop'u (İnsan müdahalesi yapılandırma) tıklayın.

5. Belge Düzeyi Filtresi'ni seçin.
6. Güven eşiği % kaydırma çubuğunu %50'ye ayarlayın.
7. Uzmanlar seçeneğini Kendi uzmanlarımı kullan olarak ayarlayın.

8. Uzman havuzu açılır kutusunu ve YENİ UZMAN HAVUZU'nu tıklayın.
9. Havuz adı için Yeni uzman havuzu iletişim kutusuna Codelab HITL Pool girin.
10. Havuz Yöneticileri ve Uzmanlar için kişisel e-posta adresinizi girin.
11. Havuz oluştur'u tıklayın.

Bu işlemin tamamlanması birkaç dakika sürer. Vertex AI [e-mail] adresinden bir e-posta alırsınız.

NOT: İzinle ilgili sorun yaşadıysanız yeniden dene'yi tıklayın. Kullanıcı hesabınıza proje düzeyinde aiplatform.specialistPools.create rolünün atanmasını gerektiren Cloud IAM roles/aiplatform.admin iznine sahip olmanız gerekir.

roles/project.owner tek başına yeterli değildir.

12. Otomatik atama onay kutusunu işaretlemeden bırakın.
13. Ücretleri onayla bölümündeki onay kutusunu tıklayın.
14. Talimatlar konumu'nu tıklayın ve bu depolama konumunu kopyalayın: - Yolda gs:// önekini EKLEMEYİN.

cloud-samples-data/documentai/codelabs/hitl/hitl-instructions.pdf

NOT: Bu belge, inceleme talimatı setleri oluşturma kurallarının bir kopyasıdır ve çalışan bir örnek değildir.

15. Sonuç konumu bölümünde Göz at'ı tıklayın ve daha önce oluşturduğunuz Cloud Storage paketini seçin.
16. Seç'i tıklayın.
17. Save Configuration'ı (Yapılandırmayı Kaydet) tıklayın.

Konsolda İnsanlı döngü yapılandırılıyor mesajı gösterilir ve işlemin tamamlanması birkaç dakika sürer.

18. Yapılandırma tamamlandığında konsolda, Human-in-the-loop'u etkinleştirmeniz istenir.

• Etkinleştirmek için açma/kapatma düğmesini tıklayın.
• Ardından, pop-up iletişim kutusunda ETKİNLEŞTİR'i tıklayın.

Örnek gider formu yükleme

1. Google Cloud Storage'da depolanan örnek bir formumuz var. Aşağıdaki düğmeyi veya komutu kullanarak indirebilirsiniz:

expense-claim.pdf dosyasını indirin

gsutil cp gs://cloud-samples-data/documentai/codelabs/hitl/expense-claim.pdf .

2. İnsan müdahalesi özelliğini etkinleştirdikten sonra Belge Yükle düğmesini tıklayın ve az önce indirdiğiniz örnek belgeye göz atın.
3. Yükle'yi tıklayın ve işlemin tamamlanmasını bekleyin.

5. Bir öğeyi uzman incelemesine atama

1. Bu sayfada, havuz yöneticisi ve uzman konsollarına ait bağlantıları görürsünüz. Bu bağlantılar, Vertex AI [e-mail] adresinden gönderilen bir e-postada da gösterilir.
   • Bunlar https://datacompute.google.com/cm/cloudml_data_specialists_us_central1_xxxxxxx/tasks gibi görünmelidir.
   • Yönetici konsolunun bağlantısını tıklayın.

2. Veri Etiketleme Konsolu'nda görev atama sayfasını açmak için Görevler sekmesi başlığını tıklayın.
3. Atanmamış onay kutusunu tıklayın. codelab-expense-parser-P1 görev sırasına karşı yeni bir girişin listelendiğini görmeniz gerekir.

4. codelab-expense-parser-P1'i seçin.
5. Atamayı Yönet'i tıklayın.
6. Uzmanları e-postayla dahil et metin kutusuna kendi kişisel e-posta adresinizi girin ve açılır listeden bu adresi seçin.
7. Uygula'yı tıklayın.

Ekranda artık görevin size atandığı gösteriliyor. Bu değişikliklerin uygulanması ve görünür hâle gelmesi birkaç dakika sürebilir.

8. Yeni kullanıcıyı seçin ve menü simgesini tıklayın.
9. Görüntülenen pop-up menüden Tüm görevlere ata'yı tıklayın.

10. Değişiklikleri uygula'yı tıklayın.
11. Commit'i (Yayınla) tıklayın.

6. İnsan incelemesi görevini gerçekleştirme

1. Cloud Console'da Human-in-the-Loop yapılandırma sayfasına geri dönün.

Uzman (Worker) Konsolu'nu ziyaret etmek için bağlantıyı tıklayın. Bu, https://datacompute.google.com/w/cloudml_data_specialists_us_central1_xxxxxxxxxxx gibi görünecektir.

Çalışan konsolu açılır ve yeni göreviniz listelenir.

2. 4m ile toplantı içeren satır öğesinin üzerine gelip düzenle (kalem) simgesini tıklayın.
3. Metni Adam ile toplantı olarak değiştirmek için değeri düzenleyin. Metni görmek için metin kutusunu aşağı kaydırmanız gerekebilir.
4. Uygula'yı tıklayın.
5. Aşağıdaki öğe için Onayla (yeşil onay işareti) simgesini tıklayın.
6. Diğer vurgulanan öğeler için Onayla simgesini tıklayın.
7. Gönder'i tıklayın. İnceleme görevi, etiketleyici sıranızdan kaldırıldı.

7. Tamamlanan görevleri görüntüleme

1. Yönetici Konsolu'na dönün.
2. Görevler'i tıklayın ve Devam eden'i seçin.
3. Uzmanlar'ı tıklayın.
4. E-posta adresinizi seçin.
5. Atamayı Yönet'i tıklayın.
6. Select specialists working on specific tasks ve Select tasks açılır listesinden expense-processor-P1'i seçin. Her seçim için Uygula'yı tıklayın. Size atanmış expense-processor-P1 için içerik menüsünde Uzmanları Görüntüle'yi seçin.

Etiketleme görevi etiketleyici tarafından gönderildikten sonra yanıtlanan görevlerin sayısı ve toplam süre güncellenir ancak bu görünümdeki verilerin görünmesi birkaç dakika sürebilir.

7. Uzmanlar pop-up'ını kapatın ve Uzmanlar sekmesini görün.
8. Kullanıcı adınızın içerik menüsünü tıklayın ve Görevleri görüntüle'yi seçin.

Bu görünümde, kullanıcının görevlerinin listesi, tamamlanma sayıları ve harcanan süre aşağıdaki gibi gösterilir:

8. Tebrikler

Tebrikler, Document AI Human-in-the-Loop'u kullanarak Document AI gider işlemcisiyle işlenen belgeler için inceleme uzmanı incelemesini başarıyla yapılandırdınız.

Temizleme

Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini istemiyorsanız:

• Cloud Console'da Kaynakları yönetin sayfasına gidin.
• Proje listesinde projenizi seçin ve Sil'i tıklayın.
• İletişim kutusunda proje kimliğini yazın ve projeyi silmek için Kapat'ı tıklayın.

Daha Fazla Bilgi

Aşağıdaki takip Codelab'leriyle Document AI hakkında bilgi edinmeye devam edin.

• Python ile Document AI işlemcilerini yönetme

Kaynaklar

• The Future of Documents - YouTube Playlist
• Document AI Belgeleri
• Document AI Python İstemci Kitaplığı
• Document AI örnekleri

Lisans

Bu çalışma, Creative Commons Attribution 2.0 Genel Amaçlı Lisans ile lisans altına alınmıştır.