Anwendung zur Suche nach Gesundheitsdaten erstellen

Wenn Sie klinische Daten in Vertex AI Search durchsuchen möchten, können Sie einen der folgenden Workflows verwenden:

  • Erstellen Sie einen Datenspeicher für Gesundheitsdaten, importieren Sie FHIR R4-Daten in den Datenspeicher, verbinden Sie ihn mit einer Anwendung zur Suche nach Gesundheitsdaten und fragen Sie die klinischen Daten ab. Weitere Informationen finden Sie unter Healthcare-Datenspeicher erstellen.
  • Erstellen Sie eine App zur Suche nach Gesundheitsdaten, erstellen Sie einen Datenspeicher für Gesundheitsdaten und importieren Sie FHIR R4-Daten in den Datenspeicher während der App-Erstellung und fragen Sie die klinischen Daten ab.

Auf dieser Seite wird die zweite Methode beschrieben.

Häufigkeit des Datenimports

Sie können FHIR R4-Daten auf folgende Weise in einen Datenspeicher importieren:

  • Batchimport: ein einmaliger Import. Daten werden in Batches in einen Datenspeicher importiert. Weitere Informationen zu inkrementellen Importen finden Sie unter Gesundheitsdaten aktualisieren.

  • Streamingimport: ein Streamingdatenimport nahezu in Echtzeit. Alle inkrementellen Änderungen im FHIR-Quellspeicher werden mit dem Vertex AI Search-Datenspeicher synchronisiert. Für das Streaming ist ein Daten-Connector erforderlich, der eine Art Datenspeicher ist. Wenn Sie einen Datenconnector erstellen möchten, müssen Sie eine Sammlung einrichten. Ein Daten-Connector enthält eine Entität, die auch eine Datenspeicherinstanz ist.

    Sie können das Streaming auch pausieren und fortsetzen und bei Bedarf eine manuelle Synchronisierung durchführen. Weitere Informationen finden Sie unter Datenspeicher für Suchdaten im Gesundheitswesen verwalten.

    Die Datenstreamingrate für ein bestimmtes Google Cloud Projekt hängt von den folgenden Kontingenten ab. Wenn Sie das Kontingent überschreiten, kann es zu Streamingverzögerungen kommen.

Sie können die Häufigkeit des Datenimports beim Erstellen des Datenspeichers auswählen. Diese Konfiguration kann später nicht mehr geändert werden.

Hinweise

Bevor Sie die Gesundheits-Such-App erstellen, sollten Sie Folgendes beachten:

  • Die Beziehung zwischen Apps und Datenspeichern für die Suche nach Gesundheitsdaten. Weitere Informationen finden Sie unter Apps und Datenspeicher.

  • Vorbereitung Ihrer FHIR-Daten für die Aufnahme

  • Vertex AI Search for Healthcare bietet Suchdienste nur in der US-Multiregion (us) an. Ihre Healthcare-Suchanwendung und Ihre Datenspeicher müssen sich daher in der Multiregion us befinden.

  • Wenn Sie Gesundheitsdaten aus einem Cloud Healthcare API-FHIR-Speicher in einem Google Cloud Projekt in einen Vertex AI Search-Datenspeicher in einem anderen Google Cloud Projekt importieren und VPC Service Controls verwenden, müssen sich die beiden Projekte im selben Perimeter befinden.

App erstellen

