Collegare un'origine dati di terze parti

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

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:

Connettere Confluence Cloud

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

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 configurare la connessione:

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

  • Prepara le seguenti informazioni di autenticazione:

    • URL istanza. Nel modulohttps://EXAMPLE.atlassian.net, ad esempiohttps://google.atlassian.net.

    • ID istanza. Si tratta di cloudid e puoi trovarlo andando su https://EXAMPLE.atlassian.net/_edge/tenant_info e copiando il valore di cloudId.

  • Attiva OAuth 2.0 e ottieni l'ID client e il client secret.

    Utilizza https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html come URL di callback. Per informazioni su come attivare OAuth 2.0 per Confluence Cloud e ottenere l'ID client e il client secret, consulta la sezione App OAuth 2.0 (3LO) nella documentazione per gli sviluppatori di Atlassian.

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

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

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Confluence 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 Nuovo datastore.

  4. Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Confluence.

  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, quindi 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

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.

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:

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

Linee guida per la configurazione di Private Service Connect

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.

  • Configurazione di rete:

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

    b. 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.

  • Regole firewall:

    a. Regole in entrata:

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

    b. Regole in uscita:

    • Attiva il traffico in uscita per impostazione predefinita, a meno che non vengano applicate regole di rifiuto specifiche.

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:

    a. Utilizza Private Service Connect (PSC) per abilitare le connessioni dalle istanze private a Google Cloud.

    b. Crea una rete Virtual Private Cloud e le subnet necessarie.

    c. Crea un'istanza di una macchina virtuale (VM) e installa il servizio di backend.

    d. (Facoltativo) Configura un probe di controllo di integrità per monitorare l'integrità del backend.

    e. Aggiungi un bilanciatore del carico per instradare il traffico alla VM o al backend.

    f. Definisci le regole del firewall per consentire il traffico tra l'endpoint PSC e il backend.

    g. 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.

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.
Crea un nuovo utente

Quando crei un datastore, 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.
Assegnare un 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.

Configurare 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

Configura un connettore Confluence Data Center on-premise per sincronizzare i dati con Google Cloud. Innanzitutto, crea un datastore in Agent Builder e configura le impostazioni di connessione, incluse le preferenze di autenticazione e sincronizzazione.

#### Crea un connettore Confluence Data Center on-premise

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Confluence 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 Nuovo datastore.

  4. Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Confluence.

  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, quindi 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

Connetti Jira Cloud

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

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 controllo dell'accesso. Assicurati che controllo dell'accesso sia configurato correttamente per l'origine dati. Questo passaggio garantisce che solo gli utenti autorizzati possano accedere e gestire i dati. Per ulteriori informazioni, consulta la documentazione su come 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 per la tua istanza Jira. Crea un ID client e un segreto client tramite la Developer Console di Atlassian, configura gli ambiti OAuth 2.0 richiesti e imposta le autorizzazioni per gli utenti. Infine, recupera l'URL e l'ID 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

  1. Accedi a developer.atlassian.com.
  2. Fai clic sull'icona del profilo nell'angolo in alto a destra e seleziona Console per sviluppatori.
  3. Fai clic su Crea e seleziona Integrazione OAuth 2.0.
  4. Inserisci un nome per l'app.
    • Seleziona la casella di controllo Termini e condizioni.
    • Fai clic su Crea.

  5. Troverai cinque opzioni: Panoramica, Distribuzione, Autorizzazioni, Autorizzazione e Impostazioni. Inizia con Autorizzazione:

    a. Fai clic su Autorizzazione.

    b. Nella tabella Tipo di autorizzazione, seleziona Aggiungi per OAuth 2.0 (3LO).

  6. Nel campo URL di callback, inserisci https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html e poi fai clic su Salva modifiche.

    NOTA: se viene visualizzato l'avviso La tua app non ha API. Aggiungi le API alla tua app., verrà affrontato nella sezione successiva.

  7. Seleziona Autorizzazioni:

    a. Vai ad API Jira, fai clic su Aggiungi e poi su Configura.

    NOTA: quando fai clic su Aggiungi, il pulsante diventa Configura.

    b. Vai alla scheda Ampi spazi classici e fai clic su Modifica ambiti. Seleziona i seguenti ambiti:

    Verifica che siano selezionati 7 ambiti, quindi salva le modifiche.

  8. Fai clic su Distribuzione, seleziona Modifica e svolgi i seguenti passaggi:

    • Seleziona prima il pulsante di opzione Condivisione per attivare la modifica di altri campi.
    • Compila i campi rimanenti.
    • Seleziona Sì quando richiesto: Does your app store personal data?

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

