Configura un datastore ServiceNow

Anteprima pubblica:le funzionalità di ricerca e azioni federate sono in Anteprima pubblica. Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina descrive come creare un datastore e connettere ServiceNow a Gemini Enterprise.

Prima di iniziare

Prima di configurare la connessione ServiceNow, assicurati di disporre di quanto segue:

• Concedi il ruolo Discovery Engine Editor (roles/discoveryengine.editor). Questo ruolo è necessario per consentire all'utente di creare il datastore. Per concedere questo ruolo:

  1. Nella console Google Cloud vai alla pagina IAM.

     Vai a IAM

  2. Individua l'account utente e fai clic sull'icona edit Modifica.
  3. Concedi all'utente il ruolo Discovery Engine Editor. Per saperne di più, consulta Ruoli e autorizzazioni IAM.

• Configura l'account ServiceNow e ottieni le credenziali di autenticazione

• Configura il ruolo di amministratore e utilizza l'account amministratore per impostare i ruoli utente e le autorizzazioni richiesti.

• Configura un Google Cloud progetto con un account amministratore in grado di gestire le configurazioni a livello di organizzazione, assicurandoti che l'organizzazione possa configurare un pool di forza lavoro. Assicurati che la tua organizzazione sia configurata per gestire un pool di forza lavoro.

• Per attivare le funzionalità di ricerca per parola chiave, assicurati che l'indicizzazione delle tabelle sia abilitata nell'istanza ServiceNow. Per informazioni, consulta Configurare la tabella per l'indicizzazione e la ricerca.

Crea datastore ServiceNow

Per creare un datastore ServiceNow:

1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

   Gemini Enterprise

2. Seleziona o crea un Google Cloud progetto.

   Nota: per accedere al flusso unificato, il tuo progetto deve essere incluso nella lista consentita.

3. Nel menu di navigazione, fai clic su Datastore.

4. Fai clic su Crea datastore.

5. Nella sezione Origine, cerca ServiceNow e fai clic su Seleziona.

