Such-App für das Gesundheitswesen erstellen

Wenn Sie in Vertex AI Search nach klinischen Daten suchen möchten, können Sie einen der folgenden Workflows ausführen:

  • Erstellen Sie einen Datenspeicher für die Gesundheitsversorgung, importieren Sie FHIR R4-Daten in den Datenspeicher, verbinden Sie ihn mit einer Such-App für die Gesundheitsversorgung und stellen Sie eine Abfrage an die klinischen Daten. Weitere Informationen finden Sie unter Datenspeicher für Gesundheitsdaten erstellen.
  • Erstellen Sie eine Such-App für die Gesundheitsversorgung, erstellen Sie einen Datenspeicher für die Gesundheitsversorgung und importieren Sie FHIR R4-Daten während des App-Erstellungsprozesses in den Datenspeicher. Anschließend können Sie die klinischen Daten abfragen.

Auf dieser Seite wird die zweite Methode beschrieben.

Häufigkeit des Datenimports

Sie haben folgende Möglichkeiten, FHIR-R4-Daten in einen Datenspeicher zu importieren:

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

  • Streaming-Import (Vorabversion): Streaming-Daten werden nahezu in Echtzeit importiert. Alle inkrementellen Änderungen im Quell-FHIR-Speicher werden mit dem Vertex AI Search-Datenspeicher synchronisiert. Für das Streaming ist ein Daten-Connector erforderlich. Das ist eine Art Datenspeicher, der eine Entität enthält. Eine Entität ist auch eine Datenspeicherinstanz.

    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.

Der Streaming-Import ist für alle Ressourcen verfügbar, die von Vertex AI Search unterstützt werden. Weitere Informationen finden Sie in der Referenz für das FHIR R4-Datenschema für die Gesundheitsversorgung.

Hinweise

Bevor Sie die Such-App für das Gesundheitswesen erstellen, müssen Sie die folgenden Anforderungen erfüllen:

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

  • FHIR-Daten für die Datenaufnahme vorbereiten

  • Vertex AI Search für das Gesundheitswesen bietet Suchdienste nur in der Multiregion USA (us) an. Ihre Suchanwendung und Ihre Datenspeicher für das Gesundheitswesen müssen sich daher in der Multiregion us befinden.

App erstellen

Sie können eine Such-App für die Gesundheitsversorgung entweder in der Google Cloud Console oder mit der API erstellen. Die beiden Ansätze unterscheiden sich so:

  • In der Google Cloud Console: Wählen Sie in der Cloud Healthcare API den Quell-FHIR-Speicher aus und importieren Sie FHIR-Daten im Rahmen des Erstellungsprozesses der App für die Gesundheitssuche. Wenn Sie FHIR-Daten streamen möchten (Vorabversion), muss sich Ihr Quell-FHIR-Speicher im selben Google Cloud-Projekt wie die Ziel-Vertex AI Search App befinden.
  • Über die REST API: Sie können FHIR-Daten aus einem FHIR-Speicher der Cloud Healthcare API importieren. Der FHIR-Speicher kann sich im selben oder in einem anderen Google Cloud-Projekt befinden.
    1. Verwenden Sie die Methode dataStores.create, um einen Datenspeicher für die Gesundheitsversorgung zu erstellen.
    2. Verwenden Sie die Methode documents.import, um den FHIR-Speicher in der Cloud Healthcare API anzugeben und FHIR-Daten zu importieren.
    3. Verwenden Sie die Methode engines.create, um die Such-App für die Gesundheitsversorgung zu erstellen und einen vorhandenen Datenspeicher für die Gesundheitsversorgung anzugeben.