Recupera l'URL e l'ID istanza

Per ottenere 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. L'aspetto sarà simile al seguente: Assign appropriate permissions.

Per ottenere 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 è il tuo 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. Nella sezione Accesso ai prodotti del gruppo della pagina del nuovo gruppo, fai clic su Aggiungi prodotti al gruppo.

  6. Per Jira, seleziona Amministratore dell'accesso utente come ruolo del prodotto.

  7. Per Jira Admin, seleziona Amministratore prodotto come ruolo del prodotto e salva le modifiche.

  8. Nella pagina Gruppi, fai clic su Aggiungi membri del gruppo e aggiungi gli utenti o gli account con cui il connettore eseguirà l'autenticazione.

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, vai alla sezione Origini di terze parti e seleziona Jira.

  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 Jira per il tuo datastore.

  7. Seleziona le entità da sincronizzare, quindi 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.

  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

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.

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:

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

Linee guida per la configurazione di Private Service Connect

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.

  • Configurazione di rete:

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

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

  • Regole firewall:

    a. Regole in entrata:

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

    b. Regole in uscita:

    • Attiva il traffico in uscita per impostazione predefinita, a meno che non vengano applicate regole di rifiuto specifiche.

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:

    a. Utilizza PSC per abilitare le connessioni dalle istanze private a Google Cloud.

    b. Crea una rete Virtual Private Cloud e le subnet necessarie.

    c. Crea un'istanza di una macchina virtuale (VM) e installa il servizio di backend.

    d. (Facoltativo) Configura un probe di controllo di integrità per monitorare l'integrità del backend.

    e. Aggiungi un bilanciatore del carico per instradare il traffico alla VM o al backend.

    f. Definisci le regole del firewall per consentire il traffico tra l'endpoint PSC e il backend.

    g. 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.

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.
Crea un nuovo utente

Quando crei un datastore, 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.
Assegnare un 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.

Configurare 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:
    • Sfogliare i progetti.
    • Sfoglia l'archivio dei progetti.

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

Configura un connettore Jira Data Center on-premise per sincronizzare i dati con Google Cloud. Innanzitutto, crea un datastore in Agent Builder e configura le impostazioni di connessione, incluse le preferenze di autenticazione e sincronizzazione.

Creare un connettore Jira Data Center on-premise

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, vai alla sezione Origini di terze parti e seleziona Jira.

  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 Jira per il tuo datastore.

  7. Seleziona le entità da sincronizzare, quindi 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.

  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

Collega Salesforce

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

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 controllo dell'accesso per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

  • 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: il nome di dominio della tua istanza Salesforce. Cerca Il mio dominio, copia il suffisso di dominio con my.salesforce.com e aggiungi https:// all'inizio.
    • ID cliente: copia l'ID client dall'app collegata facendo clic su Gestisci i dettagli del cliente. Se il token di aggiornamento è attivato, verifica che venga aggiornato e fornisci il token più recente quando crei un datastore.
    • Client secret: copia il client secret dall'app collegata facendo clic su Gestisci i dettagli del cliente. Se il token di aggiornamento è attivato, verifica che venga aggiornato e fornisci il token più recente quando crei un datastore.

  • Affinché le autorizzazioni utente vengano applicate correttamente, gli utenti di Salesforce devono fornire il consenso alla condivisione.

  • Utilizza un piano Enterprise o Developer. Gli account di prova non sono supportati.

  • Assicurati di utilizzare Sales Cloud. Service Cloud non è supportato.

  • Aggiungi Google Cloud alla lista consentita CORS di Salesforce. Se hai già completato questa attività, vai alla sezione Crea un'app.

    • Segui le istruzioni riportate nella documentazione di Salesforce per configurare la lista consentita CORS.
    • Inserisci https://console.cloud.google.com/ come URL origine e salva la configurazione.

Crea un'app

Salesforce supporta le seguenti app:

  1. App collegata.
  2. App client esterna.

Creare un'app collegata

Per configurare un'app collegata in Salesforce per l'integrazione con Google Cloud:

  1. Accedi a Salesforce.
  2. Fai clic sull'icona a forma di ingranaggio e vai a Impostazione.
  3. Nel menu Configurazione, vai ad Gestore app.
  4. Fai clic su Nuova app collegata.

  5. Per configurare l'app collegata:

    a. Nella pagina di creazione dell'app collegata, segui questi passaggi:

    • Seleziona Attiva impostazioni OAuth.
    • Imposta l'URL di callback su: https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
    • Seleziona i seguenti ambiti OAuth:
      • Accesso completo (full).
      • Esegui richieste in qualsiasi momento (refresh_token, offline_access).

    b. Attiva i flussi:

    • Flusso delle credenziali client.
    • Flusso del codice di autorizzazione e delle credenziali.
    • Credenziali utente nel corpo del messaggio POST per il flusso di codice di autorizzazione e credenziali.
    • Per il flusso di credenziali client, assegna il tuo nome utente nel campo Esegui come. Devi disporre delle autorizzazioni di lettura per tutte le entità che il connettore può estrarre.

