Collegare un'origine dati di terze parti

Nota: questa funzionalità è un'offerta in anteprima, soggetta ai "Termini dell'offerta pre-GA" dei Termini di servizio specifici per Google Cloud. I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Per ulteriori informazioni, consulta le descrizioni della fase di lancio. Inoltre, utilizzando questa funzionalità, accetti i Termini e condizioni di Anteprima dell'IA generativa ("Termini di anteprima"). Per questa funzionalità, puoi trattare i dati personali come descritto nell'Addendum per il trattamento dei dati Cloud, in conformità alle limitazioni e alle obbligazioni applicabili del Contratto (come definite nei Termini di anteprima).

Questa pagina descrive come collegare origini dati di terze parti a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Quando colleghi un'origine dati di terze parti, Vertex AI Search crea un connettore di dati e associa a questo i datastore (chiamati datastore di entità) per le entità specificate. I tipi di entità sono specifici dell'origine dati a cui ti connetti. Ad esempio, le entità di Jira Cloud includono problemi, allegati, commenti e log di lavoro.

Le origini dati di terze parti sono disponibili solo per le app di ricerca generiche. Chat, consigli e app per agenti non possono utilizzare origini dati di terze parti.

I connettori di terze parti non sono conformi a CMEK.

Per importare i dati da un'origine dati Google, consulta Creare un magazzino di dati di ricerca.

Prima di iniziare

1. Contatta il team degli Account Google e richiedi di essere aggiunto alla lista consentita per i connettori delle origini dati di terze parti.

2. Vai alla sezione relativa alla fonte che intendi utilizzare:

   • Collegare Adobe Experience Manager
   • Collegare AODocs (lista consentita aggiuntiva)
   • Collegare Asana
   • Connect Box
   • Connect Coda (lista consentita aggiuntiva)
   • Collegare Confluence Cloud
   • Collegare Confluence Data Center on-premise
   • Collegare Dropbox
   • Collegare Dynamics 365
   • ID Entra di Connect
   • Collega GitHub (lista consentita aggiuntiva)
   • Connetti GitLab (lista consentita aggiuntiva)
   • Collegare Jira Cloud
   • Collegare Jira Data Center on-premise
   • Collegare Microsoft Outlook (lista consentita aggiuntiva)
   • Collegare Microsoft Teams (lista consentita aggiuntiva)
   • Connect Monday
   • Collegare Notion (lista consentita aggiuntiva)
   • Connetti Okta
   • Collegare OneDrive
   • Collegare Salesforce
   • Collegare ServiceNow
   • Collegare il data center SharePoint on-premises
   • Collegare SharePoint Online
   • Collegare Slack
   • Collegare Trello
   • Collegare WordPress
   • Collegare Workday
   • Collegare Zendesk (lista consentita aggiuntiva)

Collegare Adobe Experience Manager

Utilizza la procedura seguente per sincronizzare i dati da Adobe Experience Manager a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore di Adobe Experience Manager deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   • Credenziali di servizio dell'istanza Adobe Experience Manager
   • URL dell'istanza del sito Adobe Experience Manager

Crea un connettore Adobe Experience Manager

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Adobe Experience Manager a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Adobe Experience Manager per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Adobe Experience Manager e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ricevere risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collegare AODocs

