Configurare un progetto di riconoscimento dei caratteri

Questa pagina aiuta gli sviluppatori a configurare un progetto di appliance air-gapped di Google Distributed Cloud (GDC) per utilizzare il servizio di riconoscimento ottico dei caratteri (OCR). Questa procedura include la creazione di un progetto, l'abilitazione dell'API OCR, l'installazione delle librerie client, la definizione delle variabili di ambiente e l'autenticazione delle credenziali. Se non hai mai utilizzato Vertex AI, scopri di più sulle funzionalità di riconoscimento dei caratteri.

Configura un progetto di riconoscimento dei caratteri utilizzando la console GDC e gcloud CLI come segue:

  • Console GDC: abilita l'API OCR e visualizza lo stato e l'endpoint del servizio.
  • gcloud CLI: configura gli account di servizio per interagire con l'API OCR, installa le librerie client e autentica le richieste API.

Crea un progetto

La creazione di un progetto di riconoscimento dei caratteri organizza le risorse OCR, che includono collaboratori, API abilitate, credenziali di autenticazione e controlli dell'accesso.

Per creare il progetto, consulta Configurare un progetto per Vertex AI. Avrai bisogno dell'ID progetto quando effettui chiamate API.

Richiedi le autorizzazioni dello sviluppatore

Devi disporre del ruolo Sviluppatore OCR AI nel tuo progetto per accedere alle funzionalità di riconoscimento ottico dei caratteri e generare un token API per l'autenticazione e l'autorizzazione delle richieste.

Chiedi all'amministratore IAM del progetto di concedere il ruolo Sviluppatore OCR AI (ai-ocr-developer) al tuo utente o account di servizio all'interno dello spazio dei nomi del progetto. Per informazioni su questo ruolo, consulta Preparare le autorizzazioni IAM.

Abilita l'API OCR

Devi abilitare l'API preaddestrata OCR per il tuo progetto. Se è abilitata, puoi visualizzare lo stato e l'endpoint del servizio per l'API preaddestrata OCR.

Installa le librerie client

Le librerie client sono disponibili per il linguaggio di programmazione Python. Ti consigliamo di utilizzare queste librerie client per effettuare chiamate all'API OCR perché semplificano l'accesso alle API.

Installa la libreria client OCR e segui questi passaggi per assicurarti di avere la versione corretta:

  1. Verifica se la libreria client OCR è installata e ottieni il numero di versione:

    pip freeze | grep vision

    Se la libreria client è già installata, otterrai un output simile al seguente esempio:

    google-cloud-vision==3.0.0

    Il numero di versione ottenuto deve corrispondere alla libreria client all'endpoint seguente:

    https://GDC_URL/.well-known/static/client-libraries

    Sostituisci GDC_URL con l'URL della tua organizzazione in GDC.

  2. Se i numeri di versione non corrispondono, disinstalla la libreria client:

    pip uninstall google-cloud-vision

  3. Se hai disinstallato la libreria client OCR, devi reinstallarla specificando il nome file corrispondente al tuo sistema operativo.

Imposta le variabili di ambiente

Dopo aver installato la libreria client OCR, puoi interagire con l'API da uno script Python.

Se hai configurato un account di servizio nel tuo progetto per effettuare chiamate API autorizzate a livello programmatico, puoi definire le variabili di ambiente nello script Python per accedere a valori come le chiavi dell'account di servizio durante l'esecuzione.

Segui questi passaggi per impostare le variabili di ambiente richieste in uno script Python:

  1. Crea uno script Python.

  2. Aggiungi il seguente codice allo script Python:

    import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"

    Sostituisci APPLICATION_DEFAULT_CREDENTIALS_FILENAME con il nome del file JSON contenente le chiavi account di servizio che hai creato nel progetto, ad esempio my-service-key.json.

  3. Salva lo script Python con un nome, ad esempio vision.py.

  4. Esegui lo script Python per impostare le variabili di ambiente:

    python SCRIPT_NAME

    Sostituisci SCRIPT_NAME con il nome che hai assegnato allo script Python, ad esempio vision.py.

Configura l'autenticazione

Prima di poter iniziare a utilizzare l'API OCR, devi autenticare le credenziali client e richiedere l'accesso all'account alle risorse del progetto. Per saperne di più, consulta Autenticare le richieste API.