Inizia a utilizzare l'API Perspective

Inizia a utilizzare l'API Perspective

Informazioni su questo codelab

Ultimo aggiornamento: mar 10, 2022

Scritto da: Jigsaw

1. Prima di iniziare

Perspective API è un'API senza costi che ti aiuta a ospitare conversazioni migliori online. L'API utilizza il machine learning (ML) per analizzare una stringa di testo e prevedere l'impatto che potrebbe avere su una conversazione.

In questo codelab, configurerai l'API Perspective.

Nota:l'API Prospettiva ha lo scopo di semplificare la moderazione dei contenuti. Non è destinata a sostituire completamente il lavoro dei responsabili delle decisioni umane.

Obiettivi didattici

• Un approccio alla moderazione basato sull'AI che segnala i contenuti nel momento in cui vengono creati.

Che cosa ti serve

• Un Account Google per l'accesso a Google Cloud
• Velocità della connessione a Internet soddisfacente

2. Inizia

Per iniziare, hai bisogno di un progetto Google Cloud per autenticare le richieste API.

1. In Google Cloud Console, utilizza un progetto esistente.
2. Se necessario, procedi nel seguente modo per creare un nuovo progetto:

• Accedi con il tuo Account Google.
• Apri Cloud Console.
• Fai clic su Crea progetto o apri il menu Seleziona un progetto, quindi fai clic su Nuovo progetto nella finestra di dialogo.
• Assegna un nome al progetto e fai clic su Crea.

Il progetto viene visualizzato nel menu a discesa.

Richiedi l'accesso all'API

• Per richiedere l'accesso API, compila questo modulo.

Entro un'ora, dovresti ricevere un'email che conferma che puoi visualizzare e attivare l'API in Google Cloud.

Nota: se non ricevi l'email entro un giorno lavorativo, compila di nuovo il modulo o contatta il team di assistenza.

3. attiva l'API

• In Cloud Console, vai alla pagina Panoramica dell'API Prospettiva e fai clic su Attiva.

4. Genera la chiave API

1. Nel menu di navigazione, fai clic su API e servizi > credenziali > crea credenziali > chiave API.

Nota: se effettui richieste da un linguaggio lato client, come JavaScript, la tua chiave API viene esposta a tutti i visitatori. È vivamente consigliato eseguire il proxy della richiesta tramite un server e applicare le limitazioni della chiave in modo che la chiave sia nascosta ai browser e che solo il tuo server possa utilizzarla. Per ulteriori informazioni, vedi un esempio di come eseguire il proxy della richiesta tramite un server e altri consigli sulla sicurezza delle chiavi API.

La chiave API dovrebbe funzionare in pochi minuti, ma può richiedere fino a un'ora. Fino a quel momento, potresti ricevere un messaggio di errore.

2. Copia la chiave API.

5. Esempi di richieste

Puoi generare librerie client API con le librerie client Google API. Questi esempi mostrano come configurare la libreria API con alcuni dei linguaggi più comuni.

1. Fai una richiesta AnalyzeComment.
2. Esegui una di queste chiamate API di esempio per ottenere punteggi direttamente dall'API Perspective.

Il metodo AnalyzeComment emette una richiesta API per analizzare il campo comment.text per requestedAttributes, in questo caso il modello TOXICITY.

3. Incolla la tua chiave API nel campo API_KEY.

Se preferisci, puoi utilizzare il flag doNotStore per assicurarti che tutti i commenti inviati vengano eliminati automaticamente dopo la restituzione dei punteggi.

4. Leggi la documentazione di riferimento dell'API per maggiori dettagli su tutti i campi della richiesta e della risposta, nonché dei valori disponibili per requestedAttributes.

Puoi utilizzare anche attributi sperimentali come OBSCENE, ATTACK_ON_TARGETING e SPAM.

Python

Questa richiesta e risposta di esempio utilizza la versione Python delle librerie client delle API di Google.

1. Installa la libreria client di Python.
2. Esegui questi comandi:

Il risultato dovrebbe essere simile a questo output:

Il tuo annuncio ha ricevuto un punteggio di tossicità basso.

Node.js

Questa richiesta e risposta di esempio utilizza la versione Node.js delle librerie client delle API di Google.

1. Installa la libreria client per Node.js o installa il pacchetto npm googleapis.
2. Esegui questi comandi:

Il risultato dovrebbe essere simile a questo output:

URL

Questa richiesta e risposta di esempio utilizza il comando cURL. Questo comando dovrebbe funzionare per la maggior parte degli utenti di MacOS e Linux. Potresti dover installare cURL per eseguire questo comando.

• Sostituisci YOUR_KEY_HERE con la chiave API.

In questa risposta, il campo attributeScores.TOXICITY.summaryScore.value fornisce il punteggio del modello di tossicità per il commento. Il commento ha ricevuto un punteggio di 0,9 su 1,0.

6. Complimenti

L'API Perspective è stata avviata.

Scopri di più

• Il sito web dell'API Perspective contiene ulteriori informazioni sull'API, tra cui i case study.
• Il sito web degli sviluppatori di API Prospettiva contiene ulteriori informazioni su attributi, lingue e metodi. Se vuoi iniziare rapidamente, la pagina Metodi descrive come utilizzare i metodi AnalyzeComment e SuggestCommentScore.