Dopo aver creato l'app collegata:

  1. Modifica i criteri per le app:

    • Vai ad App Manager e modifica l'app appena creata.
    • Imposta Relax IP su Relax IP restrictions.
    • Configura Refresh Token Policy (Criteri per i token di aggiornamento) su Valid until revoked o su impostazioni più restrittive, se necessario.
    • Assicurati che l'opzione Utenti consentiti sia impostata su All users may self-authorize.

  2. Configura le limitazioni IP:

    • Se l'opzione Applicazione di intervalli IP a livello di organizzazione è attivata, imposta Intervalli IP attendibili in Sicurezza > Accesso di rete. Per ulteriori informazioni, consulta la documentazione relativa all'allentamento dell'IP delle app collegate e all'applicazione continua dell'IP.
    • Disattiva Applica intervalli IP di accesso a ogni richiesta se non sono richieste limitazioni IP.

  3. Configura un'app collegata OAuth:

  4. Salva l'app collegata:

    • Salva ed esci dall'app collegata.
    • Nella barra di ricerca, cerca Impostazioni di OAuth e OpenID Connect.
    • Attiva Consenti i flussi di credenziali e codici di autorizzazione e Flusso di nome utente e password OAuth.

Creare un'app client esterna

Per creare e configurare un'app client esterna in Salesforce in modo da attivare l'autenticazione basata su OAuth per le integrazioni:

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

    • Accedi a Salesforce.
    • Fai clic sull'icona a forma di ingranaggio e vai a Impostazione.
    • Vai a Configurazione > App > App client esterne.
    • Fai clic su Nuova app client esterna.

  2. Fornisci le informazioni richieste:

    • Inserisci il nome dell'app e il tuo indirizzo email. Il nome dell'API viene completato automaticamente per impostazione predefinita.
    • Lascia Stato della distribuzione su Local.

  3. Attiva le impostazioni OAuth:

    • Espandi API (Attiva impostazioni OAuth) e seleziona Attiva OAuth.
    • Configura:
      • URL callback: https://login.salesforce.com/services/oauth2/callback
      • Ambiti OAuth: gestisci i dati utente tramite le API (api).
      • In Abilitazione flusso, seleziona Abilita flusso di credenziali client.
      • Fai clic su Crea per creare l'app client esterna. Vai al gestore dell'app client esterna per visualizzare l'app che hai aggiunto all'elenco.

  4. Modifica i criteri per le app:

    • Apri l'app creata.
    • Vai a Norme e fai clic su Modifica.
    • In Flui di OAuth e miglioramenti delle app client esterne, seleziona Abilita il flusso delle credenziali client.
    • Inserisci il tuo nome utente Salesforce nel campo Esegui come.

  5. Accedi alle credenziali OAuth:

    • Fai clic su Impostazioni.
    • Fai clic su Impostazioni OAuth.
    • Fai clic su Chiave utente e secret per accedere alle credenziali. Il codice di verifica viene inviato al tuo indirizzo email.
    • Inserisci il codice di verifica e fai clic su Verifica.
    • Copia la chiave utente e utilizzala come ID client.
    • Copia il secret consumer e utilizzalo come client secret.

Creare un connettore Salesforce

Console

Per utilizzare la console Google Cloud per sincronizzare i dati da Salesforce 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 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 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. 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

Connetti ServiceNow

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

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 configurare la connessione:

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

  • Prepara le seguenti informazioni di autenticazione:

    • URL istanza nel formato https://<domain-name>.service-now.com/.
    • ID client e client secret. Per informazioni sulla configurazione dell'endpoint e sull'ottenimento dell'ID client e del client secret, vedi Creare un endpoint per consentire ai client di accedere all'istanza nella documentazione di ServiceNow.

    • Nome utente e password per uno dei seguenti tipi di ruolo ServiceNow:

      • Ruolo Amministratore. Consulta Ruoli di sistema di base nella documentazione di ServiceNow.

      • Un ruolo ServiceNow personalizzato. Si tratta di un'alternativa all'utilizzo di un ruolo amministrativo. Per utilizzare un ruolo ServiceNow personalizzato, crea regole di controllo accessi con i seguenti campi:

        Per ulteriori informazioni, consulta Creare un ruolo e Creare una regola ACL nella documentazione di 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, vai alla sezione Origini di terze parti e seleziona ServiceNow.

  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 minuti o ore.