Utilizza la procedura seguente per sincronizzare i dati da AODocs a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore di AODocs deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   • ID istanza (URL di dominio dell'istanza AODocs)
   • ID client
   • Client secret

Crea un connettore AODocs

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da AODocs a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca AODocs per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di AODocs e fai clic su Autentica. Viene visualizzata una nuova finestra.

6. Connettiti al tuo account e verifica che l'operazione sia andata a buon fine prima di tornare alla pagina Specifica l'origine AODocs per il tuo datastore.

7. Seleziona le entità da sincronizzare e fai clic su Continua.

8. Seleziona una regione per il tuo datastore.

9. Inserisci un nome per il connettore dati.

10. Seleziona una frequenza di sincronizzazione.

11. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

12. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca. Se hai utilizzato il controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Collegare Asana

Utilizza la procedura seguente per sincronizzare i dati da Asana a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

• Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

• Un amministratore di Asana deve generare o ottenere il token di accesso personale (PAT) riportato di seguito per l'autenticazione. Per saperne di più, consulta la sezione Token di accesso personale nella documentazione di Asana.

Per invitare un membro a uno spazio di lavoro Asana:

1. Accedi all'applicazione Asana con il tuo account amministratore.

2. Fai clic sull'icona del profilo e seleziona Console di amministrazione.

3. Fai clic su Invita membro. Inserisci l'indirizzo email dell'utente e il progetto che vuoi aggiungere.

4. Fai clic su Invia. L'utente accetta l'invito per assicurarsi di essere aggiunto al progetto.

Per generare un token PAT:

1. Apri la Asana Developer Console.

2. Fai clic su Le mie app.

3. Fai clic su Crea token.

4. Nella finestra di dialogo Crea nuovo token, inserisci le informazioni richieste.

5. Fai clic su Crea token.

6. Copia il token per utilizzarlo in un secondo momento.

7. Fai clic su Fine.

Creare un connettore cloud Asana

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Asana a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

2. Nel menu di navigazione, seleziona Data Store.

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Asana per collegare l'origine di terze parti.

5. Inserisci i dettagli di autenticazione, incluso il token PAT generato.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Scegli una regione per il datastore.

8. Specifica un nome per il datastore.

9. Imposta una frequenza di sincronizzazione per il datastore.

10. Fai clic su Crea. Vertex AI Search crea e mostra i tuoi datastore nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app e del datastore, consulta Generare risultati di ricerca. Se hai utilizzato il controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connect Box

Utilizza la procedura seguente per sincronizzare i dati da Box a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere inserito nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Devi disporre dell'accesso amministrativo all'istanza Box con l'autenticazione a due fattori abilitata. Tutte le istruzioni di configurazione possono essere eseguite solo dall'account amministratore.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Leggi la sezione Configurazione con JWT nella documentazione di Box per una panoramica della configurazione con screenshot.

Creare un'app Box

1. Accedi alla Box Developer Console con il tuo account amministratore.
2. Fai clic su Crea app di piattaforma.
3. Seleziona Tipo di app come App personalizzata.
4. Inserisci il nome dell'app.
5. Imposta le seguenti proprietà:
   1. Scopo: integrazione
   2. Categorie: AI
   3. Sistema esterno: Google Cloud Agent Builder
6. Seleziona Authentication method (Metodo di autenticazione) come Server authentication (with JWT) (Autenticazione server con JWT).
7. Fai clic su Crea app.

Configurare l'app Box

1. Nella Box Developer Console, scegli la piattaforma dell'app e vai alla scheda Configurazione.
2. Nella sezione Livello di accesso alle app, seleziona App + Accesso aziendale.

3. Nella sezione Ambiti dell'applicazione, seleziona i seguenti ambiti:

   1. Leggi tutti i file e le cartelle archiviati in Box
   2. Scrivi tutti i file e le cartelle archiviati in Box
   3. Gestire gli utenti
   4. Gestire i gruppi
   5. Gestire le proprietà aziendali

4. Nella sezione Funzionalità avanzate, seleziona Effettua chiamate API utilizzando l'intestazione utente.

5. Nella sezione Aggiungi e gestisci chiavi pubbliche, fai clic su Genera una coppia di chiavi pubblica/privata.

   1. La chiave pubblica viene caricata automaticamente nella console con un ID. Questo ID viene utilizzato durante la creazione di una connessione.
   2. Puoi scaricare un file di configurazione con la chiave privata e la passphrase. Assicurati di conservare questo file per un uso futuro.
   3. Se vuoi, per generare la tua chiave, consulta la guida alla configurazione della coppia di chiavi Box.

6. Fai clic su Salva modifiche.

Autorizza l'app Box

1. Nella Box Developer Console, scegli la piattaforma dell'app e vai alla scheda Autorizzazione.
2. Fai clic su Rivedi e invia.
3. Nella finestra di dialogo Esamina l'invio dell'autorizzazione per l'app, fai clic su Invia.
4. Accedi al gestore delle app della piattaforma di amministrazione di Box con il tuo account amministratore.
5. Scegli l'app di piattaforma che hai configurato.
6. Fai clic sui tre puntini (…) nella riga corrispondente.
7. Seleziona Autorizza app dall'elenco a discesa.
8. Nella finestra di dialogo Autorizza app, fai clic su Autorizza per completare la procedura di autorizzazione.

Prepara le seguenti informazioni di autenticazione di Box:

• ID azienda: ottienilo dalla scheda Impostazioni generali.
• ID client e client secret: li puoi trovare nella scheda Configurazione in Credenziali OAuth 2.0.
• Chiave privata, ID chiave e Passphrase: questi parametri sono stati già generati e scaricati in un file locale dalla scheda Configurazione in Aggiungi e gestisci chiavi pubbliche durante la configurazione dell'app.

Creare un connettore Box

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Box a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Box per collegare la tua origine di terze parti.

5. Inserisci le informazioni di autenticazione.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il tuo datastore.

9. Seleziona una frequenza di sincronizzazione per il tuo datastore.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app e del datastore, consulta Generare risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Connetti Coda

Utilizza la procedura seguente per sincronizzare i dati da Coda a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore di Coda deve generare o ottenere il token API Coda per l'integrazione con Vertex AI Search.

Creare un connettore Coda

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Coda a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Coda per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Coda e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Generare risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collegare Confluence Cloud

Utilizza la procedura riportata di seguito per sincronizzare i dati da Confluence Cloud a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere inserito nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, puoi scegliere la frequenza con cui il datastore si sincronizza con l'origine.

Prima di iniziare

Prima di configurare la connessione:

1. Verifica di disporre dell'accesso amministrativo all'istanza e al progetto Confluence.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

Configurare l'autenticazione e le autorizzazioni in Confluence

Assicurati di disporre dei dettagli di autenticazione e dell'accesso amministrativo necessari per la tua istanza di Confluence. Segui le istruzioni riportate di seguito per creare un ID client e un client secret tramite la console per sviluppatori Atlassian, configurare gli ambiti OAuth 2.0 richiesti, impostare le autorizzazioni per gli utenti, recuperare l'URL e l'ID dell'istanza, configurare i ruoli e autenticarti per sincronizzare i dati tra Confluence Cloud e Vertex AI Search. Per attivare OAuth 2.0 e ottenere l'ID client e il client secret, consulta la sezione App OAuth 2.0 (3LO) nella documentazione per gli sviluppatori di Atlassian.

1. Crea un'integrazione OAuth 2.0 in Atlassian Developer Console:

   1. Accedi ad Atlassian Developers Console.
   2. Fai clic sull'icona del profilo e seleziona Atlassian Developer Console.
   3. Fai clic su Crea e seleziona Integrazione OAuth 2.0.
   4. Inserisci un nome per l'app ed esegui le seguenti operazioni:
      1. Seleziona la casella di controllo dei Termini e condizioni.
      2. Fai clic su Crea.
      3. Fai clic su Autorizzazione.
      4. Nella tabella Tipo di autorizzazione, seleziona Aggiungi per OAuth 2.0 (3LO).
   5. Nel campo URL di callback, inserisci https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html.
   6. Fai clic su Salva modifiche.

   Se viene visualizzato l'avviso: La tua app non ha API. Aggiungi le API alla tua app, vai al passaggio 2 e completa tutti i passaggi rimanenti. In caso contrario, vai ai passaggi 4 e 5.

2. Attiva OAuth 2.0:

   1. Fai clic su Autorizzazioni.
   2. Vai all'API Confluence.
   3. Fai clic su Aggiungi.
   4. Fai clic su Configura.
   5. Vai alla scheda Ampi spazi di azione e fai clic su Modifica ambiti.
   6. Seleziona i seguenti ambiti.

      Visualizza ambiti

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence
   7. Verifica che siano selezionati sette ambiti e salva le modifiche.

3. Ottieni l'ID client e il client secret:

   1. Fai clic su Distribuzione.
   2. Seleziona Modifica.
   3. Seleziona Condivisione per attivare la modifica di altri campi.
   4. Compila i campi rimanenti.
   5. Seleziona Sì quando vedi Does your app store personal data?
   6. Seleziona Impostazioni per copiare l'ID client e il client secret.

4. Ottieni l'URL dell'istanza:

   1. Vai ad atlassian.net e accedi con il tuo account amministratore.
   2. Seleziona l'app che vuoi sincronizzare. Ad esempio, sincronizza la prima app.
   3. Trova l'URL dell'istanza. Viene visualizzato come sottodominio nella barra degli indirizzi.

5. Ottieni l'ID istanza:

   1. Apri una nuova scheda, copia l'URL dell'istanza e aggiungi /_edge/tenant_info all'URL dell'istanza. Ad esempio, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info.
   2. Vai al link per trovare il valore cloudId. cloudId è l'ID istanza.

Configurare autorizzazioni e ruoli

1. Accedi ad atlassian.com con il tuo account amministratore.
2. Fai clic sull'icona del menu o vai alla pagina admin.atlassian.com.
3. Nella pagina Amministrazione, fai clic su Gestisci utenti e vai alla pagina Gruppi.
4. Vai al sito del tuo dominio Atlassian e apri l'istanza di Confluence Cloud.
5. Vai a IAM.

6. Concedi all'amministratore di Confluence il ruolo Discovery Engine. In questo modo, l'amministratore di Confluence può configurare il connettore come descritto in Creare un connettore Confluence Cloud.

7. Concedi a un utente il ruolo di amministratore:

   1. Crea un account utente dedicato. Utilizza questo account per la configurazione del data store.
   2. Assegna il ruolo Amministratore al nuovo utente.

8. Configura le autorizzazioni in Atlassian:

   1. Vai al sito del tuo dominio Atlassian e apri l'istanza di Confluence Cloud. In alternativa, vai direttamente all'indirizzo admin.atlassian.com.

   2. Fai clic sull'icona del menu e seleziona l'opzione richiesta.

   3. (Facoltativo) Se richiesto, seleziona l'organizzazione appropriata dalla pagina di destinazione.

9. Crea e configura i gruppi:

   1. Nella pagina Amministratore, fai clic sul pulsante Gestisci utenti, se necessario, e seleziona Gestisci utenti dall'elenco a discesa.
   2. Nella pagina Gestione utenti, seleziona Gruppi.
   3. Fai clic su Crea gruppo e assegna un nome. Utilizza questo gruppo per assegnare le autorizzazioni richieste dal connettore.

10. Aggiungi le autorizzazioni al gruppo: assegna il ruolo Amministratore dell'accesso utente.

11. Assegna i membri del gruppo:

    1. Nella pagina Gruppo, fai clic su Aggiungi prodotto e seleziona il ruolo del prodotto appropriato dall'elenco a discesa.In questo caso, seleziona Amministratore dell'accesso utente.
    2. Fai clic su Aggiungi per confermare l'assegnazione del ruolo.
    3. Fai clic su Aggiungi membri del gruppo per includere account utente o membri del gruppo. Assicurati che il connettore si autentichi per conto di questi utenti per recuperare i documenti.

Affinché le autorizzazioni utente vengano applicate correttamente, ogni utente di Confluence Cloud deve rendere il proprio indirizzo email visibile a tutti gli utenti. Per farlo, modifica le impostazioni di visibilità email in Confluence Cloud e imposta la visibilità su Anyone. Per saperne di più, consulta Impostare la visibilità delle email nella documentazione di Atlassian.

Creare un connettore Confluence Cloud

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Confluence Cloud a Vertex AI Search:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Confluence per collegare l'origine di terze parti.

5. Inserisci i tuoi dati di autenticazione e fai clic su Autentica.

6. Viene visualizzata una nuova finestra. Inserisci il nome utente e la password dell'istanza. Verifica che l'autenticazione sia andata a buon fine prima di tornare alla pagina Specifica l'origine Confluence per il tuo datastore.

7. Seleziona le entità da sincronizzare e fai clic su Continua.

8. Seleziona una regione per il connettore dati.

9. Inserisci un nome per il connettore dati.

10. Seleziona una frequenza di sincronizzazione.

11. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

12. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connettere Confluence Data Center on-premise

Utilizza questa procedura per creare un datastore e un'app di ricerca Confluence Data Center in Agent Builder, sincronizzando i dati di Confluence on-premise con Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, puoi scegliere la frequenza con cui il datastore si sincronizza con l'origine.

Prima di iniziare

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

1. Collegamento di servizio (obbligatorio solo per il tipo di destinazione privata): configura un collegamento di servizio per il trasferimento sicuro dei dati.
2. Nome utente e password: ottieni credenziali valide per l'autenticazione dall'amministratore di Confluence.
3. (Facoltativo per il tipo di destinazione privata) URL del dominio: specifica l'URL dell'istanza di Confluence Data Center.
4. (Facoltativo) Nome di dominio di base: specifica il nome di dominio di base per l'istanza di Confluence.
5. (Facoltativo) Porta di destinazione: identifica la porta utilizzata per la comunicazione con il data center di Confluence.

6. Utilizza le seguenti linee guida di configurazione per stabilire connessioni con Private Service Connect(PSC). Modifica o aggiungi le risorse in base alle esigenze. Assicurati che il collegamento di servizio PSC sia configurato correttamente per connettersi all'istanza privata e soddisfi i requisiti per un servizio pubblicato.

   1. Configura le impostazioni di rete:

      1. Posiziona il collegamento al servizio PSC e il bilanciatore del carico in subnet diverse all'interno della stessa rete Virtual Private Cloud.

      2. Il sistema di backend deve rimanere chiuso alla rete pubblica per motivi di sicurezza. Tuttavia, assicurati che possa accettare il traffico dalle seguenti origini:

         • Per i bilanciatori del carico basati su proxy/HTTP(S) (ILB proxy L4, ILB L7), configura il backend in modo che accetti le richieste dalla subnet proxy nella rete Virtual Private Cloud.

         • Per ulteriori informazioni, consulta la documentazione sulle subnet solo proxy per i bilanciatori del carico basati su Envoy.

   2. Modifica le regole del firewall:

      1. Regole in entrata:

         • Consenti il traffico dalla subnet del collegamento a un servizio PSC alla subnet del bilanciatore del carico interno (ILB).
         • Assicurati che il bilanciatore del carico possa inviare traffico al backend.
         • Consenti ai probe del controllo di integrità di raggiungere il backend.

      2. Regole in uscita: attivano il traffico in uscita per impostazione predefinita, a meno che non vengano applicate regole di rifiuto specifiche.

7. Considerazioni aggiuntive: assicurati di mantenere tutti i componenti, inclusi l'attacco del servizio PSC e il bilanciatore del carico, nella stessa regione.

Generare un allegato del servizio

Per generare un allegato del servizio:

1. Scegli il tipo di endpoint: seleziona Pubblico o Privato.

2. Per l'endpoint Pubblico: se il Tipo di destinazione del data center di Confluence è Pubblico, non è necessario creare la configurazione per l'attacco del servizio. In alternativa, puoi utilizzare il tuo URL pubblico nel campo URL dominio della console Google Cloud durante la creazione del connettore.

3. Per l'endpoint Privato:

   1. Utilizza Private Service Connect (PSC) per abilitare le connessioni dalle istanze private a Google Cloud.
   2. Crea una rete Virtual Private Cloud e le subnet necessarie.
   3. Crea un'istanza di una macchina virtuale (VM) e installa il servizio di backend.
   4. (Facoltativo) Configura un probe di controllo di integrità per monitorare l'integrità del backend.
   5. Aggiungi un bilanciatore del carico per instradare il traffico alla VM o al backend.
   6. Definisci le regole del firewall per consentire il traffico tra l'endpoint PSC e il backend.
   7. Pubblica l'endpoint creando un collegamento del servizio PSC.

Creare un utente di Confluence Data Center e configurare le autorizzazioni

Per consentire a Vertex AI Search di ottenere dati da Confluence, devi creare un nuovo utente con le autorizzazioni minime necessarie. Per creare l'utente e configurare le autorizzazioni richieste, segui questi passaggi.

1. Accedi come amministratore:

   1. Vai al sito del tuo dominio Atlassian e apri l'istanza di Confluence Data Center.
   2. Inserisci il nome utente e la password di amministratore.
   3. Fai clic su Accedi.

2. Crea un nuovo utente:

   Quando crei un data store, devi creare un utente per ottenere i dati dall'istanza di terze parti.

   1. Fai clic sull'icona delle impostazioni.
   2. Seleziona Gestione utenti.
   3. Inserisci le credenziali di amministratore, se richiesto.
   4. Nella pagina Amministrazione, fai clic su Crea utente.
   5. Inserisci l'indirizzo email, il nome completo, il nome utente e la password.
   6. Fai clic su Crea utente.

3. Assegna l'utente a un gruppo:

   1. Nella pagina Amministrazione di Confluence, vai alla scheda Utenti e sicurezza e fai clic su Gruppi.
   2. Fai clic su Aggiungi gruppo. Inserisci un nome per il gruppo e crealo.
   3. Nel campo Trova gruppo, inserisci il nome del gruppo da trovare.
   4. Fai clic sull'icona delle impostazioni.
   5. Seleziona l'account del profilo e vai a Gestione utenti.
   6. Nella pagina Utenti, in Elenca utenti, cerca l'utente appena creato nel campo Trova utente.
   7. Fai clic sull'utente per aprire la pagina Visualizza utenti.
   8. Fai clic su Modifica gruppi per aprire la pagina Modifica gruppo di utenti.
   9. Seleziona la casella di controllo relativa al gruppo di utenti creato.
   10. Fai clic su Salva per assegnare l'utente al gruppo appena creato.

   L'utente aggiunto viene assegnato nella sezione Membri del gruppo.

4. Configura le autorizzazioni utente:

   1. Nella pagina Amministrazione di Confluence, vai alla scheda Problemi.
   2. Individua Autorizzazioni.
   3. Seleziona Visualizza autorizzazioni globali.
   4. Seleziona Modifica autorizzazioni.
   5. Nella pagina Modifica autorizzazioni globali, cerca il gruppo assegnato all'utente e attiva l'opzione Può utilizzare.

Configurare lo spazio della documentazione

1. Fai clic sull'icona Confluence per passare alla pagina Dashboard.
2. Fai clic su Crea spazio.
3. Seleziona Spazio di documentazione e fai clic su Avanti.
4. Inserisci tutti i dettagli necessari e fai clic su Crea per creare lo spazio della documentazione.
5. In I miei spazi, fai clic sullo spazio appena creato.
6. Vai a Pagine e apri il menu (tre puntini).
7. Seleziona Restrizioni.
8. Nel menu a discesa Restrizioni, seleziona l'opzione Visualizzazione e modifica con limitazioni.
9. Cerca il gruppo e assegna l'autorizzazione può visualizzare.
10. Fai clic su Applica. L'utente viene creato con accesso minimo e le autorizzazioni sono impostate per gli spazi. Puoi anche assegnare autorizzazioni ai blog.

Creare un connettore Confluence Data Center on-premise

Console

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Data center Confluence per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione e fai clic su Continua.

6. Nell'elenco a discesa Tipo di destinazione, seleziona Pubblico o Privato.

   1. Per il tipo di destinazione Pubblico, non è necessario creare la configurazione per l'attacco del servizio. In alternativa, puoi utilizzare il tuo URL pubblico nel campo URL del dominio della console Google Cloud.
   2. Per il tipo di destinazione Privato, inserisci tutte le informazioni richieste:
      1. Se la tua istanza ha un URL di dominio:
         • Collegamento servizio: inserisci il collegamento servizio.
         • (Facoltativo) Nome di dominio di base: inserisci il dominio di base.
         • URL del dominio: inserisci l'URL del dominio.
         • (Facoltativo) Porta di destinazione: inserisci la porta di destinazione.
      2. Se la tua istanza non ha un URL di dominio:
         • Collegamento servizio: inserisci il collegamento servizio.
         • (Facoltativo) Porta di destinazione: inserisci la porta di destinazione.

7. Fai clic su Continua.

8. (Facoltativo) Opzioni avanzate: seleziona e attiva Impostazioni proxy e Impostazioni SSL, se necessario.

9. In Entità da sincronizzare, seleziona tutte le entità richieste da sincronizzare e fai clic su Continua.

10. Seleziona una regione per il connettore dati e inserisci un nome.

11. Seleziona una frequenza di sincronizzazione.

Per il tipo di destinazione Privato, dopo che hai inviato i dettagli del connettore, VAIS invia una richiesta di connessione al tuo PSC. Vai al connettore per visualizzare un messaggio che ti chiede di inserire un projectId nella lista consentita del PSC. Il connettore rimane nello stato Error finché non consenti la connessione in PSC. Quando accetti la richiesta di connessione, il connettore passa allo stato Attivo durante l'esecuzione della sincronizzazione successiva. Se configuri il PSC in modo che accetti tutte le connessioni, il connettore passa automaticamente allo stato Attivo dopo la creazione.

Per il tipo di destinazione Pubblica, il connettore passa automaticamente allo stato Attivo dopo l'invio.

Per verificare lo stato del data store e dell'attività di importazione:

1. Vai al connettore nell'elenco dei datastore e monitora il relativo stato finché non diventa Attivo.
2. Dopo che lo stato del connettore diventa Attivo, fai clic sull'entità richiesta e verifica che tutte le entità selezionate siano importate. Lo stato del datastore passa da Creazione a In esecuzione all'inizio della sincronizzazione e diventa Attivo al termine dell'importazione, a indicare che il datastore è configurato. A seconda delle dimensioni dei dati, l'importazione può richiedere diverse ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.
• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Collegare Dropbox

Utilizza la procedura seguente per sincronizzare i dati da Dropbox con Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Configura il controllo degli accessi per l'origine dati. Per ulteriori informazioni, consulta Utilizzare il controllo dell'accesso alle origini dati.

2. Prepara le seguenti informazioni di autenticazione di Dropbox. Per informazioni sulla configurazione di questi parametri, consulta la guida di OAuth nella documentazione di Dropbox.

   • ID client
   • Client secret

Creare un connettore Dropbox

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Dropbox con Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Dropbox per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Dropbox e fai clic su Autentica. Viene visualizzata una nuova finestra.

6. Autentica il tuo account e verifica che l'operazione sia andata a buon fine prima di tornare alla pagina Specifica l'origine Dropbox per il tuo datastore.

7. Seleziona le entità da sincronizzare e fai clic su Continua.

8. Seleziona una posizione per il tuo datastore.

9. Inserisci un nome per il tuo datastore.

10. Seleziona una frequenza di sincronizzazione per il tuo datastore.

11. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

12. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata. Controlla la scheda Documenti per verificare che le entità siano state importate correttamente.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app e del datastore, consulta Generare risultati di ricerca. Se hai utilizzato il controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connetti Dynamics 365

Utilizza la procedura seguente per sincronizzare i dati da Dynamics 365 a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Attenzione: questo connettore fornisce un supporto ACL parziale. Durante l'anteprima privata, i domini utente vengono verificati, ma la verifica granulare degli utenti non è supportata.

Prima di iniziare

Prima di creare un connettore Dynamics 365:

1. Un amministratore di Dynamics 365 deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   • ID client
   • Client secret
   • Tenant Azure
   • URL dell'organizzazione

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

Creare un connettore Dynamics 365

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Dynamics 365 a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Dynamics 365 per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Dynamics 365 e fai clic su Continua.

6. Inserisci l'URL del tenant e dell'organizzazione Azure e fai clic su Continua.

7. Seleziona le entità da sincronizzare e fai clic su Continua.

8. Seleziona una regione per il tuo datastore.

9. Inserisci un nome per il connettore dati.

10. Seleziona una frequenza di sincronizzazione.

11. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

12. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca. Se hai utilizzato il controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Collega Entra ID

Utilizza la procedura seguente per sincronizzare i dati da Entra ID a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

2. Per ottenere l'ID client e il secret client:

   1. Crea un'applicazione Entra ID:

      1. Accedi al Centro amministrazione di Microsoft Entra e fai clic su Application (Applicazione).
      2. Nell'elenco a discesa Application (Applicazione), fai clic su App registrations (Registrazioni app).
      3. Nella pagina Registrazioni app, fai clic su Nuova registrazione.
      4. Fai clic su Aggiungi nuova registrazione ed esegui le seguenti operazioni:
         • Inserisci un nome per l'applicazione.
         • In Tipi di account supportati, seleziona Solo account nella directory dell'organizzazione.
         • In Redirect URI (URI di reindirizzamento), aggiungi un URI di reindirizzamento web che rimandi a: https://login.microsoftonline.com/common/oauth2/nativeclient.
      5. Fai clic su Registrati.

   2. Salva le credenziali:

      Nella finestra dell'applicazione registrata, salva i seguenti valori per utilizzarli in un secondo momento:

      1. Utilizza l'ID applicazione (client) per impostare il parametro ID client.
      2. Utilizza l'ID directory (tenant) per impostare il parametro Azure Tenant.

   3. Crea il client secret:

      1. Vai a Certificati e secret e crea un nuovo client secret:
      2. Fai clic su Nuovo segreto client e specifica la durata richiesta.
      3. Salva il client secret e copia il valore della chiave per utilizzarlo in un secondo momento.

Configura le autorizzazioni dell'API Entra ID

1. Nella finestra dell'applicazione registrata, fai clic su Autorizzazioni API.

2. In Autorizzazioni configurate, seleziona Microsoft Graph e configura la seguente autorizzazione:

   Visualizza autorizzazioni

   • User.Read.All (Application)

   Se vuoi importare profileCardAttributes, configura le seguenti autorizzazioni:

   Visualizza autorizzazioni

   • People.Read.All (Application)
   • PeopleSettings.Read.All (Application)

3. Concedi il consenso dell'amministratore per tutte le autorizzazioni aggiunte. Il consenso di un amministratore è necessario per utilizzare le credenziali client nel flusso di autenticazione.

Crea un connettore Entra ID

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Entra ID a Vertex AI Search:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca ID Entra per collegare l'origine di terze parti.

5. In Impostazioni di autenticazione, inserisci l'ID client e il client secret.

6. Salta l'opzione Destinazioni e fai clic su Continua.

7. In Opzioni avanzate, inserisci l'ID tenant Azure.

8. Fai clic su Continua.

9. In Entità da sincronizzare, seleziona Profili utente.

10. Fai clic su Continua.

11. In Configura il connettore dati, seleziona una regione per il tuo datastore.

12. Inserisci un nome per il connettore dati.

13. Seleziona una frequenza di sincronizzazione.

14. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

15. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

16. Quando lo stato del connettore diventa Attivo, vai alla scheda Entità.

17. Fai clic sull'entità userprofiles.

18. Controlla il numero di documenti importati e assicurati che corrisponda al numero di utenti in Entra ID.

    Se l'app Entra ID dispone delle autorizzazioni necessarie per importare gli attributi personalizzati, immagazzina fino a 15 attributi della scheda del profilo per record. Per impostazione predefinita, gli attributi personalizzati non sono disponibili per la ricerca.

Per rendere gli attributi personalizzati disponibili per la ricerca:

1. Nella pagina userprofiles, vai alla scheda Schema.
2. Fai clic su Modifica.

3. Deseleziona gli attributi, ad esempio address, per impedire che siano recuperabili, cercabili e indicizzati, quindi fai clic su Salva.

   Il pulsante Modifica rimane inattivo per alcuni minuti prima di riattivarsi.

4. Quando il pulsante Modifica è in stato Attivo, fai clic su Modifica.

5. Seleziona le caselle Raccoglibili, disponibili per la ricerca e indicizzabili per gli attributi personalizzati obbligatori.

6. Attiva la ricerca.

7. Fai clic su Salva.

Testa il motore di ricerca

Dopo aver configurato il motore di ricerca, testa le sue funzionalità. In questo modo, restituisce risultati accurati in base all'accesso utente.

1. Attiva l'app web:

   1. Vai alle configurazioni di integrazione dell'app e attiva l'opzione Attiva l'app web.

2. Testa l'app web:

   1. Fai clic su Apri accanto al link dell'app web ed esegui l'accesso come utente.

   2. Verifica che i risultati di ricerca siano limitati agli elementi accessibili all'utente.

Visualizzare l'anteprima dei risultati di ricerca di persone

1. Nell'app di ricerca, vai a Anteprima e inizia a cercare all'interno della console quando utilizzi l'IDP Google.

   • In alternativa, vai al link fornito e accedi con il tuo provider di identità per iniziare a cercare.
   • I risultati di ricerca vengono visualizzati come schede di persona, con i dettagli dell'utente, come nome, qualifica, email e immagine del profilo.

2. Fai clic su una scheda di persona per visualizzare una pagina del profilo dettagliata, che include quanto segue:

   • Nome
   • Immagine del profilo
   • Posizione professionale
   • Reparto
   • Catena di gestione
   • Dipendenti subordinati

3. Se gli attributi personalizzati (proprietà della scheda del profilo) vengono importati e resi indicizzati, disponibili per la ricerca e recuperabili:

   • La ricerca per un valore dell'attributo personalizzato restituisce solo i profili delle persone contenente questi attributi.
   • Gli attributi personalizzati vengono visualizzati nei risultati di ricerca, ma è possibile accedervi solo tramite l'API, non tramite l'interfaccia utente di Vertex Search.

Configurare il pool di forza lavoro per l'IdP non Google senza SSO

1. Se i tuoi dipendenti utilizzano un IdP diverso da Google, non dispongono dell'accesso SSO con Google o non sono clienti di Google Workspace, configura un pool di risorse umane come descritto in Utilizzare il controllo dell'accesso alle origini dati per attivare la ricerca dei dipendenti.

   Il pool di forza lavoro ti consente di gestire e autenticare gli utenti di provider di identità esterni, come Azure o Okta, all'interno della console Google Cloud.

2. Per configurare il pool di personale e attivare l'app web per un accesso senza problemi da parte degli utenti, segui questi passaggi:

   1. Crea il pool di forza lavoro a livello di organizzazione in Google Cloud seguendo il manuale di configurazione appropriato:

      1. Configurazione di OIDC di Azure
      2. Configurazione di Azure SAML
      3. Configurazione di Okta e OIDC
      4. Configurazione di Okta e SAML

   2. Configura il pool di risorse in Agent Builder > Impostazioni per la regione in cui crei l'app.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connetti GitHub

Utilizza la procedura seguente per sincronizzare i dati da GitHub con Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore di GitHub deve ottenere il token di accesso personale dell'istanza GitHub per l'integrazione con Vertex AI Search.

Creare un connettore GitHub

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da GitHub con Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca GitHub per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di GitHub e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ricevere risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Connetti GitLab

Utilizza la procedura seguente per sincronizzare i dati da GitLab con Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore di GitLab deve ottenere il token di accesso personale dell'istanza di GitLab per l'integrazione con Vertex AI Search.

Crea un connettore GitLab

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da GitLab a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca GitLab per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di GitLab e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Generare risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Connetti Jira Cloud

Utilizza la procedura seguente per sincronizzare i dati da Jira Cloud a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere inserito nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, puoi scegliere la frequenza con cui il datastore si sincronizza con l'origine.

Prima di iniziare

Prima di configurare la connessione:

• Configura il controllo dell'accesso. Assicurati che il controllo degli accessi sia configurato correttamente per l'origine dati. Questo passaggio garantisce che solo gli utenti autorizzati possano accedere ai dati e gestirli. Per ulteriori informazioni, consulta la documentazione Utilizzare il controllo dell'accesso alle origini dati.
• Affinché le autorizzazioni utente vengano applicate correttamente, gli utenti di Jira Cloud devono fornire il consenso alla condivisione.
• Assicurati di avere un account Atlassian, un'istanza Jira e un progetto.
• Verifica di disporre dell'accesso amministrativo all'istanza e al progetto Jira.

Configurare l'autenticazione e le autorizzazioni in Jira

Segui le istruzioni riportate nelle sezioni seguenti per assicurarti di disporre dei dettagli di autenticazione e dell'accesso amministrativo necessari all'istanza Jira. Crea un ID client e un client secret tramite Atlassian Developer Console, configura gli ambiti OAuth 2.0 richiesti, imposta le autorizzazioni per gli utenti, recupera l'URL e l'ID dell'istanza, configura i ruoli e autenticati per sincronizzare i dati tra Jira Cloud e Vertex AI Search.

Creare l'ID client e il client secret

Nota: per attivare OAuth 2.0 e ottenere l'ID client e il client secret, consulta [App OAuth 2.0 (3LO)] [confluence-oauth] nella documentazione per gli sviluppatori di Atlassian.

1. Crea un'integrazione OAuth 2.0 in Atlassian Developer Console:

   1. Accedi ad Atlassian Developer Console.
   2. Fai clic sull'icona del profilo e seleziona Console per sviluppatori.
   3. Fai clic su Crea e seleziona Integrazione OAuth 2.0.

   4. Inserisci un nome per l'app ed esegui le seguenti operazioni:

      1. Seleziona la casella di controllo Termini e condizioni.
      2. Fai clic su Crea.
      3. Fai clic su Autorizzazione.
      4. Nella tabella Tipo di autorizzazione, seleziona Aggiungi per OAuth 2.0 (3LO).

   5. Nel campo URL di callback, inserisci https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html.

   6. Fai clic su Salva modifiche.

   Se viene visualizzato l'avviso: La tua app non ha API. Aggiungi le API alla tua app, vai al passaggio 2 e completa tutti i passaggi rimanenti. In caso contrario, vai ai passaggi 4 e 5.

2. Attiva OAuth 2.0:

   1. Seleziona Autorizzazioni:

      1. Vai all'API Jira.
      2. Fai clic su Aggiungi.
      3. Fai clic su Configura.
      4. Vai alla scheda Ampi spazi classici e fai clic su Modifica ambiti. Seleziona i seguenti ambiti:

         Visualizza ambiti

         • read:avatar:jira
         • read:audit-log:jira
         • read:group:jira
         • read:issue-security-level:jira
         • read:issue-security-scheme:jira
         • read:jira-user
         • read:jira-work
         • read:user:jira

   2. Verifica che siano selezionati otto ambiti, quindi salva le modifiche.

3. Ottieni l'ID client e il client secret:

   1. Fai clic su Distribuzione.

   2. Seleziona Modifica e svolgi i seguenti passaggi:

      1. Seleziona Condivisione per attivare la modifica di altri campi.
      2. Compila i campi rimanenti.
      3. Seleziona Sì quando vedi Does your app store personal data?

   3. Seleziona Impostazioni per copiare l'ID client e il client secret.

4. Ottieni l'URL dell'istanza:

   1. Vai ad atlassian.net e accedi con il tuo account amministratore.
   2. Seleziona l'app che vuoi sincronizzare. Ad esempio, sincronizza la prima app.
   3. Trova l'URL dell'istanza, ovvero il sottodominio nella barra degli indirizzi.

5. Ottieni l'ID istanza:

   1. Apri una nuova scheda, copia l'URL dell'istanza e aggiungi /_edge/tenant_info all'URL dell'istanza. Ad esempio, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info.
   2. Vai al link per trovare il valore cloudId. cloudId è l'ID istanza.

Configurare autorizzazioni e ruoli

1. Accedi ad atlassian.com con il tuo account amministratore.
2. Fai clic sull'icona del menu in alto a sinistra o vai alla pagina admin.atlassian.com.
3. Nella pagina Amministrazione, fai clic su Gestisci utenti e vai alla pagina Gruppi.
4. Fai clic su Crea gruppo. Inserisci un nome per il gruppo e crealo.
5. Fai clic su Aggiungi prodotto.
6. Nella finestra di dialogo Aggiungi prodotti al gruppo, seleziona Amministratore accesso utente come ruolo del prodotto.
7. Fai clic su Aggiungi.
8. Nella pagina Gruppi, fai clic su Aggiungi membri del gruppo per aggiungere gli utenti o gli account autenticati dal connettore.

Affinché le autorizzazioni utente vengano applicate correttamente, ogni utente di Jira Cloud deve rendere visibile il proprio indirizzo email a tutti gli utenti. Per farlo, modifica le impostazioni di visibilità email in Confluence Cloud e imposta la visibilità su Anyone. Per saperne di più, consulta Impostare la visibilità delle email nella documentazione di Atlassian.

Creare un connettore Jira Cloud

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Jira Cloud a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Jira Cloud per collegare l'origine di terze parti.

5. Inserisci i tuoi dati di autenticazione e fai clic su Autentica.

6. Inserisci il nome utente e la password dell'istanza.

7. Verifica che l'autenticazione sia andata a buon fine prima di tornare alla pagina Specifica l'origine Jira per il tuo datastore.

8. Seleziona le entità da sincronizzare, quindi fai clic su Continua.

9. Seleziona una regione per il tuo datastore.

10. Inserisci un nome per il tuo datastore.

11. Seleziona una frequenza di sincronizzazione.

12. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

13. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Connettere Jira Data Center on-premise

Utilizza questa procedura per creare un datastore e un'app di ricerca di Jira Data Center in Agent Builder, sincronizzando i dati di Jira on-premise con Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, puoi scegliere la frequenza con cui il datastore si sincronizza con l'origine.

Prima di iniziare

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

1. Collegamento di servizio (obbligatorio solo per il tipo di destinazione privata): configura un collegamento di servizio per il trasferimento sicuro dei dati.
2. Nome utente e password: ottieni le credenziali valide per l'autenticazione dall'amministratore di Jira.
3. Facoltativo per il tipo di destinazione privata: URL dominio: specifica l'URL dell'istanza di Jira Data Center.
4. (Facoltativo) Nome di dominio di base: specifica il nome di dominio di base per l'istanza di Jira.
5. (Facoltativo) Porta di destinazione: identifica la porta utilizzata per la comunicazione con Jira Data Center.

6. Utilizza le seguenti linee guida di configurazione per stabilire connessioni con Private Service Connect(PSC). Modifica o aggiungi le risorse in base alle esigenze. Assicurati che il collegamento di servizio PSC sia configurato correttamente per connettersi all'istanza privata e soddisfi i requisiti per un servizio pubblicato.

   1. Configura le impostazioni di rete:

      1. Posiziona il collegamento al servizio PSC e il bilanciatore del carico in subnet diverse all'interno della stessa rete Virtual Private Cloud.

      2. Il sistema di backend deve rimanere chiuso alla rete pubblica per motivi di sicurezza. Tuttavia, assicurati che possa accettare il traffico dalle seguenti origini:

         • Per i bilanciatori del carico basati su proxy/HTTP(S) (ILB proxy L4, ILB L7), configura il backend in modo che accetti le richieste dalla subnet del proxy nella rete Virtual Private Cloud.

         • Per ulteriori informazioni, consulta la documentazione sulle subnet solo proxy per i bilanciatori del carico basati su Envoy.

   2. Modifica le regole del firewall:

      1. Regole in entrata:

         • Consenti il traffico dalla subnet del collegamento a un servizio PSC alla subnet del bilanciatore del carico interno (ILB).
         • Assicurati che il bilanciatore del carico possa inviare traffico al backend.
         • Consenti ai probe del controllo di integrità di raggiungere il backend.

      2. Regole in uscita: attivano il traffico in uscita per impostazione predefinita, a meno che non vengano applicate regole di rifiuto specifiche.

7. Considerazioni aggiuntive: assicurati di mantenere tutti i componenti, inclusi l'attacco del servizio PSC e il bilanciatore del carico, nella stessa regione.

Generare un allegato del servizio

Per generare un allegato del servizio:

1. Scegli il tipo di endpoint: seleziona Pubblico o Privato.

2. Per l'endpoint Pubblico: se il Tipo di destinazione di Jira Data Center è Pubblico, non è necessario creare la configurazione per l'attacco del servizio. In alternativa, puoi utilizzare il tuo URL pubblico nel campo URL dominio della console Google Cloud.

3. Per l'endpoint Privato:

   1. Utilizza PSC per abilitare le connessioni dalle istanze private a Google Cloud.
   2. Crea una rete Virtual Private Cloud e le subnet necessarie.
   3. Crea un'istanza di una macchina virtuale (VM) e installa il servizio di backend.
   4. (Facoltativo) Configura un probe di controllo di integrità per monitorare l'integrità del backend.
   5. Aggiungi un bilanciatore del carico per instradare il traffico alla VM o al backend.
   6. Definisci le regole del firewall per consentire il traffico tra l'endpoint PSC e il backend.
   7. Pubblica l'endpoint creando un collegamento del servizio PSC.

Creare un utente di Jira Data Center e configurare le autorizzazioni

Per consentire a Vertex AI Search di ottenere dati da Jira, devi creare un nuovo utente con le autorizzazioni minime necessarie. Per creare l'utente e configurare le autorizzazioni richieste, segui questi passaggi.

1. Accedi come amministratore:

   1. Vai al sito del tuo dominio Atlassian e apri l'istanza di Jira Data Center.
   2. Inserisci il nome utente e la password di amministratore.
   3. Fai clic su Accedi.

2. Crea un nuovo utente:

   Quando crei un data store, devi creare un utente per ottenere i dati dall'istanza di terze parti.

   1. Fai clic sull'icona delle impostazioni.
   2. Seleziona Gestione utenti.
   3. Inserisci le credenziali di amministratore, se richiesto.
   4. Nella pagina Amministrazione, fai clic su Crea utente.
   5. Inserisci l'indirizzo email, il nome completo, il nome utente e la password.
   6. Fai clic su Crea utente.

3. Assegna l'utente a un gruppo:

   1. Nella pagina Amministrazione, fai clic su Gruppi in Gestione utenti.
   2. Crea un gruppo inserendo un nome e facendo clic su Aggiungi gruppo.
   3. Seleziona il gruppo appena creato.
   4. Fai clic su Aggiungi/Rimuovi utenti.
   5. Fai clic sull'icona del membro accanto alla casella Aggiungi membri ai gruppi selezionati.
   6. Seleziona l'utente appena creato e fai clic su Salva selezione.
   7. Fai clic su Aggiungi utente selezionato per visualizzare i nuovi utenti nella sezione dei membri del gruppo.

   Puoi vedere che l'utente aggiunto è stato assegnato nella sezione Membri del gruppo.

4. Configura le autorizzazioni utente:

   1. Nella pagina Amministrazione, vai alla scheda Problemi.
   2. Seleziona Schemi di autorizzazione.
   3. Fai clic su Aggiungi schema di autorizzazione.
   4. Inserisci un nome per lo schema e fai clic su Aggiungi.
   5. Seleziona lo schema e fai clic sull'icona Autorizzazione.
   6. Fai clic su Concedi autorizzazione.
   7. Aggiungi le seguenti autorizzazioni, assegnale al gruppo creato in precedenza e fai clic su Concede:
      1. Sfogliare i progetti.
      2. Sfoglia l'archivio dei progetti.
   8. Aggiungi questo schema ai progetti in cui gli utenti del gruppo devono avere accesso per visualizzare il progetto, i problemi, i commenti, i log di lavoro e gli allegati.

Puoi aggiungere questo schema ai progetti a cui gli utenti del gruppo devono accedere per visualizzare il progetto e i relativi problemi, commenti, log di lavoro e allegati.

Configurare l'accesso alle applicazioni

1. Nella pagina Amministrazione, vai alla scheda Applicazioni.
2. Nella scheda Applicazioni, seleziona Accesso alle applicazioni.
3. Cerca e seleziona il gruppo creato.
4. Verifica che il gruppo sia presente nell'elenco di accesso.

L'utente viene creato con accesso minimo. Questo schema viene aggiunto ai progetti. L'amministratore di Jira può aggiungere altri membri al gruppo o utenti al progetto.

Creare un connettore Jira Data Center on-premise

Console

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Centro dati Jira per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione e fai clic su Continua.

6. Nell'elenco a discesa Tipo di destinazione, seleziona Pubblico o Privato.

   1. Per il tipo di destinazione Pubblico, non è necessario creare la configurazione per l'attacco del servizio. In alternativa, puoi utilizzare il tuo URL pubblico nel campo URL del dominio della console Google Cloud.

   2. Per il tipo di destinazione Privato, inserisci tutte le informazioni richieste:

      1. Se la tua istanza ha un URL di dominio:
         • Collegamento servizio: inserisci il collegamento servizio.
         • (Facoltativo) Nome di dominio di base: inserisci il dominio di base.
         • URL del dominio: inserisci l'URL del dominio.
         • (Facoltativo) Porta di destinazione: inserisci la porta di destinazione.
      2. Se la tua istanza non ha un URL di dominio:
         • Collegamento servizio: inserisci il collegamento servizio.
         • (Facoltativo) Porta di destinazione: inserisci la porta di destinazione.

7. Fai clic su Continua.

8. (Facoltativo) Opzioni avanzate: seleziona e attiva Impostazioni proxy e Impostazioni SSL, se necessario.

9. In Entità da sincronizzare, seleziona tutte le entità richieste da sincronizzare e fai clic su Continua.

10. Seleziona una regione per il connettore dati e inserisci un nome.

11. Seleziona una frequenza di sincronizzazione.

Per il tipo di destinazione Privato, dopo che hai inviato i dettagli del connettore, VAIS invia una richiesta di connessione al tuo PSC. Vai al connettore per visualizzare un messaggio che ti chiede di inserire un projectId nella lista consentita del PSC. Il connettore rimane nello stato Error finché non consenti la connessione in PSC. Quando accetti la richiesta di connessione, il connettore passa allo stato Attivo durante l'esecuzione della sincronizzazione successiva. Se configuri il PSC in modo che accetti tutte le connessioni, il connettore passa automaticamente allo stato Attivo dopo la creazione.

Per il tipo di destinazione Pubblica, il connettore passa automaticamente allo stato Attivo dopo l'invio. Per verificare lo stato del data store e dell'attività di importazione:

1. Vai al connettore nell'elenco dei datastore e monitora il relativo stato finché non diventa Attivo.
2. Dopo che lo stato del connettore diventa Attivo, fai clic sull'entità richiesta e verifica che tutte le entità selezionate siano importate. Lo stato del datastore passa da Creazione a In esecuzione all'inizio della sincronizzazione e diventa Attivo al termine dell'importazione, a indicare che il datastore è configurato. A seconda delle dimensioni dei dati, l'importazione può richiedere diverse ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ricevere risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Connettere Microsoft Outlook

Utilizza la procedura seguente per sincronizzare i dati da Microsoft Outlook a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore di Microsoft Outlook deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   • ID client
   • Client secret
   • ID tenant

Creare un connettore di Microsoft Outlook

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Microsoft Outlook a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Microsoft Outlook per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Microsoft Outlook e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Generare risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collegare Microsoft Teams

Utilizza la procedura seguente per sincronizzare i dati da Microsoft Teams a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere inserito nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore di Microsoft Teams deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   • ID client
   • Client secret
   • ID tenant

Creare un connettore di Microsoft Teams

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Microsoft Teams con Vertex AI Search:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Microsoft Teams per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Microsoft Teams e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca. Se hai utilizzato il controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connect Monday

Utilizza la procedura seguente per sincronizzare i dati da Monday a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione, assicurati di disporre dell'URL del dominio, dell'accesso amministrativo e del token API.

Per generare l'URL dell'account e il token API:

1. Accedi all'applicazione Monday con il tuo account amministratore.
2. Fai clic sull'icona Profilo.
3. Seleziona Amministrazione.
4. Vai alla scheda Generale e inserisci il Nome account e URL account.
5. Torna all'icona Profilo e seleziona Sviluppatori.
6. Nella pagina Monday Developer Center (Centro sviluppatori di Monday), fai clic su I miei token di accesso.
7. Fai clic su Mostra per visualizzare il token.
8. Copia il token da utilizzare per l'autenticazione.

Crea un connettore per il lunedì

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Monday a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

2. Nella pagina Datastore, fai clic su Crea datastore.

3. Nella pagina Seleziona un'origine dati, scorri o cerca Monday per collegare l'origine di terze parti.

4. Inserisci i dati di autenticazione di Monday e fai clic su Continua.

5. Seleziona le entità da sincronizzare e fai clic su Continua.

6. Seleziona una regione per il tuo datastore.

7. Inserisci un nome per il connettore dati.

8. Seleziona una frequenza di sincronizzazione.

9. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

10. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ricevere risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collegare Notion

Utilizza la procedura seguente per sincronizzare i dati da Notion a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Attenzione: questo connettore fornisce un supporto ACL parziale. Durante l'anteprima privata, i domini utente vengono verificati, ma la verifica granulare degli utenti non è supportata.

Prima di iniziare

Prima di configurare il connettore:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Un amministratore di Notion deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   • Token API dell'istanza Notion
   • ID area di lavoro

3. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

Creare un connettore Notion

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Notion a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Notion per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Notion e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca. Se hai utilizzato il controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connetti Okta

Utilizza la procedura seguente per sincronizzare i dati da Okta a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare il connettore, assicurati di disporre dell'URL del dominio e dell'accesso amministrativo all'istanza Okta. Segui questi passaggi per ottenere l'URL dell'istanza Okta, l'ID client e il token API.

1. Per ottenere l'URL dell'istanza Okta:

   1. Accedi alla pagina di accesso di Okta con le tue credenziali di amministratore.
   2. Fai clic sull'icona del tuo profilo o vai direttamente alla Console di amministrazione. L'URL dell'istanza Okta viene visualizzato come sottodominio nella barra degli indirizzi.

2. Per generare l'ID client e il token API:

   1. Accedi all'URL dell'istanza Okta con il tuo account amministratore.
   2. Vai alla dashboard Amministrazione.
   3. Fai clic sull'icona Applicazioni e seleziona Applicazioni.
   4. Fai clic su Crea integrazione app.
   5. Seleziona OIDC - OpenID Connect.
   6. Seleziona Applicazione web come tipo di applicazione e poi fai clic su Avanti.
   7. Inserisci un nome nel campo Nome integrazione app.
   8. Scorri fino a visualizzare Compiti, quindi seleziona Salta assegnazione dei gruppi per ora.
   9. Fai clic su Salva.
   10. Nella finestra Credenziali client, fai clic su Modifica.
   11. Seleziona Chiave pubblica / Chiave privata.
   12. In Chiave pubblica, fai clic su Aggiungi chiave.
   13. Fai clic su Genera nuova chiave, poi su Fine e Salva.
   14. Viene visualizzata una finestra di dialogo; fai clic su Salva.
   15. In Impostazioni generali, fai clic su Modifica.
   16. Seleziona Credenziali client e poi fai clic su Salva.

Crea un connettore Okta

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Okta a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Okta per collegare la tua origine di terze parti.

5. Inserisci i dati di autenticazione di Okta e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collega OneDrive

Utilizza la procedura seguente per sincronizzare i dati da OneDrive a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere inserito nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

2. Prepara le seguenti informazioni di autenticazione di OneDrive:

   1. ID client, client secret e ID tenant. Per informazioni sulla configurazione di questi parametri, consulta Guida rapida: registrare un'applicazione con la piattaforma di identità Microsoft nella documentazione di Microsoft.

   2. Specifica gli ambiti di accesso. È necessario un ruolo di amministratore. Per ulteriori informazioni, consulta la sezione Guida rapida: configura un'applicazione client per accedere a un'API web nella documentazione di Microsoft.

   3. Configura i seguenti ambiti:

      Visualizza gli ambiti

      • Files.Read.All (Application)
      • Group.Read.All (Application)
      • User.Read.All (Application)

Creare un connettore OneDrive

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da OneDrive a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca OneDrive per collegare l'origine di terze parti.

5. Inserisci le informazioni di autenticazione di OneDrive.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il tuo datastore.

9. Seleziona una frequenza di sincronizzazione per il tuo datastore.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app e del datastore, consulta Generare risultati di ricerca. Se hai utilizzato il controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Collega Salesforce

Utilizza la procedura seguente per sincronizzare i dati da Salesforce a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere inserito nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

2. Prepara le seguenti informazioni di autenticazione. Per informazioni sulla configurazione dell'ID client e del client secret in Salesforce, consulta Configurare un'app collegata per il flusso delle credenziali client OAuth 2.0 nella documentazione di Salesforce.

   • URL istanza
   • ID consumatore
   • Consumer secret

Si applicano le seguenti limitazioni:

1. Utilizza un piano Enterprise o Developer. Gli account di prova non sono supportati.
2. Assicurati di utilizzare Sales Cloud. Service Cloud non è supportato.
3. Aggiungi Google Cloud alla lista consentita CORS di Salesforce. Vai al passaggio successivo se hai già completato questa attività.
   1. Segui le istruzioni riportate nella documentazione di Salesforce per configurare la lista consentita CORS.
   2. Inserisci https://console.cloud.google.com/ come URL origine e salva la configurazione.

Creare un connettore Salesforce

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Salesforce a Vertex AI Search , segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Salesforce per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Salesforce.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il tuo datastore.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo mostra nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Lo stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connetti ServiceNow

Utilizza la procedura seguente per sincronizzare i dati da ServiceNow a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione, assicurati di avere quanto segue:

1. Istanzia ServiceNow: crea un'istanza ServiceNow seguendo le istruzioni riportate nella documentazione di ServiceNow Developer.

2. ProgettoGoogle Cloud : configura un progetto Google Cloud con un account amministratore in grado di gestire le configurazioni a livello di organizzazione, assicurandoti che l'organizzazione possa configurare un pool di risorse umane.

3. Pool di forza lavoro: assicurati che la tua organizzazione sia configurata per gestire un pool di forza lavoro.

Configurare ServiceNow

ServiceNow offre due siti principali:

1. Sito ServiceNow principale: il sito della tua istanza ServiceNow.

   • Gestisce utenti, gruppi e attività di amministrazione di sistema.
   • URL: l'URL dell'istanza ServiceNow.
   • Accedi utilizzando le tue credenziali di amministratore.

2. Sito per sviluppatori:

   • Configura la knowledge base, imposta i flussi di lavoro e sviluppa applicazioni personalizzate.
   • URL: https://developer.service-now.com.
   • Accedi utilizzando il tuo ID ServiceNow.

Nota: per la configurazione seguente, utilizza il sito principale di ServiceNow per la configurazione di OAuth e delle autorizzazioni.

Per creare un endpoint OAuth:

1. Accedi all'istanza ServiceNow principale con privilegi amministrativi.
2. Vai a Tutte > OAuth di sistema > Registro delle applicazioni.
3. Fai clic su Nuovo, quindi seleziona Crea un endpoint API OAuth per i client esterni. Recupera l'ID client e il client secret.

4. Inserisci le informazioni richieste:

   1. Nome: nome univoco.
   2. URL di reindirizzamento: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html.

5. Fai clic su Invia per creare la credenziale.

6. Dopo l'invio, fai clic sul nome per visualizzare il segreto cliente.

7. Il secret è mascherato. Fai clic sull'icona a forma di lucchetto accanto per smascherare e visualizzare il segreto.

8. Conserva una copia dell'ID client e del secret da utilizzare quando necessario.

9. Vai a developer.service-now.com e fai clic su Gestisci password istanza.

10. Conserva una copia del nome utente e della password da utilizzare quando necessario.

11. A questo punto, sono disponibili tutte e cinque le informazioni necessarie per configurare un data store ServiceNow. Se non ci sono problemi con l'utilizzo del ruolo Amministratore per estrarre i dati, procedi con la creazione di un data store.

Configura i ruoli e le autorizzazioni

Per creare e gestire gli utenti, devi disporre del ruolo di amministratore della sicurezza. Se non hai questo ruolo, esegui l'elevazione del ruolo a security_admin facendo clic su Eleva ruolo nel tuo profilo. Seleziona il ruolo security_admin e fai clic su Aggiorna. Il ruolo security_admin è necessario per creare ruoli e gestire gli utenti.

1. Crea un ruolo personalizzato con regole ACL:

   1. Vai a Tutti > Amministrazione utenti > Ruoli.
   2. Fai clic su Nuovo per creare un nuovo ruolo.
   3. Seleziona un nome e fai clic su Invia.
   4. Vai a Sicurezza di sistema > Controllo accesso (ACL) per creare una nuova regola ACL.
   5. Fai clic su Nuovo per creare una nuova regola ACL.
   6. Seleziona un ruolo, ad esempio sys_user_role.
   7. Fai clic su Invia e assegna il ruolo.

   8. Ripeti questa procedura finché non viene concesso tutto l'accesso alla tabella. Affinché il connettore funzioni correttamente, è necessario l'accesso alle seguenti tabelle per ogni entità:

      1. Incidente: incident.
      2. Elemento del catalogo: sc_cat_item, sc_cat_item_user_criteria_mtom, sc_cat_item_user_criteria_no_mtom, sc_cat_item_user_mtom, sc_cat_item_user_no_mtom.
      3. Conoscenza: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom.
      4. Allegato: tutti gli elementi elencati.
      5. Identità: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember, sys_user.
      6. Aggiornato man mano che vengono estratti nuovi criteri: core_company, cmn_location, cmn_department.
      7. Criteri utente: user_criteria.

   9. Verifica che tutte le ACL siano aggiornate andando a sys_security_acl_role_list.do nella barra di ricerca.

   10. Seleziona il ruolo da verificare.

   11. Verifica che tutte le ACL richieste siano assegnate al ruolo selezionato.

2. Concedi il ruolo a un account di servizio:

   1. Vai a Tutti > Amministrazione utenti > Utenti e seleziona l'utente.
   2. Individua l'utente a cui concedere il ruolo e selezionalo.

3. Se non è disponibile nessun utente, vai a Sicurezza di sistema > Utenti e gruppi > Utenti.

4. Fai clic su Nuovo per creare un nuovo account di servizio nella tabella Utente.

5. Assicurati di selezionare la casella di controllo Solo accesso ai servizi web.

6. Vai alla tabella Ruoli in fondo alla pagina.

7. Fai clic su Modifica a destra.

8. Concedi il ruolo creato in precedenza e assegnalo all'utente. A seconda del tipo di ruolo creato, seleziona quello appropriato e assegnalo.

9. Ottieni il nome utente e la password dell'utente. Nella stessa pagina, fai clic su Imposta password.

10. Genera automaticamente una password e salvala per utilizzarla in un secondo momento:

    1. ID utente: manager.
    2. Password: inserisci la password generata automaticamente.

Configura il pool di forza lavoro

Segui le istruzioni per configurare un pool di personale con una delle seguenti configurazioni:

1. Configurazione di OIDC di Azure
2. Configurazione di Azure SAML
3. Configurazione di Okta e OIDC
4. Configurazione di Okta e SAML

Creare un connettore ServiceNow

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da ServiceNow a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca ServiceNow per collegare l'origine di terze parti.

5. Inserisci le informazioni di autenticazione di ServiceNow.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il connettore dati.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore dati per visualizzarne i dettagli nella pagina Dati. Lo stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Collega il data center SharePoint on-premise

Utilizza questa procedura per creare un datastore e un'app di ricerca di SharePoint Data Center in Agent Builder, sincronizzando i dati di SharePoint on-premise con Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, puoi scegliere la frequenza con cui il datastore si sincronizza con l'origine.

Prima di iniziare

Prima di configurare la connessione, segui questi passaggi:

1. Collegamento di servizio (obbligatorio solo per il tipo di destinazione privata): segui i passaggi riportati di seguito per generare un collegamento di servizio per il trasferimento sicuro dei dati.

   1. Scegli il tipo di endpoint: seleziona Pubblico o Privato.

   2. Per l'endpoint Pubblico: se il Tipo di destinazione del centro dati SharePoint è Pubblico, non è necessario creare la configurazione per il collegamento del servizio. In alternativa, puoi utilizzare il tuo URL pubblico nel campo URL dominio della console Google Cloud durante la creazione del connettore.

   3. Per l'endpoint Privato:

      1. Utilizza Private Service Connect (PSC) per abilitare le connessioni dalle istanze private a Google Cloud
      2. Crea una rete Virtual Private Cloud e le subnet necessarie.
      3. Crea un'istanza di una macchina virtuale (VM) e installa il servizio di backend.
      4. (Facoltativo) Configura un probe di controllo di integrità per monitorare l'integrità del backend.
      5. Aggiungi un bilanciatore del carico per instradare il traffico alla VM o al backend.
      6. Definisci le regole del firewall per consentire il traffico tra l'endpoint PSC e il backend
      7. Pubblica l'endpoint creando un collegamento del servizio PSC.

2. Nome utente e password: ottieni credenziali valide per l'autenticazione dall'amministratore di SharePoint.

3. (Facoltativo per il tipo di destinazione privata) URL dominio: mantieni l'URL del dominio dell'istanza di SharePoint Data Center se l'istanza si trova dietro un proxy o una connessione basata su SSL.

4. (Facoltativo) Nome di dominio di base: specifica il nome di dominio di base per l'istanza di SharePoint.

5. (Facoltativo) Porta di destinazione: identifica la porta utilizzata per la comunicazione con il data center di SharePoint.

6. Utilizza le seguenti linee guida di configurazione per stabilire connessioni con Private Service Connect(PSC). Modifica o aggiungi le risorse in base alle esigenze. Assicurati che il collegamento di servizio PSC sia configurato correttamente per connettersi all'istanza privata e soddisfi i requisiti per un servizio pubblicato.

   1. Configura le impostazioni di rete:

      1. Posiziona il collegamento al servizio PSC e il bilanciatore del carico in subnet diverse all'interno della stessa rete Virtual Private Cloud.

      2. Il sistema di backend deve rimanere chiuso alla rete pubblica per motivi di sicurezza. Tuttavia, assicurati che possa accettare il traffico dalle seguenti origini:

         • Per i bilanciatori del carico basati su proxy/HTTP(S) (ILB proxy L4, ILB L7), configura il backend in modo che accetti le richieste dalla subnet proxy nella rete Virtual Private Cloud.

         • Per ulteriori informazioni, consulta la documentazione sulle subnet solo proxy per i bilanciatori del carico basati su Envoy.

   2. Modifica le regole del firewall:

      1. Regole in entrata:

         • Consenti il traffico dalla subnet del collegamento a un servizio PSC alla subnet del bilanciatore del carico interno (ILB).
         • Assicurati che il bilanciatore del carico possa inviare traffico al backend.
         • Consenti ai probe del controllo di integrità di raggiungere il backend.

      2. Regole in uscita: attivano il traffico in uscita per impostazione predefinita, a meno che non vengano applicate regole di rifiuto specifiche.

7. Considerazioni aggiuntive: assicurati di mantenere tutti i componenti, inclusi il collegamento del servizio PSC e il bilanciatore del carico, nella stessa regione.

Creare un utente di SharePoint Data Center

Per creare un utente di SharePoint Data Center, ottieni un nome utente e una password da un amministratore. L'amministratore deve seguire questi passaggi per creare un nuovo utente nell'istanza di SharePoint Data Center.

1. Fai clic su Menu Start.
2. Vai a Strumenti di amministrazione di Windows > Utenti e computer di Active Directory.
3. Avvia l'applicazione Utenti e computer di Active Directory.
4. Espandi l'unità organizzativa e vai al contenitore Utenti per aggiungere il nuovo utente.
5. Fai clic con il tasto destro del mouse su Utenti e seleziona Nuovo > Utente.
6. Nella finestra di dialogo Nuovo oggetto: utente:
   1. Inserisci Nome, Nome e cognome e Nome accesso utente.
   2. Fai clic su Avanti.
7. Nella finestra di dialogo Nuovo oggetto: utente:
   1. Inserisci le informazioni richieste:
      1. Password
      2. Conferma password
   2. Seleziona le seguenti opzioni:
      1. L'utente non può modificare la password
      2. La password non scade mai
   3. Fai clic su Avanti.
8. Fai clic su Fine.
9. Individua l'utente creato nella sezione Utenti, fai doppio clic su di lui e seleziona Proprietà.
10. Nella finestra di dialogo Proprietà:
    1. Aggiungi un indirizzo email per l'utente.
    2. Fai clic su Applica.

Configura la raccolta siti in SharePoint

1. Accedi alla console di amministrazione di SharePoint.
2. Nella pagina Amministrazione centrale, vai a Gestione applicazioni.
3. Fai clic su Crea raccolte di siti.
4. Nella pagina Crea raccolta siti, inserisci le informazioni richieste nei campi Titolo e Descrizione.
5. Nella sezione Indirizzo dei siti web, inserisci il nome dell'URL del sito.
6. Nella sezione Amministratore della raccolta siti principale, fai clic sull'opzione Sfoglia accanto al campo Nome utente.
7. Nella finestra di dialogo Seleziona persone, inserisci il nome utente dell'amministratore e fai clic sull'icona Cerca.
8. Seleziona l'utente e fai clic su Ok. Viene visualizzata la pagina Sito creato e viene visualizzato l'URL del sito.
9. Copia l'URL e aprilo in una nuova scheda. Viene visualizzato il sito.

Accedi con l'utente creato

1. Utilizza le credenziali dell'utente creato per accedere al sito SharePoint.
2. Verifica l'accesso e le autorizzazioni dell'utente.

Creare un connettore SharePoint Data Center on-premise

Console

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Centro dati SharePoint per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione e fai clic su Continua.

6. Nell'elenco a discesa Tipo di destinazione, seleziona Pubblico o Privato.

   1. Per il tipo di destinazione Pubblico, non è necessario creare la configurazione per l'attacco al servizio. In alternativa, puoi utilizzare il tuo URL pubblico nel campo URL dominio della console Google Cloud.

   2. Per il tipo di destinazione Privato, inserisci tutte le informazioni richieste:

      1. Se la tua istanza ha un URL di dominio:
         • Collegamento servizio: inserisci il collegamento servizio.
         • (Facoltativo) Nome di dominio di base: inserisci il dominio di base.
         • URL del dominio: inserisci l'URL del dominio.
         • (Facoltativo) Porta di destinazione: inserisci la porta di destinazione.
      2. Se la tua istanza non ha un URL di dominio:
         • Collegamento servizio: inserisci il collegamento servizio.
         • (Facoltativo) Porta di destinazione: inserisci la porta di destinazione.

7. Fai clic su Continua.

8. (Facoltativo) Opzioni avanzate: seleziona e attiva Impostazioni proxy e Impostazioni SSL, se necessario.

9. In Entità da sincronizzare, seleziona tutte le entità richieste da sincronizzare e fai clic su Continua.

10. Seleziona una regione per il connettore dati e inserisci un nome.

11. Seleziona una frequenza di sincronizzazione.

Per gestire gli stati dei connettori:

1. Per il tipo di destinazione privata:

   1. Invia i dettagli del connettore.
   2. VAIS invia una richiesta di collegamento al tuo PSC.
   3. Vai al connettore per visualizzare un messaggio che ti chiede di inserire un projectId nella lista consentita del PSC.
   4. Consenti la connessione in PSC:
      1. Il connettore rimane nello stato Error finché non approvi la richiesta.
      2. Dopo l'approvazione, il connettore passa allo stato Attivo durante l'esecuzione della sincronizzazione successiva.
   5. Se il tuo PSC è configurato per accettare tutte le connessioni, il connettore passa automaticamente allo stato Attivo dopo la creazione.

2. Per il tipo di destinazione pubblica:

   1. Invia i dettagli del connettore.
   2. Il connettore passa automaticamente allo stato Attivo dopo l'invio.

Per verificare lo stato del data store e dell'attività di importazione:

1. Vai al connettore nell'elenco dei datastore e monitora il relativo stato fino a quando non diventa Attivo.
2. Dopo che lo stato del connettore diventa Attivo, fai clic sull'entità richiesta e verifica che tutte le entità selezionate siano importate. Lo stato del datastore passa da Creazione a In esecuzione all'inizio della sincronizzazione e diventa Attivo al termine dell'importazione, a indicare che il datastore è configurato. A seconda delle dimensioni dei dati, l'importazione può richiedere diverse ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.
• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Collegare SharePoint Online

Utilizza la procedura seguente per sincronizzare i dati da SharePoint Online a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

2. Concedi il consenso dell'amministratore. Per informazioni su come concedere il consenso, consulta Concedere il consenso amministrativo a livello di tenant a un'applicazione nella documentazione di Microsoft Entra.

3. Prepara le seguenti informazioni di autenticazione di SharePoint Online da utilizzare durante la configurazione:

   1. URL istanza. Nel modulo http://DOMAIN_OR_SERVER/[sites/]WEBSITE.

   2. L'autenticazione federata richiede l'ID tenant e l'ID client, mentre OAuth richiede l'ID tenant, l'ID client e il client secret. Per registrare l'applicazione, seleziona Solo account in questa directory dell'organizzazione per il pubblico di accesso, quindi individua queste informazioni di autenticazione. Per ulteriori informazioni, consulta la sezione Guida rapida: registrare un'applicazione con la piattaforma di identità di Microsoft nella documentazione di Microsoft Entra.

   3. Quando registri l'applicazione, utilizza https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html come URL di callback web.

   4. Quando configuri le autorizzazioni di applicazione, aggiungi le seguenti autorizzazioni di applicazione per l'API Graph:

      Visualizza gli ambiti

      • GroupMember.Read.All
      • Sites.FullControl.All
      • User.Read.All

   5. Quando configuri le autorizzazioni dell'applicazione, aggiungi le seguenti autorizzazioni delegate per l'API REST di SharePoint:

      Visualizza gli ambiti

      • AllSites.FullControl

4. La tabella seguente descrive i ruoli consigliati per la configurazione e le relative limitazioni.

Visualizza ruoli

Ruoli	Registrazione dell'applicazione client	Recupera i contenuti di tutte le entità	ACL di recupero	Recupera l'identità	Note
Amministratori del sito	No	Sì	Sì	Sì
Amministratore della raccolta siti	No	Sì	Sì	Sì
Amministratore globale	Sì	No	Sì	No	Limitazione: l'amministratore globale non può recuperare le entità di identità o commenti e allegati.
Proprietario del sito	No	Sì	Sì	No	Limitazione: il proprietario del sito si riferisce al Centro amministrazione di Microsoft 365 / Centro amministrazione di Entra, non specifico per SharePoint.
Amministratore dell'applicazione	Sì	N/D	N/A	N/D	Il ruolo di amministratore dell'applicazione è correlato all'interfaccia di amministrazione di Microsoft 365 / Entrà. Non è specifico di SharePoint.

Utilizza questo metodo per un controllo granulare delle autorizzazioni dell'API REST di SharePoint, che ti consente di limitare l'accesso alle risorse nell'account utente. Assicurati di creare un nuovo utente di SharePoint, il che potrebbe comportare costi aggiuntivi per le licenze. Utilizza il metodo del token di aggiornamento OAuth 2.0 per configurare la registrazione di un'applicazione Entra e abilitare l'accesso sicuro a SharePoint.

Configura la registrazione dell'applicazione Entra

Configura una registrazione dell'applicazione Entra per consentire l'accesso sicuro a SharePoint. Scegli tra Credenziali federate per l'accesso basato su token o Token di aggiornamento OAuth 2.0 per il controllo granulare. Per configurare la registrazione dell'app, concedere le autorizzazioni e stabilire l'autenticazione, segui questi passaggi.

1. Credenziali federate: configura le credenziali federate per consentire a Google di accedere in modo sicuro a SharePoint utilizzando token firmati con crittografia, evitando la necessità di un principale utente reale. Per configurare le autorizzazioni e concedere l'accesso:

   1. Ottieni l'ID client dell'account di servizio:

      1. Nella console Google Cloud, vai alla pagina Agent Builder.
      2. Nel menu di navigazione, fai clic su Datastore.
      3. Fai clic su Crea datastore.
      4. Nella pagina Seleziona un'origine dati, scorri o cerca SharePoint Online per collegare l'origine di terze parti.
      5. Prendi nota dell'identificatore dell'oggetto.

   2. Registra l'app in Microsoft Entra:

      1. Vai ad Accedi al Centro amministrazione.

      2. Crea una registrazione dell'app:

         • Tipi di account supportati: Solo account nella directory dell'organizzazione.
         • Mantieni le altre impostazioni predefinite e fai clic su Registrati.

      3. Prendi nota dell'ID cliente e dell'ID tenant.

   3. Aggiungi le credenziali federate:

      1. Vai a Certificati e segreti > Credenziali federate > Aggiungi credenziale.

      2. Utilizza le seguenti impostazioni:

         • Emittente: https://accounts.google.com
         • Identificatore soggetto: utilizza l'identificatore soggetto indicato.
         • Nome: fornisci un nome univoco.

      3. Fai clic su Aggiungi per concedere l'accesso.

   4. Imposta le autorizzazioni API:

      1. Aggiungi e concedi il consenso dell'amministratore per le seguenti autorizzazioni:

         • GroupMember.Read.All (applicazione): leggi tutte le iscrizioni ai gruppi.
         • Sites.Read.All (applicazione): leggi tutti i siti.
         • User.Read.All (applicazione): può leggere i profili completi di tutti gli utenti.
         • Sites.FullControl.All (applicazione): controllo completo su tutti i siti.

      2. Utilizza Sites.Selected per assegnare autorizzazioni specifiche per i siti anziché Sites.FullControl.All. Sites.Selected non può essere configurato direttamente tramite l'interfaccia utente. Dopo aver selezionato Sites.Selected, devi chiamare l'API Microsoft Graph per concedere esplicitamente il ruolo fullcontrol all'applicazione per i siti che vuoi eseguire la scansione.

      3. Concedi Sites.Read.All per la scansione di tutti i siti secondari sotto un URL del sito principale.

2. Token di aggiornamento OAuth 2.0: configura l'autenticazione OAuth 2.0 utilizzando un client secret e un token di aggiornamento dell'utente di SharePoint per attivare il controllo granulare sull'accesso all'API SharePoint. Per configurare la registrazione dell'app, aggiungere un segreto client e assegnare le autorizzazioni API, svolgi i seguenti passaggi:

   1. Crea la registrazione dell'app:

      1. Vai ad Accedi al Centro amministrazione.

      2. Crea una registrazione dell'app:

         • Tipi di account supportati: Solo account nella directory dell'organizzazione.
         • URI di reindirizzamento: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

      3. Prendi nota dell'ID cliente e dell'ID tenant.

   2. Aggiungi il client secret:

      1. Vai a Certificati e secret > Nuovo segreto client.

      2. Prendi nota della stringa del secret.

   3. Imposta le autorizzazioni API:

      1. Aggiungi e concedi il consenso dell'amministratore per le seguenti autorizzazioni:

         • GroupMember.Read.All: Leggi tutte le iscrizioni ai gruppi.
         • Sites.FullControl.All: controllo completo di tutte le raccolte di siti.
         • User.Read.All: leggi i profili completi di tutti gli utenti.
         • AllSites.FullControl: controllo completo su tutti i siti.

      2. Utilizza un account utente dedicato con accesso limitato a siti specifici.

      3. Assicurati che l'account disponga dell'accesso come Proprietario ai siti selezionati.

Creare un connettore SharePoint Online

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Sharepoint Online a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca SharePoint Online per collegare l'origine di terze parti.

5. Inserisci le informazioni di autenticazione di SharePoint Online e fai clic su Autentica.

6. Inserisci l'URL del sito SharePoint:

   • Per un singolo sito: https://<domain_name>.sharepoint.com/sites/<site_name>.
   • Per tutti i siti di primo livello: https://<domain_name>.sharepoint.com.

7. Seleziona le entità da sincronizzare e fai clic su Continua.

8. Seleziona una regione per il tuo datastore.

9. Inserisci un nome per il tuo datastore.

10. Seleziona una frequenza di sincronizzazione per il tuo datastore.

11. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

12. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Testa il motore di ricerca

Dopo aver configurato il motore di ricerca, testa le sue funzionalità. In questo modo, restituisce risultati accurati in base all'accesso utente.

1. Attiva l'app web:

   1. Vai alle configurazioni di integrazione dell'app e attiva l'opzione Attiva l'app web.

2. Testa l'app web:

   1. Fai clic su Apri accanto al link dell'app web e accedi con un utente del tuo pool di risorse umane.

   2. Verifica che i risultati di ricerca siano limitati agli elementi accessibili dall'utente che ha eseguito l'accesso.

Nota: se riscontri problemi di accesso con un ID Microsoft, verifica che l'utente sia aggiunto agli utenti dell'applicazione Enterprise su Microsoft Entra.

Configura il pool di forza lavoro

Il pool di forza lavoro ti consente di gestire e autenticare gli utenti di provider di identità esterni, come Azure o Okta, all'interno della console Google Cloud. Per configurare il pool di personale e attivare l'app web per l'accesso degli utenti senza problemi:

1. Crea il pool di forza lavoro a livello di organizzazione in Google Cloud seguendo il manuale di configurazione appropriato:

   1. Configurazione di OIDC di Azure
   2. Configurazione di Azure SAML
   3. Configurazione di Okta e OIDC
   4. Configurazione di Okta e SAML

2. Configura il pool di risorse in Agent Builder > Impostazioni per la regione in cui crei l'app.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Connetti Slack

Utilizza la procedura seguente per sincronizzare i dati da Slack con Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

2. Contatta il proprietario dello spazio di lavoro per fornire le autorizzazioni per installare nuove app nel tuo spazio di lavoro.

3. Prepara le seguenti informazioni di autenticazione di Slack:

   1. ID area di lavoro: per ottenere l'ID area di lavoro, segui le istruzioni riportate in Specifica l'origine Slack per il tuo datastore nella documentazione di Slack.

   2. Token di accesso: crea un'app client e definisci gli ambiti richiesti. Per ulteriori informazioni, consulta la guida rapida e l'articolo Come ottenere e utilizzare rapidamente un token API Slack nella documentazione di Slack.

   3. Quando imposti gli ambiti di autorizzazione OAuth 2.0, configura i seguenti ambiti:

      Visualizza gli ambiti

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

4. Per impostazione predefinita, Slack limita la scansione e la sincronizzazione dei contenuti di canali privati, messaggi di gruppo e messaggi diretti.

Configurare l'app Slack

Ottieni un token di accesso per consentire a Vertex AI Search di importare documenti dalla tua area di lavoro Slack.

Nota: crea un'app Slack e scegli tra bot (genera un token bot) o token utente (genera un token utente) in base alle tue esigenze.

1. Genera un token di bot per accedere in modo sicuro a canali privati, messaggi istantanei (MI) e messaggi istantanei multipartito (MPI). Il token del bot non può eseguire la scansione dei canali pubblici di cui non fa parte e l'iscrizione ai canali pubblici genera un messaggio di adesione.

   1. Accedi ad App API Slack.
   2. Fai clic su Crea nuova app.
   3. Seleziona Da zero.
   4. Inserisci un nome per l'app e seleziona lo spazio di lavoro per l'integrazione.
   5. Fai clic su Crea app.
   6. Fai clic su OAuth e autorizzazioni.
   7. In Ambiti token bot, aggiungi i seguenti ambiti obbligatori:

      Visualizza gli ambiti

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

   Per impostazione predefinita, il bot legge dai canali #general e #random.

   1. Per attivare la scansione:

      1. Per i canali pubblici, concedi l'ambito channels:join per consentire al bot di partecipare automaticamente.
      2. Per i canali privati, invita il bot manualmente.

   2. Fai clic su Installa nello spazio di lavoro del tuo nome utente.

   3. Segui le istruzioni sullo schermo per installare l'app e recuperare il token del bot.

2. Genera un token utente per accedere a tutti i canali pubblici senza dover prima partecipare. Il token utente non può eseguire la scansione di canali privati, messaggi istantanei o MPIM, a meno che l'utente non abbia accesso.

   1. Accedi ad App API Slack.
   2. Fai clic su Crea nuova app.
   3. Seleziona Da zero.
   4. Inserisci un nome per l'app e seleziona lo spazio di lavoro per l'integrazione.
   5. Fai clic su Crea app.
   6. Fai clic su OAuth e autorizzazioni.

   7. In Scopi dei token utente, aggiungi i seguenti scopi obbligatori:

      Visualizza gli ambiti

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • users:read
      • files:read

   8. Fai clic su Installa nello spazio di lavoro del tuo nome utente.

   9. Segui le istruzioni sullo schermo per installare l'app e recuperare il token utente.

Creare un connettore Slack Cloud

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Slack con Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Slack per collegare l'origine di terze parti.

5. Inserisci le informazioni di autenticazione di Slack.

   • ID istanza (ID spazio di lavoro): ottienilo dallo spazio di lavoro Slack accedendo tramite un browser. L'ID spazio di lavoro è il segmento dopo /client nell'URL.
   • Token di autenticazione: utilizza il token ottenuto dalla sezione precedente.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il tuo datastore.

9. Seleziona una frequenza di sincronizzazione per il tuo datastore.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere minuti o ore.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app di ricerca.

• Consulta Visualizzare l'anteprima dei risultati per le app con controllo dell'accesso di terze parti.

Collegare Trello

Utilizza la procedura seguente per sincronizzare i dati da Trello a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Attenzione: questo connettore fornisce un supporto ACL parziale. Durante l'anteprima privata, i domini utente vengono verificati, ma la verifica granulare degli utenti non è supportata.

Attenzione: questo connettore fornisce il supporto parziale delle ACL. Durante l'anteprima privata, i domini utente vengono verificati, ma la verifica granulare degli utenti non è supportata.

Prima di iniziare

Prima di configurare il connettore, assicurati di aver completato i seguenti passaggi:

1. Verifica di disporre dell'accesso amministrativo a Trello. Un amministratore di Trello deve generare una chiave e un token API nella sezione seguente.
2. Verifica che il tuo progetto sia aggiunto alla lista consentita per utilizzare Trello.
3. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

Un amministratore di Trello deve eseguire i seguenti passaggi:

1. Genera una chiave API in Trello:

   1. Accedi all'istanza di Trello utilizzando le credenziali dell'utente di test fornite su Trello.

   2. Nella pagina Amministrazione dei Power-up di Trello, vai ad Accedi all'amministrazione dei Power-up.

   3. Fai clic su Nuovo per creare un nuovo Power-up.

   4. Compila i dettagli richiesti:

      Nota: l'URL del connettore iframe è necessario solo se vuoi creare un Power-up. In caso contrario, lascia vuoto questo campo.

   5. Fai clic su Avanti per continuare, quindi genera una chiave API. Copia la chiave API e il secret.

2. Genera un token API in Trello:

   1. Fai clic sul link Genera token a destra per generare un token API.

      1. Fai clic su Consenti per concedere l'accesso al token API.
      2. Assicurati che tutte le entità richieste dispongano delle autorizzazioni corrette nell'ambito.

   2. Copia il token API generato. Utilizza questo token per il connettore Trello in Vertex AI Search.

Per ulteriori informazioni sull'API Trello, consulta la Introduzione all'API.

Creare un connettore Trello

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Trello a Vertex AI Search:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Trello per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Trello e fai clic su Continua.

6. (Facoltativo) Per instradare il traffico HTTP, fai clic su Aggiungi destinazione e inserisci il nome host o l'indirizzo IP del server proxy. Fai clic su Continua.

7. Seleziona le entità da sincronizzare e fai clic su Continua.

8. Seleziona una regione per il tuo datastore.

9. Inserisci un nome per il connettore dati.

10. Seleziona una frequenza di sincronizzazione.

11. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

12. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ricevere risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collegare WordPress

Utilizza la procedura seguente per sincronizzare i dati da WordPress a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Attenzione: il controllo dell'accesso per WordPress non è supportato.

Prima di iniziare

Prima di configurare la connessione, assicurati di avere quanto segue:

• Nome utente e password: ottieni le credenziali dall'amministratore di WordPress.
• URL del sito: utilizza questo URL per la creazione del datastore.

Creare un utente WordPress

Per creare un utente WordPress, ottieni un nome utente e una password da un amministratore. L'amministratore deve accedere e seguire questi passaggi per creare un nuovo utente nell'istanza WordPress.

1. Accedi come amministratore:

   1. Vai alla tua piattaforma di hosting e accedi con le tue credenziali di amministratore per accedere al tuo sito web WordPress.
   2. Fai clic sull'icona Sito web.
   3. Fai clic su Amministrazione WordPress per il tuo sito.

2. Crea un nuovo utente:

   1. Nella pagina Amministrazione di WordPress, vai alla scheda Utenti.
   2. Fai clic su Aggiungi nuovo.
   3. Compila tutti i dettagli richiesti, tra cui:
      • Nome utente
      • Indirizzo email
      • (Facoltativo) Nome e cognome
      • Ruolo
      • Password (se richiesta)
   4. Fai clic su Aggiungi nuovo utente per salvare le modifiche.

Crea un connettore WordPress

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da WordPress a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca WordPress per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di WordPress e fai clic su Continua.

6. Nel campo URL, inserisci l'URL del tuo sito WordPress e fai clic su Continua.

7. Seleziona le entità da sincronizzare e fai clic su Continua.

8. Seleziona una regione per il tuo datastore.

9. Inserisci un nome per il connettore dati.

10. Seleziona una frequenza di sincronizzazione.

11. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

12. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ricevere risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collegare Workday

Utilizza la procedura seguente per sincronizzare i dati da Workday a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Attenzione: il controllo dell'accesso per Workday non è supportato.

Prima di iniziare

Prima di creare un connettore Workday:

1. Un amministratore di Workday deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   1. ID cliente. Ottieni il token dalla pagina Visualizza client API in Workday.
   2. Client secret. Ottieni il token dalla pagina Visualizza client API in Workday.
   3. Token di aggiornamento. Ottieni il token dalla pagina Visualizza client API in Workday.
   4. (Facoltativo) Server proxy. Il nome host o l'indirizzo IP di un proxy attraverso il quale instradare il traffico HTTP.
   5. (Facoltativo) URL di base. L'URL di base per la connessione a Workday.
   6. (Facoltativo) URL API. L'URL completo dell'endpoint API da utilizzare per effettuare richieste SOAP. Ad esempio: https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>
   7. Tenant Workday. Il tenant per l'account. Ad esempio, abc_cms1. Puoi ottenere il nome del tenant nei dettagli di configurazione dell'istanza Workday.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

Creare un connettore Workday

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Workday a Vertex AI Search:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Workday per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Workday e fai clic su Continua.

6. (Facoltativo) Inserisci i dati di destinazione di Workday e fai clic su Continua.

7. Inserisci il tuo tenant Workday e fai clic su Continua.

8. Seleziona le entità da sincronizzare e fai clic su Continua.

9. Seleziona una regione per il tuo datastore.

10. Inserisci un nome per il connettore dati.

11. Seleziona una frequenza di sincronizzazione.

12. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

13. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Generare risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.

Collegare Zendesk

Utilizza la procedura seguente per sincronizzare i dati da Zendesk a Vertex AI Search.

Anteprima: per utilizzare i connettori di terze parti, devi essere presente nella lista consentita.

Dopo aver configurato l'origine dati e importato i dati per la prima volta, il datastore sincronizza i dati da questa origine con una frequenza selezionata durante la configurazione.

Prima di iniziare

Prima di configurare la connessione:

1. Oltre alla lista consentita dei connettori di terze parti, questo connettore richiede che il progetto venga aggiunto a un'altra lista consentita. Per farti aggiungere a questa lista consentita, contatta il team dell'account Vertex AI Search.

2. Configura il controllo degli accessi per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

3. Un amministratore Zendesk deve generare o ottenere quanto segue per l'integrazione con Vertex AI Search:

   1. Token di accesso. Token API della tua istanza Zendesk.
   2. URI istanza.

Creare un connettore Zendesk

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Zendesk a Vertex AI Search, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Agent Builder.

   Agent Builder

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

3. Fai clic su Crea datastore.

4. Nella pagina Seleziona un'origine dati, scorri o cerca Zendesk per collegare l'origine di terze parti.

5. Inserisci i dati di autenticazione di Zendesk e fai clic su Continua.

6. Seleziona le entità da sincronizzare e fai clic su Continua.

7. Seleziona una regione per il tuo datastore.

8. Inserisci un nome per il connettore dati.

9. Seleziona una frequenza di sincronizzazione.

10. Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.

11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del connettore per visualizzarne i dettagli nella pagina Dati. Il stato del connettore passa da Creazione a In esecuzione quando inizia la sincronizzazione dei dati. Al termine dell'importazione, lo stato diventa Attivo per indicare che la connessione all'origine dati è configurata e in attesa della successiva sincronizzazione pianificata.

    A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

Passaggi successivi

• Per collegare il connettore a un'app, crea un'app e seleziona il connettore seguendo i passaggi descritti in Creare un'app di ricerca.

• Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ricevere risultati di ricerca. Se hai utilizzato il controllo accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.