Document AI: Döngüdeki İnsan

1. Giriş

Document AI API; belgeler ve e-postalar gibi yapılandırılmamış verileri alarak verilerin anlaşılmasını, analiz edilmesini ve kullanılmasını kolaylaştıran bir belge anlama çözümüdür.

Gerçek kişiler tarafından yapılan inceleme sayesinde, gerçek kişiler tarafından inceleme yapılmasını sağlayarak daha doğru belge işleme süreçleri elde edebilirsiniz. Gerçek kişi tarafından yapılan incelemeler, doğruluğu artırabilir ve işletmelerin bu yorumları etkinleştirmek için amaca yönelik araçları kullanarak tahminleri değerlendirmesine yardımcı olur. Bu laboratuvarda, insan odaklı yapılandırma ve yönetim araçlarını kullanarak işlemciden gelen sonuçları doğrulamak için gerçek kişi tarafından yapılan incelemelerden yararlanarak bir gider işleyici yapılandırıp test edeceksiniz.

NOT: Console kullanıcı arayüzü zaman içinde değişebileceği için ortamınız biraz farklı görünebilir. Bu laboratuvarda bir sorun bulursanız lütfen bunları bildirin.

Ön koşullar

Bu codelab'de, diğer Document AI Codelab'lerinde sunulan içerikler temel alınır.

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

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

Neler öğreneceksiniz?

• İşleyen için gerçek kişi tarafından yapılan incelemeyi yapılandırın.
• Gerçek kişi tarafından yapılan incelemelerden oluşan bir kullanıcı kaynak havuzu oluşturun.
• Gerçek kişi tarafından yapılan test amaçlı bir inceleme görevi oluşturun.
• Bir kullanıcıya gerçek kişi tarafından inceleme görevi atayın.
• Dokümanın gerçek kişiler tarafından incelenmesini tamamlayın.

Gerekenler

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

2. Kurulum

Bu codelab'de, Tanıtım Codelab'de listelenen Document AI Kurulum adımlarını tamamladığınız varsayılır.

Devam etmeden önce lütfen aşağıdaki adımları tamamlayın:

• Cloud Shell'i başlatma
• Document AI ve Cloud Storage API'leri
• Python istemci kitaplığını yükleme

Vertex AI API'yi de etkinleştirmeniz gerekir.

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

gcloud services enable aiplatform.googleapis.com

3. İşlemci Oluşturma

Öncelikle, bu laboratuvarda kullanmak üzere Gider İşleyici'nin bir örneğini oluşturmanız gerekir.

1. Konsolda Document AI Platformuna Genel Bakış'a gidin
2. İşleyen Oluştur'u tıklayın, Uzman'a gidin ve Gider Ayrıştırıcı'yı seçin.
3. Hedefe codelab-expense-parser adını (veya hatırlayacağınız başka bir ad) verin ve listeden en yakın bölgeyi seçin.
4. İşleyicinizi oluşturmak için Oluştur'u tıklayın.
5. İşleyen kimliğini kopyalayın. Bunu daha sonra kodunuzda kullanmanız gerekir.
6. Cloud Shell'de PROJECT_ID-hitl-results adını kullanarak bir depolama 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 projenizde Vertex AI Admin IAM rolüne bağlama

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 özelliğini yapılandırma

Bu görevde, daha önce oluşturduğunuz gider işleyici için gerçek kişi tarafından yapılan incelemeyi yapılandıracaksınız.

1. Konsolda gezinme menüsünü açıp Document AI'ı seçin.
2. Döngüdeki insan yapay zekası'nı tıklayın.
3. İşleyenin gerçek kişi tarafından yapılan inceleme sayfasını açmak için codelab-expense-parser simgesini tıklayın.
4. Döngüdeki İnsanı Yapılandır'ı tıklayın.

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

8. Uzman havuzu açılır kutusunu tıklayıp YENİ UZMAN HAVUZU'nu tıklayın.
9. Havuz adı için Yeni uzman havuzu iletişim kutusuna Codelab HITL Pool yazın.
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] tarafından bir e-posta alacaksınız.

NOT: İzinlerle ilgili sorun yaşıyorsanız yeniden dene'yi tıklayın. roles/aiplatform.admin rolünün proje düzeyinde kullanıcı hesabınıza atanmasını gerektiren Cloud IAM aiplatform.specialistPools.create izninizin olması gerekir.

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