6. Nella sezione Dati:

   1. Nella sezione Modalità connettore, seleziona Importazione dati o Ricerca federata come modalità di connessione.

   2. Fai clic su Continua.

   3. Nella sezione Impostazioni di autenticazione, configura l'autenticazione in base alla modalità di connessione scelta.

      • Se hai selezionato Ricerca federata, inserisci i seguenti dettagli:

        • URL istanza: l'URL di base della tua istanza ServiceNow.
        • ID client: l'ID client OAuth per la tua applicazione.
        • Client secret: il client secret OAuth per la tua applicazione.
        • URI di autenticazione: l'URL dell'endpoint di autorizzazione fornito da ServiceNow.
        • URI del token: l'URL dell'endpoint del token fornito da ServiceNow.
        • ID utente: l'ID utente ServiceNow.
        • Password: la password dell'utente ServiceNow.

      • Se hai selezionato Importazione dati, inserisci i seguenti dettagli:

        • URL istanza: l'URL di base della tua istanza ServiceNow.
        • ID client: l'ID client OAuth per la tua applicazione.
        • Client secret: il client secret OAuth per la tua applicazione.
        • ID utente: l'ID utente ServiceNow.
        • Password: la password dell'utente ServiceNow.

        Per ulteriori informazioni sulle credenziali, consulta Configurazione di ServiceNow.

      • Se hai selezionato Ricerca federata, fai clic su Accedi e completa l'accesso a ServiceNow.

   4. Fai clic su Continua.

   5. Se hai selezionato Ricerca federata, procedi nel seguente modo:

      1. Nella sezione Destinazioni:
         1. Inserisci l'URL dell'istanza del tuo sito ServiceNow.
         2. Inserisci l'URL di base del tuo sito ServiceNow.

      2. Fai clic su Continua.

      3. (Facoltativo) Nella sezione Opzioni avanzate, per mostrare o nascondere le tabelle di sistema ServiceNow, seleziona la casella di controllo Includi tabelle di sistema.

      4. Fai clic su Continua.

   6. Se hai selezionato Importazione dati, nella sezione Opzioni avanzate, segui questi passaggi:

      1. (Facoltativo) Nel campo Suffisso URL, inserisci il suffisso URL dal link del portale della conoscenza o del catalogo.
      2. (Facoltativo) Per consentire un insieme di indirizzi IP statici nel tuo sistema, seleziona la casella di controllo Abilita indirizzi IP statici.
      3. (Facoltativo) Nel campo Max QPS (QPS max), inserisci il numero massimo di query al secondo per applicare un limite di frequenza alle query che il connettore invia all'istanza ServiceNow.
      4. Fai clic su Continua.

   7. Nella sezione Entità da cercare (se hai selezionato Ricerca federata) o Entità da sincronizzare (se hai selezionato Importazione dati), seleziona tutte le entità richieste.

      • Se hai selezionato Ricerca federata, vai al passaggio successivo.
      • Se hai selezionato Importazione dei dati, continua con i seguenti passaggi:
        1. (Facoltativo) Per sincronizzare progetti specifici, segui questi passaggi:
           1. Fai clic su Filtro.
           2. Per filtrare le entità dall'indice, seleziona la casella di controllo Escludi dall'indice o, per assicurarti che siano incluse nell'indice, seleziona la casella di controllo Includi nell'indice.
           3. Inserisci le chiavi. Premi Invio dopo ogni tasto.
           4. Fai clic su Salva.
        2. Per configurare la pianificazione della sincronizzazione, segui questi passaggi:
           1. Nell'elenco Sync frequency (Frequenza di sincronizzazione), seleziona la frequenza di sincronizzazione.
              • Per pianificare sincronizzazioni complete separate dei dati di entità e identità, espandi il menu nella sezione Full sync (Sincronizzazione completa) e seleziona Custom options (Opzioni personalizzate).
           2. Nell'elenco Incremental sync frequency (Frequenza di sincronizzazione incrementale), seleziona la frequenza di sincronizzazione incrementale. Per saperne di più, vedi Pianificazioni di sincronizzazione.

7. Fai clic su Continua.

8. Nella sezione Azioni:

   • Se hai selezionato Ricerca federata, in Seleziona le azioni ServiceNow da attivare, seleziona le azioni della categoria per attivarle per il connettore.

   • Se hai selezionato Importazione dati:

     1. Nella sezione Impostazioni di autenticazione, configura l'autenticazione in base alla modalità di connessione scelta.

     2. Fornisci i seguenti dettagli di autenticazione, se necessario:

        • URL istanza: l'URL di base della tua istanza ServiceNow.
        • ID client: l'ID client OAuth per la tua applicazione.
        • Client secret: il client secret OAuth per la tua applicazione.
        • URI di autenticazione: l'URL dell'endpoint di autorizzazione fornito da ServiceNow.
        • URI del token: l'URL dell'endpoint del token fornito da ServiceNow.
        • ID utente: l'ID utente ServiceNow.
        • Password: la password dell'utente ServiceNow.

        Per ulteriori informazioni sulle credenziali, consulta Configurazione di ServiceNow.

     3. Fai clic su Accedi e accedi a ServiceNow per verificare il tuo account.

     4. Fai clic su Continua.

     5. (Facoltativo) Nella sezione Opzioni avanzate, per mostrare o nascondere le tabelle di sistema ServiceNow, seleziona la casella di controllo Includi tabelle di sistema.

     6. Fai clic su Continua.

     7. Nella sezione Destinazioni:

        1. (Facoltativo) Inserisci l'URL dell'istanza del tuo sito ServiceNow.
        2. (Facoltativo) Inserisci l'URL di base del tuo sito ServiceNow.

     8. Fai clic su Continua.

     9. In Seleziona le azioni ServiceNow da abilitare, seleziona le azioni dalla categoria per abilitarle per il connettore.

     Nota: se salti l'aggiunta di azioni in questo passaggio, devi creare un nuovo datastore per aggiungere azioni.

     Per visualizzare l'elenco delle azioni, vedi Visualizza le azioni.

