תוויות של מטא-נתונים בהתאמה אישית

‫Document AI תומך בהוספה של תוויות או צמדי מפתח/ערך (KVP) שהוגדרו על ידי המשתמש כמטא-נתונים שנשלחים למעבד כדי ProcessDocument, BatchProcessDocuments בקשות. המטא-נתונים האלה לגבי הבקשה (יחד עם נתוני השימוש, כמו מספר הדפים) מועברים למערכת החיוב ב-Cloud. היא מאוכלסת במערכת החיוב, שבה אפשר לפרט את חיובים באמצעות סינון לפי תוויות המטא-נתונים האלה.

תרחיש שימוש

תרחיש שימוש חשוב בתוויות הוא לקוחות שמספקים שירותי עיבוד מסמכים ללקוחות רבים. אפשר להשתמש בפרויקט אחד לכמה לקוחות. לצורך חיוב, חשוב לשייך בקשות ספציפיות ללקוחות הרלוונטיים. כאן נכנסות לתמונה תוויות המטא-נתונים האלה. הם משמשים לסינון דוחות ב- Google Cloud.

הדרישות לגבי תוויות

התוויות שמוחלות על בקשה צריכות לעמוד בדרישות הבאות:

• כל בקשה יכולה להכיל כמה תוויות, עד 64 לכל היותר.
• כל תווית צריכה להיות זוג מפתח/ערך.
• האורך המינימלי של מפתחות הוא תו אחד, והאורך המקסימלי הוא 63 תווים. המפתחות לא יכולים להיות ריקים. הערכים יכולים להיות ריקים, והאורך המקסימלי שלהם הוא 63 תווים.
• המפתחות והערכים מכילים רק אותיות קטנות, ספרות, קווים תחתונים ומקפים. כל התווים צריכים להיות בקידוד UTF-8, ומותר להשתמש בתווים בינלאומיים.
• החלק של המפתח בתווית חייב להיות ייחודי בבקשה אחת (לדוגמה, {'country':'india'} הוא תקין, אבל {'country':'india','country':'sweden'} לא תקין).
• המפתחות צריכים להתחיל באות קטנה או בתו בינלאומי.

שימוש ב-API

בדוגמת הקוד Sync Process אפשר לראות איך לשלוח בקשה למעבד באמצעות תווית.

  curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @docai_request.json \
    "https://us-documentai.googleapis.com/v1/projects/514064100333/locations/us/processors/3bb61571a9731982:process"

דוגמה לבקשה

  {
    "skipHumanReview": true,
    "rawDocument": {
      "mimeType": "application/pdf",
        "content" : "PDF/IMAGE CONTENT"
    },
    "labels": {"country": "india" },
    "processOptions": {
      "individualPageSelector" : {
        "pages": [1]
      }
    }
  }

בדוגמת הקוד Async Process אפשר לראות איך לשלוח בקשה למעבד באמצעות תווית.

  curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @batch_docai_request.json \
    "https://us-documentai.googleapis.com/v1/projects/514064100333/locations/us/processors/3bb61571a9731982:batchProcess"

דוגמה לבקשה

  {
   "inputDocuments": {
     "gcsPrefix": {
       "gcsUriPrefix": "gs://atul_dai_test/ravi/GCS_DWH_work_flows_docs/Small_pdf/"
     }
   },
   "documentOutputConfig": {
     "gcsOutputConfig": {
       "gcsUri": "gs://atul_dai_test/ravi/GCS_DWH_work_flows_docs/test/docai_config/"
     }
   },
   "labels": {"country": "india" },
   "skipHumanReview": true
 }

דוח תמחור

אפשר להשתמש בתוויות האלה כדי לראות את השימוש בבקשות.

1. נכנסים אל מסוף החיוב ב-Cloud.

2. במסוף, לוחצים על תפריט בפינה הימנית העליונה ובוחרים באפשרות חיוב מהתפריט הנפתח. אם יש לכם כמה חשבונות לחיוב, יוצג דף שבו תתבקשו לבחור חשבון. לוחצים על Go to linked billing account (מעבר לחשבון לחיוב המקושר).

   

   

3. בדף החיוב, בוחרים באפשרות דוחות בחלונית הניווט הימנית.

   

4. כדי לבדוק את השימוש בבקשות, משתמשים במסננים בחלונית השמאלית.