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
Contatta il team degli Account Google e richiedi di essere aggiunto alla lista consentita per i connettori delle origini dati di terze parti.
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 modulo
https://EXAMPLE.atlassian.net
, ad esempiohttps://google.atlassian.net
.ID istanza. Si tratta di
cloudid
e puoi trovarlo andando suhttps://EXAMPLE.atlassian.net/_edge/tenant_info
e copiando il valore dicloudId
.
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à 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:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Nuovo datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Confluence.
Inserisci i tuoi dati di autenticazione e fai clic su Autentica.
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.
Seleziona le entità da sincronizzare, quindi fai clic su Continua.
Seleziona una regione per il connettore dati.
Inserisci un nome per il connettore dati.
Seleziona una frequenza di sincronizzazione.
Fai clic su Crea. Vertex AI Search crea il datastore e lo visualizza nella pagina Datastore.
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 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 accesso di terze parti.
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
NOTA: 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.
- Accedi a developer.atlassian.com.
- Fai clic sull'icona del profilo nell'angolo in alto a destra e seleziona Console per sviluppatori.
- Fai clic su Crea e seleziona Integrazione OAuth 2.0.
- Inserisci un nome per l'app.
- Seleziona la casella di controllo Termini e condizioni.
- Fai clic su Crea.
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).
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.
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.
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?
Seleziona Impostazioni per copiare l'ID client e il client secret.
Recupera l'URL e l'ID istanza
Per ottenere l'URL dell'istanza:
- Vai all'indirizzo atlassian.net e accedi con il tuo account amministratore.
- Seleziona l'app che vuoi sincronizzare. Ad esempio, sincronizza la prima app.
- 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:
- 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
. - Vai al link per trovare il valore
cloudId
.cloudId
è il tuo ID istanza.
Configurare autorizzazioni e ruoli
- Accedi ad atlassian.com con il tuo account amministratore.
- Fai clic sull'icona del menu in alto a sinistra o vai alla pagina admin.atlassian.com.
Nella pagina Amministrazione, fai clic su Gestisci utenti e vai alla pagina Gruppi.
Fai clic su Crea gruppo. Inserisci un nome per il gruppo e crealo.
Nella sezione Accesso ai prodotti del gruppo della pagina del nuovo gruppo, fai clic su Aggiungi prodotti al gruppo.
Per Jira, seleziona Amministratore dell'accesso utente come ruolo del prodotto.
Per Jira Admin, seleziona Amministratore prodotto come ruolo del prodotto e salva le modifiche.
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:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Jira.
Inserisci i tuoi dati di autenticazione e fai clic su Autentica.
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.
Seleziona le entità da sincronizzare, quindi fai clic su Continua.
Seleziona una regione per il tuo datastore.
Inserisci un nome per il tuo datastore.
Seleziona una frequenza di sincronizzazione.
Fai clic su Crea. Vertex AI Search crea il datastore e lo visualizza nella pagina Datastore.
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 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 accesso di terze parti.
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 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 di ID utente e 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
- Segreto utente
Si applica la seguente limitazione:
- Per sincronizzare un utente come entità, l'utente deve fornire il consenso alla condivisione.
Console
Per utilizzare la console Google Cloud per sincronizzare i dati da Salesforce a Vertex AI Search:
Aggiungi Google Cloud alla lista consentita CORS di Salesforce. Se lo hai già fatto, vai al passaggio successivo.
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.
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Salesforce.
Inserisci i dati di autenticazione di Salesforce.
Seleziona le entità da sincronizzare e fai clic su Continua.
Seleziona una regione per il tuo datastore.
Inserisci un nome per il tuo datastore.
Seleziona una frequenza di sincronizzazione.
Fai clic su Crea. Vertex AI Search crea il datastore e lo visualizza nella pagina Datastore.
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 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 accesso di terze parti.
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, consulta 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 saperne di più, consulta Creare un ruolo e Creare una regola ACL nella documentazione di ServiceNow.
- URL istanza nel formato
Console
Per utilizzare la console Google Cloud per sincronizzare i dati da ServiceNow a Vertex AI Search, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona ServiceNow.
Inserisci le informazioni di autenticazione di ServiceNow.
Seleziona le entità da sincronizzare e fai clic su Continua.
Seleziona una regione per il connettore dati.
Inserisci un nome per il connettore dati.
Seleziona una frequenza di sincronizzazione.
Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.
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 accesso di terze parti.
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:
- URL istanza. Nel modulo
La tabella seguente descrive i ruoli consigliati per la configurazione e le relative limitazioni.
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.
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 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 Slack:
- ID area di lavoro. Per informazioni su come ottenere gli ID dello spazio di lavoro, consulta Specifica l'origine Slack per il tuo datastore nella documentazione di Slack.
- Token di accesso. Per informazioni sulla creazione di un'app client e sulla definizione degli ambiti, consulta la guida rapida e l'articolo Come ottenere e utilizzare rapidamente un token API di Slack nella documentazione di Slack.
- Quando imposti gli ambiti di autorizzazione OAuth 2.0, configura i seguenti ambiti:
Si applica la seguente limitazione:
- Il comportamento predefinito di Slack limita la scansione e la sincronizzazione dei contenuti provenienti da canali privati, messaggi istantanei con più partecipanti e messaggi istantanei 1:1.
Console
Per utilizzare la console Google Cloud per sincronizzare i dati da Slack a Vertex AI Search, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Slack.
Inserisci le informazioni di autenticazione di Slack.
Seleziona le entità da sincronizzare e fai clic su Continua.
Seleziona una regione per il tuo datastore.
Inserisci un nome per il tuo datastore.
Seleziona una frequenza di sincronizzazione per il tuo datastore.
Fai clic su Crea. Vertex AI Search crea il datastore e lo visualizza nella pagina Datastore.
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 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 accesso di terze parti.
Connetti 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:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Dropbox.
Inserisci i dati di autenticazione di Dropbox e fai clic su Autentica. Viene visualizzata una nuova finestra.
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.
Seleziona le entità da sincronizzare e fai clic su Continua.
Seleziona una posizione per il tuo datastore.
Inserisci un nome per il tuo datastore.
Seleziona una frequenza di sincronizzazione per il tuo datastore.
Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.
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 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 e del datastore, consulta Generare risultati di ricerca. Se hai utilizzato controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.
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:
Si applicano le seguenti limitazioni:
- La sincronizzazione delle modifiche incrementali ai commenti potrebbe richiedere più tempo rispetto all'intervallo di frequenza configurato.
- Se una cartella contenente un'entità viene copiata o spostata, la sincronizzazione delle modifiche incrementali potrebbe richiedere più tempo rispetto all'intervallo di frequenza configurato.
Console
Per utilizzare la console Google Cloud per sincronizzare i dati da Box a Vertex AI Search, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona Casella.
Inserisci le tue informazioni di autenticazione.
Seleziona le entità da sincronizzare e fai clic su Continua.
Seleziona una regione per il tuo datastore.
Inserisci un nome per il tuo datastore.
Seleziona una frequenza di sincronizzazione per il tuo datastore.
Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.
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 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 e del datastore, consulta Generare risultati di ricerca. Se hai utilizzato controllo dell'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.
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 OneDrive:
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.
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.
Configura i seguenti ambiti:
Console
Per utilizzare la console Google Cloud per sincronizzare i dati da OneDrive a Vertex AI Search, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Agent Builder.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella pagina Seleziona un'origine dati, vai alla sezione Origini di terze parti e seleziona OneDrive.
Inserisci le informazioni di autenticazione di OneDrive.
Seleziona le entità da sincronizzare e fai clic su Continua.
Seleziona una regione per il tuo datastore.
Inserisci un nome per il tuo datastore.
Seleziona una frequenza di sincronizzazione per il tuo datastore.
Fai clic su Crea. Vertex AI Search crea il tuo datastore e lo visualizza nella pagina Datastore.
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 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 e del datastore, consulta Generare risultati di ricerca. Se hai utilizzato controllo dell'accesso di terze parti, consulta Visualizzare l'anteprima dei risultati per le app con controllo accesso di terze parti.