Suchanwendung für Gesundheitsprodukte 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 Gesundheitsinformationen, importieren Sie FHIR R4-Daten in den Datenspeicher, verbinden Sie es mit einer Gesundheitssuch-App und fragen Sie die klinischen Daten ab. Weitere Informationen finden Sie unter Speicher für Gesundheitsdaten erstellen.
  • Eine Gesundheitssuchanwendung erstellen, einen Gesundheitsdatenspeicher erstellen und FHIR R4-Daten importieren in während der App-Erstellung den Datenspeicher abrufen und die klinischen Daten abfragen.

Auf dieser Seite wird die zweite Methode beschrieben.

Häufigkeit des Datenimports

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

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

  • Streaming-Import (Vorabversion): Ein Streamingdatenimport nahezu in Echtzeit. 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 Suchanwendung 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.

  • Bereiten Sie Ihre FHIR-Daten für die Aufnahme vor.

  • 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 Anwendung für die Suche im Gesundheitswesen entweder in der Google Cloud Console oder mit der der API erstellen. Die beiden Ansätze unterscheiden sich so:

  • In der Google Cloud Console: Wählen Sie den FHIR-Quellspeicher im Cloud Healthcare API erstellen und FHIR-Daten als Teil der Healthcare-Suchanwendung importieren Erstellungsprozess. 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 Methode zum Erstellen eines Gesundheitsdatenspeichers.
    2. Verwenden Sie die Methode documents.import Methode zum Angeben des FHIR-Speichers in der Cloud Healthcare API und zum Importieren von FHIR Daten.
    3. Verwenden Sie die Methode engines.create Methode zum Erstellen der Suchanwendung für das Gesundheitswesen und zum Angeben eines vorhandenen Gesundheitswesens Datenspeicher.

So erstellen Sie eine Anwendung für die Suche nach Gesundheitsdaten:

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. Wählen Sie auf der Seite Anwendung erstellen die Option Suche aus.

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

  5. Klicken Sie zum Aktivieren der erweiterten LLM-Funktionen für diese App auf das Symbol Erweitertes LLM Funktionen ein-/ausschalten.

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

    Nach dem Aktivieren der LLM-Features kann es bis zu fünf Minuten dauern, bis die unterstützten Funktionen verfügbar sind.

  6. Geben Sie im Feld Name Ihrer App einen Namen für die App ein.

  7. Geben Sie im Feld Externer Name Ihres Unternehmens oder Ihrer Organisation den gängigen Namen Ihres Unternehmens oder Ihrer Organisation ein. Sie müssen keine Suffixe wie Inc oder LLC. Mit diesem Feld kann das LLM ermitteln, das Unternehmen, das die App repräsentiert.

  8. Klicken Sie auf Weiter.

  9. Führen Sie auf der Seite Datenspeicher einen der folgenden Schritte aus, um eine Verbindung zu einem Datenspeicher herzustellen:

    • Wählen Sie einen vorhandenen Gesundheitsdatenspeicher für den Batch-Import oder einen vorhandener Daten-Connector für den Streaming-Import. 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. Erweitern Sie das Feld FHIR-Speicher.
          2. Wählen Sie aus dieser Liste ein Dataset aus, das sich in einem zulässigen Standort und Wählen Sie dann einen FHIR-Speicher aus, 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.
        • Einmalig: Zum einmaligen Batch-Datenimport. Weitere inkrementelle Importe siehe Gesundheitsdaten aktualisieren.
        • Streaming: Zum Durchführen eines echtzeitnahen Streamingdatenimports. Bis müssen Sie einen Daten-Connector erstellen, Datenspeicher. Dies ist eine Funktion in der 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: Zum Beibehalten der von Google definierten Schemakonfigurationen, z. B. Indexierbarkeit, Suchbarkeit und Abrufbarkeit für die unterstützten FHIR-Ressourcen und -Elemente. Sobald Sie diese Option ausgewählt haben, Aktualisieren Sie das Schema, nachdem Sie den Datenspeicher erstellt haben. Wenn Sie das Schema nach der Erstellung des Datenspeichers ändern können, wählen Sie Benutzerdefiniertes Schema (Vorabversion).
          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 Funktion in der Vorabversion. So richten Sie ein konfigurierbares 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 neue Felder unterstützte FHIR-Ressourcen. 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 innerhalb der Daten hinzugefügt. Connector.

      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.

    Es wird eine Tabelle mit einer Liste von Datenspeichern und dem Grund für die Daten angezeigt. nicht verfügbar. Hier sind einige Gründe, warum ein Datenspeicher möglicherweise nicht verfügbar ist:

    • Ihr Datenspeichertyp lässt nur die Verbindung zu einer App und den Daten zu Shop ist bereits verknüpft.
    • Ihr Datenspeicher und Ihre Anwendung haben unterschiedliche Typen. Sie können beispielsweise keinen Websitesuchdatenspeicher mit einer Such-App für Gesundheitswesen verbinden.

  11. Klicken Sie auf Erstellen.

    Wenn die Anwendung und ihr Datenspeicher erfolgreich erstellt wurden, Auf der Detailseite des Datenspeichers werden die Details zu den 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 Suchanwendung für das Gesundheitswesen kann sich mit einem Datenspeicher verbinden, während ein bestimmter Datenspeicher verschiedene Apps.

    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-Anwendung, die Sie erstellen möchten.
    • APP_DISPLAY_NAME: der Anzeigename der Vertex AI Search-Anwendung, die Sie erstellen möchten.
    • DATA_STORE_ID: die ID eines vorhandenen Vertex AI Search-Datenspeichers die Sie der Vertex AI Search-Anwendung hinzufügen möchten.
    • SEARCH_ADD_ON: ein optionales Feld, das angegeben werden soll Egal, ob Sie die erweiterten LLM-Features nutzen möchten, z. B. die Suche mit generativen KI-Antworten, für diese App. Geben Sie zum Aktivieren der erweiterten LLM-Features die Wert SEARCH_ADD_ON_LLM. 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 Erweitert 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 über die REST API die Methode engines.get Methode zum Abrufen der Details zum Datenspeicher für Gesundheitsdaten.

Führen Sie die folgenden Schritte aus, um die Erstellung des Datenspeichers und den Datenimport zu prü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 überprü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. Überprüfen Sie die Erstellung des Datenspeichers und den FHIR-Datenimport.

Nächste Schritte