Passaggi successivi

Connetti SharePoint Online

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

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 configurare la connessione:

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

  • 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 Microsoft.

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

    • URL istanza. Nel modulo http://DOMAIN_OR_SERVER/[sites/]WEBSITE. Per ulteriori informazioni sugli URL, consulta URL e token in SharePoint nella documentazione di SharePoint.

    • ID tenant, ID client e 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à Microsoft nella documentazione di Microsoft.

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

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

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

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

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, vai alla sezione Origini di terze parti e seleziona SharePoint Online.

  5. Inserisci le informazioni di autenticazione di SharePoint Online 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 Sharepoint Online 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 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.

Passaggi successivi

Connetti Slack

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

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 controllo dell'accesso per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

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

  • Prepara le seguenti informazioni di autenticazione di Slack:

    • 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.
    • 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.
    • Quando imposti gli ambiti di autorizzazione OAuth 2.0, configura i seguenti ambiti:

  • 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 i documenti dalla tua area di lavoro Slack.

Generare un token di bot

Genera un token di bot per accedere in modo sicuro a canali privati, messaggi istantanei (MI) e messaggi istantanei multipartito (MIM). Il token del bot non può eseguire la scansione dei canali pubblici di cui non fa parte e l'accesso ai canali pubblici genera un messaggio di 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 Ambiti token bot, aggiungi i seguenti ambiti obbligatori:

    Per impostazione predefinita, il bot legge dai canali #general e #random. Per attivare la scansione:

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

  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 del bot.

Generare un token utente

Genera un token utente per accedere a tutti i canali pubblici senza 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:

  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 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 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

Collegare Dropbox

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

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 controllo dell'accesso per l'origine dati. Per ulteriori informazioni, consulta Utilizzare il controllo dell'accesso alle origini dati.

  • 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

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, vai alla sezione Origini di terze parti e seleziona Dropbox.

  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

Connect Box

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

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 controllo dell'accesso per l'origine dati. Per informazioni sulla configurazione del controllo dell'accesso dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

  • Prepara le seguenti informazioni di autenticazione di Box. Per informazioni sulla configurazione di questi parametri, consulta JWT Auth nella documentazione per gli sviluppatori di Box.

    • ID azienda
    • ID client
    • Client secret
    • ID chiave pubblica
    • Chiave privata
    • Passphrase

  • Quando crei l'endpoint JWT, configura i seguenti ambiti:

La sincronizzazione delle modifiche incrementali dei commenti può richiedere più tempo rispetto all'intervallo di frequenza configurato. Se una cartella contenente un'entità viene copiata o spostata, la sincronizzazione delle modifiche incrementali può richiedere più tempo rispetto all'intervallo di frequenza configurato.

Creare un'app Box

  1. Accedi alla Box Developer Console con il tuo account amministratore.
  2. Fai clic su Crea nuova app.
  3. Seleziona il tipo App personalizzata.
  4. Inserisci il nome dell'app.
  5. Imposta lo scopo dell'app: integrazione, AI o Google Cloud Agent Builder.
  6. Scegli Autenticazione server con JWT.

Configurare l'app Box

Configura le impostazioni dell'app Box.

Creare una chiave pubblica/privata

  1. Vai alla Box Developer Console.

  2. Nella scheda Configurazione, fai clic su Genera una coppia di chiavi pubblica/privata.

    • La chiave pubblica viene caricata automaticamente nella console con un ID. Questo ID viene utilizzato durante la creazione di una connessione.
    • Un file di configurazione con la chiave privata e la passphrase può essere scaricato localmente. Assicurati di conservare questo file di configurazione per un uso futuro.
    • Se vuoi, per generare la tua chiave, consulta la guida alla configurazione della coppia di chiavi Box.

Configura le autorizzazioni richieste

  1. Nella sezione Ampi dello spazio di applicazione, seleziona la seguente autorizzazione:
    • Leggi tutti i file e le cartelle archiviati in Box.

Autorizza l'app

  1. Nella scheda Autorizzazione, fai clic su Esamina e invia e attendi l'approvazione dell'amministratore.
  2. Gli amministratori possono approvare l'app nella Console di amministrazione.

Dopo l'autorizzazione, Box configura completamente l'app.

Crea 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 l'origine di terze parti.

  5. Inserisci le tue 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

Collega OneDrive

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

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:

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, vai alla sezione Origini di terze parti e seleziona OneDrive.

  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