9. Fai clic su Continua.

10. Nella sezione Configurazione:

    1. Dall'elenco Multiregionale, seleziona la posizione per il connettore dati.
    2. Nel campo Nome connettore dati, inserisci un nome per il connettore.
    3. Se hai selezionato US o EU come posizione, configura le impostazioni di crittografia:
       • (Facoltativo) Se non hai configurato le chiavi a singola regione, fai clic su Go to settings page (Vai alla pagina delle impostazioni) per farlo. Per saperne di più, consulta Registra una chiave a singola regione per i connettori di terze parti.
       • Seleziona Google-managed encryption key (Chiave di crittografia gestita daGoogle) o Cloud KMS key (Chiave Cloud KMS).
       • Se hai selezionato Chiave Cloud KMS:
         • Nell'elenco Tipo di gestione delle chiavi, seleziona il tipo appropriato.
         • Nell'elenco Chiave Cloud KMS, seleziona la chiave.
       Per saperne di più, vedi Chiavi di crittografia gestite dal cliente.

11. Fai clic su Continua.

12. Nella sezione Fatturazione, seleziona Prezzi generali o Prezzi configurabili. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti e Licenze.

13. Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Datastore.

Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Quando lo stato del datastore passa da Creazione ad Attivo, il connettore ServiceNow è pronto per essere utilizzato.

Per un connettore di importazione creato con ServiceNow, lo stato del datastore passa da Creazione a In esecuzione all'avvio della sincronizzazione. Dopodiché, lo stato diventa Active (Attivo) al termine dell'importazione, a indicare che il datastore è completamente configurato. A seconda del volume di dati, l'importazione potrebbe richiedere diverse ore.

Dopo aver creato il datastore, crea un'app, collegala al datastore ServiceNow e autorizza Gemini Enterprise ad accedere a ServiceNow prima di eseguire qualsiasi query.

Gestione dei dati ed esecuzione delle query

Questa sezione descrive come Gemini Enterprise gestisce la tua query e le implicazioni per la privacy dell'utilizzo del datastore federato.

Esecuzione delle query

Dopo aver autorizzato ServiceNow e inviato una query di ricerca a Gemini Enterprise:

• Gemini Enterprise invia la query di ricerca direttamente all'API ServiceNow.
• Gemini Enterprise combina i risultati con quelli di altre origini dati connesse e mostra un risultato di ricerca completo.

Gestione dei dati

Quando utilizzi la ricerca federata di terze parti, si applicano le seguenti regole di gestione dei dati:

• La stringa di query viene inviata al backend di ricerca di terze parti (API ServiceNow).
• Queste terze parti potrebbero associare le query alla tua identità.
• Se sono abilitate più origini dati di ricerca federata, la query potrebbe essere inviata a tutte.
• Una volta che i dati raggiungono il sistema di terze parti, sono regolati dai termini di servizio e dalle norme sulla privacy di quel sistema.

Nota:per migliorare l'accuratezza, un LLM potrebbe riscrivere la query prima dell'invio a ServiceNow. Questa query riscritta può incorporare informazioni dalla cronologia delle query della sessione. Di conseguenza, parti della cronologia delle query potrebbero essere incluse anche nella query inviata all'API ServiceNow.

Passaggi successivi

• Per fornire un'interfaccia utente per interrogare i dati ServiceNow, crea un'app e collegala al datastore ServiceNow.
• Per visualizzare l'elenco delle azioni, vedi Visualizza le azioni.
• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca.
• Per abilitare gli avvisi per il datastore, vedi Configura gli avvisi per i datastore di terze parti.