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:

   • Collegare Confluence Cloud
   • Collegare Jira Cloud
   • Collegare Salesforce
   • Collegare ServiceNow
   • Collegare SharePoint Online
   • Collegare Slack
   • Collegare Dropbox
   • Connect Box
   • Collegare OneDrive

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:

  Visualizza gli ambiti

  • read:attachment:confluence
  • read:configuration:confluence
  • read:content-details:confluence
  • read:content.metadata:confluence
  • read:group:confluence
  • read:space:confluence
  • read:user:confluence

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

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

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:

   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

   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

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

   • Utilizza le seguenti guide per configurare un'app connessa OAuth:
     • Nozioni di base sulle app collegate.
     • Integrazione dell'API.
     • Configurazione delle credenziali client.

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

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

      Visualizza campi

      • Tipo: record
      • Operazione: read
      • Nome (è necessaria una regola di controllo dell'accesso separata per ciascuna):
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • Richiede ruolo: il nome del ruolo personalizzato

      Per ulteriori informazioni, consulta Creare un ruolo e Creare una regola ACL nella documentazione di ServiceNow.

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:

    Visualizza gli ambiti

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

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

    Visualizza gli ambiti

    • AllSites.FullControl

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

  Visualizza ruoli

  Ruoli	Registrazione dell'applicazione client	Può recuperare i contenuti di tutte le entità	Può recuperare l'ACL	Può recuperare 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: non è possibile recuperare l'identità o le entità di commenti e allegati
  Proprietario del sito	No	Sì	Sì	No	Limitazione: impossibile recuperare l'identità
  Amministratore delle applicazioni	Sì	N/D	N/A	N/D	Il ruolo di amministratore dell'applicazione è correlato al Centro amministrazione di Microsoft 365 / Centro amministrazione di Entra. Non è specifico di SharePoint.

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

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

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

   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

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.

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

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:

  Visualizza gli ambiti

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

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

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:

    Visualizza gli ambiti

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

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.