12. Otomatik atama onay kutusunu işaretlemeden bırakın.
13. Ödemeleri onaylayın bölümündeki onay kutusunu tıklayın.
14. Talimatların konumu'nu tıklayın ve bu depolama konumuna kopyalayın: - Yola gs:// önekini EKLEMEYİN

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

NOT: Bu doküman, çalışan bir örnek değil, incelemeci talimat grupları oluşturma yönergelerinin bir kopyasıdır.

15. Sonuçlar 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 artık Döngüdeki insanı yapılandırma ifadesi gösterilir ve işlemin tamamlanması birkaç dakika sürer.

18. Yapılandırma tamamlandığında konsol, döngüdeki insan özelliğini etkinleştirmenizi ister.

• Etkinleştirmek için Değiştir Düğmesini tıklayın.
• Ardından, pop-up iletişim kutusunda ETKİNLEŞTİR'i tıklayın.

Örnek Gider Formu Yükleyin

1. Google Cloud Storage'da depolanan örnek bir formumuz vardır. Aşağıdaki düğme veya komutla indirebilirsiniz:

cost-claim.pdf dosyasını indirin

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

2. Sürecin parçası olan insan özelliğini etkinleştirdikten sonra Belge Yükle düğmesini tıklayın ve az önce indirdiğiniz örnek dokümana göz atın.
3. Yükle'yi tıklayın ve işlemin tamamlanmasını bekleyin.

5. Gerçek kişiler tarafından incelenmek üzere öğe atama

1. Bu sayfada Havuz Yöneticisi ve Uzman Konsollarının bağlantılarını görebilirsiniz. Bu bağlantılar, Vertex AI [e-mail] tarafından gönderilen e-postada da gösterilir.
   • https://datacompute.google.com/cm/cloudml_data_specialists_us_central1_xxxxxxx/tasks şeklinde görünmelidir
   • Yönetici konsolu bağlantısını tıklayın.

2. Veri Etiketleme Konsolu'na geldiğinizde, görev atama sayfasını açmak için Görevler sekme başlığını tıklayın.
3. Atanmamış onay kutusunu tıklayın. codelab-expense-parser-P1 görev sırasına göre yeni bir giriş listelendiğini göreceksiniz.

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

Ekranda artık görevin size atanmış olduğu gösterilmektedir. Bunun yayılmasının ve görünür hale gelmesinin birkaç dakika sürebileceğini fark edebilirsiniz.

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

10. Değişiklikleri kaydet'i tıklayın.
11. Kaydet'i tıklayın.

6. Gerçek Kişi İnceleme Görevini Gerçekleştirme

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

Uzman (Çalışan) konsolunu ziyaret etmek için bağlantıyı tıklayın. https://datacompute.google.com/w/cloudml_data_specialists_us_central1_xxxxxxxxxxx gibi görünecek.

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

2. Fareyle 4 dk'lık toplantı ifadesini içeren satır öğesinin üzerine gelip düzenle (kalem) simgesini tıklayın.
3. Değeri düzenleyerek metni Ali ile toplantı olarak değiştirin. 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. Vurgulanan diğer varlıklar 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öster

1. Yönetici konsoluna dönün.
2. Görevler'i tıklayın ve Devam edenler'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 menüsünden expense-processor-P1 seçeneğini belirleyin. Her seçim için Uygula'yı tıklayın. Size atanan expense-processor-P1 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 harcanan toplam süre güncellenir ancak bu görünümdeki verilerin görünmesi birkaç dakika sürebilir.

7. Uzman pop-up'ını kapatın ve Uzmanlar sekmesine gidin.
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ıya ait görevlerin listesi, tamamlanma sayıları ve geçen süre aşağıda gösterildiği gibi gösterilir:

8. Tebrikler

Tebrikler. Document AI gider işleyicisi kullanılarak işlenen dokümanlar için gerçek kişi tarafından yapılan incelemeyi yapılandırmak amacıyla Document AI İnsan-in-the-Loop'u başarıyla kullandınız.

Temizleme

Bu eğiticide kullanılan kaynaklar için Google Cloud hesabınızın ücretlendirilmesini önlemek amacıyla:

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

Daha Fazla Bilgi

Takip eden Codelab uygulamaları ile Document AI hakkında bilgi edinmeye devam edin.

• Document AI işlemcilerini Python ile yönetme

Kaynaklar

• Belgelerin Geleceği - YouTube Oynatma Listesi
• 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.