Sie können eine Healthcare-Suchanwendung entweder in der Google Cloud Console oder über die API erstellen. So erstellen Sie eine App für die Suche im Gesundheitswesen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

    KI-Anwendungen

  2. Klicken Sie auf der Seite Apps auf  Neue App.

  3. Klicken Sie auf der Seite App erstellen unter Suche im Gesundheitswesen auf Erstellen.

  4. Wählen Sie im Bereich Konfiguration der Suchanwendung die Option Gesundheitswesen aus.

  5. Wenn Sie generative Antworten aktivieren möchten, die erweiterte LLM-Funktionen für diese App verwenden, klicken Sie auf den Schalter Generative Antworten, um ihn auf „Ein“ zu stellen.

    Wenn Sie generative Antworten aktivieren, kann es bis zu fünf Minuten dauern, bis die unterstützten Funktionen verfügbar sind.

  6. Geben Sie im Feld Name der App einen Namen für Ihre App ein.

  7. Geben Sie im Feld Externer Name Ihres Unternehmens oder Ihrer Organisation den üblichen Namen Ihres Unternehmens oder Ihrer Organisation ein. Suffixe wie „Inc.“ oder „LLC“ müssen nicht angegeben werden. Dieses Feld ist nützlich, damit das LLM das Unternehmen identifizieren kann, für das die App steht.

  8. Wählen Sie im Bereich Access Transparency (Transparenz beim Zugriff) die Option Disable search metrics for this app (Suchmesswerte für diese App deaktivieren) aus, um die Protokollierung von Messwerten für die aktuelle App zu deaktivieren. Diese Einstellung kann nach der Erstellung der App nicht mehr geändert werden.

  9. Klicken Sie auf Weiter.

  10. So stellen Sie eine Verbindung zu einem Datenspeicher her:

    • Wählen Sie einen vorhandenen Healthcare-Datenspeicher für den Batch-Import oder einen vorhandenen Daten-Connector für den Streaming-Import aus. Informationen zum Erstellen eines Datenspeichers oder Datenconnectors vor dem Erstellen einer App finden Sie unter Datenspeicher für Gesundheitsdaten erstellen.
    • Erstellen Sie einen Datenspeicher (für den einmaligen Batchimport) oder einen Daten-Connector, der eine Instanz eines Datenspeichers ist (für den Streaming-Import):
      1. Klicken Sie auf Datenspeicher erstellen.
      2. Wählen Sie im Bereich Datenquelle auswählen die Option Healthcare API (FHIR) als Datenquelle aus.
      3. Führen Sie einen der folgenden Schritte aus, um Daten aus Ihrem FHIR-Speicher zu importieren:
        • Wählen Sie den FHIR-Speicher aus der Liste der verfügbaren FHIR-Speicher aus:
          1. Maximieren Sie das Feld FHIR-Speicher.
          2. Wählen Sie in dieser Liste ein Dataset aus, das sich an einem zulässigen Standort befindet, und dann einen FHIR-Speicher, der FHIR-Version R4 verwendet.
        • Geben Sie den FHIR-Speicher manuell ein:
          1. Maximieren Sie das Feld FHIR-Speicher.
          2. Klicken Sie auf FHIR-Speicher manuell eingeben.
          3. Geben Sie im Dialogfeld FHIR-Speichername den vollständigen Namen des FHIR-Speichers im folgenden Format ein:

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. Klicken Sie auf Speichern.
      4. Wählen Sie im Bereich Synchronisierung eine der folgenden Optionen aus. Diese Auswahl kann nach dem Erstellen des Datenspeichers nicht mehr geändert werden.
        • Einmalig: für einen einmaligen Batchdatenimport. Weitere inkrementelle Importe finden Sie unter Gesundheitsdaten aktualisieren.
        • Streaming: zum Importieren von Streamingdaten nahezu in Echtzeit. Wenn Sie Daten streamen möchten, müssen Sie einen Datenconnector erstellen. Das ist eine Art Datenspeicher. Wenn Sie einen Streaming-Datenspeicher mit der REST API einrichten möchten, wenden Sie sich an Ihren Customer Engineer.
      5. Wählen Sie im Abschnitt Welches Schema haben diese Daten? eine der folgenden Optionen aus:
        • Von Google vordefiniertes Schema: Damit werden die von Google definierten Schemakonfigurationen wie Indexierbarkeit, Suchbarkeit und Abrufbarkeit für die unterstützten FHIR-Ressourcen und -Elemente beibehalten. Nachdem Sie diese Option ausgewählt haben, können Sie das Schema nach dem Erstellen des Datenspeichers nicht mehr aktualisieren. Wenn Sie das Schema nach dem Erstellen des Datenspeichers ändern möchten, wählen Sie die Option Benutzerdefiniertes Schema aus.
          1. Klicken Sie auf Weiter.
          2. Geben Sie im Feld Name des Datenspeichers einen Namen für den Datenspeicher ein.
          3. Klicken Sie auf Erstellen.

            4. Der von Ihnen erstellte Datenspeicher wird auf der Seite Datenspeicher aufgeführt.

        • Benutzerdefiniertes Schema: Sie können eigene Schemakonfigurationen für die unterstützten FHIR-Ressourcen und -Elemente definieren, z. B. Indexierbarkeit, Durchsuchbarkeit und Abrufbarkeit. Wenn Sie ein konfigurierbares Schema einrichten möchten, wenden Sie sich an Ihren Customer Engineer.
          1. Klicken Sie auf Weiter.
          2. Sehen Sie sich das Schema an, maximieren Sie jedes Feld und bearbeiten Sie die Feldeinstellungen.
          3. Klicken Sie auf Neue Felder hinzufügen, um den unterstützten FHIR-Ressourcen neue Felder hinzuzufügen. Die im von Google definierten Schema enthaltenen Felder können nicht entfernt werden.
          4. Klicken Sie auf Weiter.
          5. Geben Sie im Feld Name des Daten-Connectors einen Namen für den Daten-Connector ein.
          6. Klicken Sie auf Erstellen.

            7. Der von Ihnen erstellte Daten-Connector wird auf der Seite Datenspeicher aufgeführt. Der FHIR-Quellspeicher wird als Entität im Daten-Connector hinzugefügt.

      6. Klicken Sie auf Weiter.
      7. Wählen Sie den erstellten Datenspeicher oder Daten-Connector aus.

  11. Optional: Wenn Sie eine Liste der nicht verfügbaren Datenspeicher aufrufen möchten, klicken Sie auf Weitere Informationen.

    Eine Tabelle mit einer Liste der Datenspeicher und dem Grund, warum sie nicht verfügbar sind, wird angezeigt. Hier sind einige Gründe dafür, warum ein Datenspeicher möglicherweise nicht verfügbar ist:

    • Ihr Datenspeichertyp lässt nur die Verbindung zu einer App zu und der Datenspeicher ist bereits verbunden.
    • Ihr Datenspeicher und Ihre App haben unterschiedliche Typen. So können Sie beispielsweise keinen Websitedatenspeicher für die Suche mit einer Anwendung für die Suche nach Gesundheitsdaten verbinden.

  12. Klicken Sie auf Erstellen.

    Wenn die App und der Datenspeicher erfolgreich erstellt wurden, werden auf der Seite mit den Datenspeicherdetails die Details der importierten FHIR-Daten angezeigt.

