Configura un datastore EHR Epic

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

Prima di iniziare

Prima di configurare la connessione a Epic EHR:

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

    1. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM

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

  2. Chiedi al tuo analista Epic di registrare e configurare un'app Epic per Gemini Enterprise. Per saperne di più, consulta Configurazione di Epic EHR.

  3. Recupera i seguenti valori per l'ambiente Epic che vuoi connettere:

    • URL di base FHIR R4
    • URL di autorizzazione
    • URL del token
    • ID client e client secret dell'app Epic

    Per saperne di più, consulta Trova gli endpoint Epic.

Crea il datastore Epic EHR

Per creare il datastore Epic EHR, segui questi passaggi:

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

    Gemini Enterprise

  2. Seleziona o crea un progetto Google Cloud .

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

  4. Fai clic su Crea datastore.

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

  6. Nella sezione Dati:

    1. Nella sezione Impostazioni di autenticazione, inserisci i seguenti dettagli. Inserisci ogni URL con https:// e senza barra finale.

      • URI del segmento di pubblico Epic FHIR R4 (instance_uri): l'URL di base FHIR R4, ad esempio https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4.
      • URL di autorizzazione OAuth 2.0 di Epic: il tuo URL di autorizzazione.
      • URL del token OAuth 2.0 di Epic: l'URL del token.
      • ID client Epic Connection Hub: l'ID client della tua app Epic.
      • Client secret di Epic Connection Hub: il client secret della tua app Epic.

    2. Fai clic su Verify Auth (Verifica autenticazione) e completa l'accesso a Epic.

    3. Fai clic su Continua.

    4. Nella sezione Destinations (Destinazioni), nel campo Host in Epic FHIR R4 Base Endpoint URL (host_url) (URL endpoint di base Epic FHIR R4 (host_url)), inserisci l'URL di base FHIR R4 con https:// e senza barra finale. Utilizza lo stesso valore di URI del pubblico Epic FHIR R4 (instance_uri).

    5. Fai clic su Continua.

    6. Se il flusso di creazione del datastore mostra una sezione Opzioni avanzate, puoi selezionare la casella di controllo Abilita indirizzi IP statici al suo interno. In questo modo, il datastore utilizza un insieme fisso di indirizzi IP per il traffico in uscita, adatto per l'inserimento nella lista consentita nel sistema di origine. Per saperne di più, consulta Configura l'IP statico in uscita.

    7. Fai clic su Continua.

    8. Nella sezione Entities to search (Entità da cercare), seleziona tutte le entità.

  7. Fai clic su Continua.

  8. Nella sezione Azioni, mantieni selezionate tutte le azioni. Tutte le azioni EHR di Epic sono di sola lettura.

  9. Fai clic su Continua.

  10. Nella sezione Configurazione:

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

  11. Fai clic su Continua.

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

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

Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Dopo che lo stato del datastore passa da Creazione ad Attivo, il datastore Epic EHR è pronto per essere utilizzato.

Dopo aver creato il datastore, collegalo a un'app esistente o crea una nuova app e collegala alla nuova app, quindi autorizza Gemini Enterprise ad accedere a Epic EHR prima di eseguire qualsiasi query. Ogni utente autorizza il connettore con il proprio account Epic nella pagina di accesso a Epic della tua organizzazione.

Gestione dei dati ed esecuzione delle query

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

Esecuzione delle query

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

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

Gestione dei dati

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

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

Passaggi successivi