So erstellen Sie eine Such-App für die Gesundheitsbranche:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.

    Zum Agent Builder

  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 die erweiterten LLM-Features für diese App aktivieren möchten, klicken Sie auf den Schalter Erweiterte LLM-Features.

    Aktivieren Sie erweiterte LLM-Funktionen, um Suchzusammenfassungen zu erhalten. Das sind kurze Zusammenfassungen der obersten Suchergebnisse.

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

  6. Geben Sie im Feld Anwendungsname einen Namen für die Anwendung ein.

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

  8. Klicken Sie auf Weiter.

  9. Wenn Sie eine Verbindung zu einem Datenspeicher herstellen möchten, gehen Sie auf der Seite Datenspeicher so vor:

    • Wählen Sie einen vorhandenen Healthcare-Datenspeicher für den Batchimport 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 die Gesundheitsbranche erstellen.
    • Erstellen Sie einen Datenspeicher (für einmaligen Batch-Import) oder einen Daten-Connector, der eine Instanz eines Datenspeichers ist (für 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 Speicherort befindet, und dann einen FHIR-Speicher, der FHIR-Version R4 verwendet.

            Wenn Sie FHIR-Daten streamen möchten (Vorabversion), muss sich der Quell-FHIR-Speicher im selben Google Cloud-Projekt wie der Zieldatenspeicher von Vertex AI Search befinden.

        • FHIR-Speicher manuell eingeben:
          1. Maximieren Sie das Feld FHIR-Speicher.
          2. Klicken Sie auf FHIR-Speicher manuell eingeben.
          3. Geben Sie im Dialogfeld Name des FHIR-Speichers 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.
        • Einmal: Damit wird ein einmaliger Batchdatenimport durchgeführt. Weitere Informationen zu inkrementellen Importen finden Sie unter Gesundheitsdaten aktualisieren.
        • Streaming: Damit können Sie Streamingdaten nahezu in Echtzeit importieren. Wenn Sie Daten streamen möchten, müssen Sie einen Daten-Connector erstellen, eine Art Datenspeicher. Dies ist eine Vorabversion. Wenden Sie sich an Ihren Kundenbetreuer, um einen Streaming-Datenspeicher mit der REST API einzurichten.
      5. Wählen Sie im Abschnitt Welches Schema haben diese Daten? eine der folgenden Optionen aus:
        • Von Google vordefiniertes Schema: Hiermit werden die von Google definierten Schemakonfigurationen wie Indexierbarkeit, Suchbarkeit und Abrufbarkeit für die unterstützten FHIR-Ressourcen und -Elemente beibehalten. Wenn Sie diese Option auswählen, 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 (Vorabversion) 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 (Vorabversion): Hiermit können Sie eigene Schemakonfigurationen für die unterstützten FHIR-Ressourcen und -Elemente definieren, z. B. Indexierbarkeit, Suchbarkeit und Abrufbarkeit. Dies ist eine Vorabversion. Wenden Sie sich an Ihren Kundenbetreuer, um ein konfigurierbares Schema einzurichten.
          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 bereitgestellten 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.

  10. Optional: Klicken Sie auf Erläuterung, um eine Liste der nicht verfügbaren Datenspeicher aufzurufen.

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

    • Mit Ihrem Datenspeichertyp ist nur eine Verbindung zu einer App möglich und der Datenspeicher ist bereits verbunden.
    • Ihr Datenspeicher und Ihre App haben unterschiedliche Typen. Sie können beispielsweise keinen Websitesuchdatenspeicher mit einer Such-App für Gesundheitswesen verbinden.

  11. Klicken Sie auf Erstellen.

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

REST

  1. Erstellen Sie einen Datenspeicher für Gesundheitsdaten und importieren Sie Gesundheitsdaten in diesen.

  2. Erstellen Sie eine Suchanwendung für Gesundheitsdaten und verknüpfen Sie sie mit einem Datenspeicher. Eine Such-App für Gesundheitsdaten kann nur mit einem Datenspeicher verbunden werden, während ein bestimmter Datenspeicher mit mehreren Apps verbunden werden kann.

    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/v1alpha/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 ist die ID Ihres Google Cloud-Projekts.
    • 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: Optionales Feld, in dem Sie angeben können, ob Sie die erweiterten LLM-Funktionen, z. B. die Suche mit Antworten der generativen KI, für diese App verwenden möchten. Geben Sie den Wert SEARCH_ADD_ON_LLM ein, um erweiterte LLM-Funktionen zu aktivieren. 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 finden Sie unter Erweiterte LLM-Features.

App-Erstellung bestätigen

In dieser Aufgabe erfahren Sie, wie Sie prüfen, ob eine Such-App für die Gesundheitsbranche erfolgreich erstellt und FHIR-Daten erfolgreich in den Datenspeicher importiert wurden.

  • In der Google Cloud Console: Wählen Sie die App aus und prüfen Sie die Details.
  • Verwenden Sie die Methode engines.get der REST API, um die Details zum Gesundheitsdatenspeicher 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 Agent Builder auf.

    Zum Agent Builder

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

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

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

REST

  1. Prüfen Sie, ob die App erstellt wurde.

    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/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Ersetzen Sie Folgendes:

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

  2. Prüfen, ob der Datenspeicher erstellt und FHIR-Daten importiert wurden

Nächste Schritte