Parametri comuni di elaborazione del testo

Restrizioni linguistiche con le API di elaborazione del testo

Classificazione testo

È possibile utilizzare l'API di classificazione solo con documenti in lingua inglese.

Estrazione di testo

Non è possibile utilizzare l'API di estrazione con un documento in lingua mista se le lingue non condividono una scrittura comune. Tuttavia, è possibile utilizzare documenti con un mix di inglese e un'altra lingua in qualsiasi scrittura. Ad esempio, è possibile estrarre il testo dalle immagini di un documento con un mix di testo inglese e francese, poiché entrambe le lingue sono basate sul latino. Tuttavia, non è possibile estrarre il testo dalle immagini in un documento con testo misto giapponese e francese.

È possibile utilizzare l'API di estrazione del testo per estrarre i dati delle coppie chiave-valore solo da documenti in lingua inglese.

Lingue di scrittura supportate

La tabella seguente elenca le lingue supportate per il riconoscimento del testo scritto a mano:

Se il documento contiene testo scritto a mano in inglese, utilizza il en_hw codice lingua nel corpo della richiesta API supportato su s390x.

Lingue supportate per la stampa automatica

La tabella seguente fornisce dettagli sulle lingue supportate dall'API di estrazione del testo per il riconoscimento del testo stampato:

Documenti che contengono sia testo stampato a macchina che testo scritto a mano

Se il documento contiene una combinazione di testo stampato e testo scritto a mano, è necessario richiamare l'API specificando i codici lingua sia per il modello linguistico relativo al testo stampato che per quello relativo al testo scritto a mano.

Documenti in diverse lingue

Non è supportata la combinazione di lingue che non utilizzano lo stesso alfabeto, tranne nel caso in cui l'inglese sia abbinato a un'altra lingua.

Se un documento contiene testo in più lingue che utilizzano l'alfabeto latino o CJK, è possibile specificare più codici lingua nel file languages_list. Ad esempio, se si specificano sia fra che eng, il servizio mappa internamente la richiesta al latn modello.

Sono supportati solo i linguaggi di scripting elencati nella tabella dei linguaggi supportati. Non è possibile specificare più di uno script in una singola richiesta.

Combinazioni consentite:

• ['fra', 'spa'] – due lingue che utilizzano lo stesso alfabeto
• ['jpn', 'eng'] – una lingua non latina abbinata all'inglese ['jpn'](Se il documento contiene testo in giapponese e in inglese, è sufficiente specificarlo.)
• ['fra', 'spa', 'eng']
• ['jpn', 'kor'] – due lingue che utilizzano lo stesso alfabeto
• ['heb', 'eng'] – una lingua non latina abbinata all'inglese
• ['latn'] – script singolo
• ['cjk'] – script singolo

Combinazioni non supportate:

• ['heb', 'fra'] – una lingua non latina abbinata a una lingua latina diversa dall'inglese
• ['cjk', 'fra']
• ['jpn', 'fra', 'eng'] – una lingua non latina abbinata a due lingue latine
• ['latn', 'cjk'] – due diversi copioni

Definizione di schemi con il campo schemas

In base al layout, i documenti possono essere classificati a grandi linee nei seguenti tipi:

Documenti a layout variabile

Documenti senza una struttura coerente, come fatture, ordini di acquisto o passaporti, in cui la struttura si estende su più pagine.

Documenti a layout fisso

Documenti strutturati in cui ogni pagina segue un formato predefinito, come ad esempio un modulo fiscale in cui ogni pagina ha un layout specifico.

"semantic_config": {
  "schemas": [ {
      "document_type": "Receipt",
      "document_description": "A receipt issued for a purchase at ABC store.",
      "fields": {
        "receipt_number": {
          "default": "",
          "example": "R-20241027-ABC",
          "description": "Unique identifier on the receipt."
        },
        "customer_name": {
          "default": "",
          "example": "John Smith",
          "description": "Full name of the customer or payee."
        },
        "date_of_transaction": {
          "default": "",
          "example": "2023-01-01",
          "description": "Date when the purchase or payment occurred."
        },
        "total_paid": {
          "default": "",
          "example": "8.64",
          "description": "Final amount paid by the customer."
        },
        "payment_method": {
          "default": "",
          "example": "Credit Card",
          "description": "How payment was made, such as cash, card, check, etc.)."
        },
      }
  } ]
}

Controllo del modo in cui gli schemi predefiniti e personalizzati interagiscono con il campo schemas_merge_strategy

È possibile definire il modo in cui gli schemi personalizzati creati interagiscono con gli schemi predefiniti supportati dall'API di elaborazione del testo.

La tabella seguente fornisce dettagli sui diversi modi in cui vengono elaborati gli schemi predefiniti e personalizzati quando si configura l'impostazione schemas_merge_strategy nel parametro semantic_config :

Per impostazione predefinita, se si crea uno schema personalizzato per un tipo di documento che corrisponde a uno schema predefinito supportato, entrambi gli schemi vengono uniti prima di essere utilizzati per elaborare i dati della coppia chiave-valore nel documento.