REST

  1. Datenspeicher für Gesundheitsdaten erstellen und Gesundheitsdaten importieren

  2. Erstellen Sie eine Anwendung zur Suche nach Gesundheitsdaten und verbinden Sie sie mit einem Datenspeicher. Eine Anwendung zur Suche in Gesundheitsdaten kann nur zu genau einem Datenspeicher eine Verbindung herstellen. Ein Datenspeicher kann dagegen mit mehreren Anwendungen verbunden sein.

    curl -X POST\
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
"https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines?engineId=APP_ID" \
 -d '{
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds":"DATA_STORE_ID",
    "industryVertical": "HEALTHCARE_FHIR",
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": ["SEARCH_ADD_ON"]
    }
}'

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID Ihres Projekts in Google Cloud .
    • APP_ID: die ID der Vertex AI Search-App, die Sie erstellen möchten.
    • APP_DISPLAY_NAME: Der Anzeigename der Vertex AI Search-App, die Sie erstellen möchten.
    • DATA_STORE_ID: Die ID eines vorhandenen Vertex AI Search-Datenspeichers, den Sie der Vertex AI Search-App hinzufügen möchten.
    • SEARCH_ADD_ON: Ein optionales Feld, in dem Sie angeben können, ob Sie die erweiterten LLM-Funktionen wie Suchen mit generativen KI-Antworten für diese App verwenden möchten. Wenn Sie erweiterte LLM-Funktionen aktivieren möchten, geben Sie den Wert SEARCH_ADD_ON_LLM ein. Wenn Sie keine erweiterten LLM-Features verwenden möchten, geben Sie entweder SEARCH_ADD_ON_UNSPECIFIED an oder entfernen Sie das Feld searchAddOns. Weitere Informationen zu erweiterten LLM-Features

App-Erstellung bestätigen

In dieser Aufgabe erfahren Sie, wie Sie prüfen, ob eine App zur Suche nach Gesundheitsdaten erfolgreich erstellt wurde und ob FHIR-Daten erfolgreich in den Datenspeicher importiert wurden.

  • Wählen Sie in der Google Cloud Console die App aus und prüfen Sie die Details.
  • Verwenden Sie über die REST API die Methode engines.get, um die Details des Gesundheitsdatenspeichers abzurufen.

Führen Sie die folgenden Schritte aus, um die Erstellung des Datenspeichers und den Datenimport zu überprüfen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

    KI-Anwendungen

  2. Prüfen Sie auf der Seite Apps, ob die von Ihnen erstellte App in der Liste der Apps enthalten ist.

  3. Prüfen Sie, ob der Datenspeicher, den Sie mit der App verbunden haben, in der Tabelle Verbundene Datenspeicher aufgeführt ist.

  4. Wählen Sie den Datenspeicher aus und prüfen Sie die Details.

REST

  1. App-Erstellung überprüfen

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
 "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID Ihres Projekts in Google Cloud .
    • APP_ID: Die ID der Vertex AI Search-Anwendung.

  2. Datenspeichererstellung und FHIR-Datenimport überprüfen

Nächste Schritte