Suche in Gesundheitsdaten filtern

Eingestellt: Agent Search für das Gesundheitswesen wird eingestellt und ist nach dem 15. Mai 2027 nicht mehr verfügbar.

Achtung:

• Einschränkungen für das Gesundheitswesen: Als Kunde dürfen Sie die auf generativer KI basierenden Dienste nicht für klinische Zwecke, als Ersatz für fachliche medizinische Ratschläge oder in irgendeiner Weise nutzen, die von einer entsprechenden Regulierungsbehörde beaufsichtigt wird oder deren Genehmigung erfordert, und Sie dürfen dies auch Endnutzern nicht gestatten. Die Nutzung für nicht klinische Forschung, Terminplanung oder andere administrative Aufgaben ist nicht eingeschränkt. Weitere Informationen finden Sie in den dienstspezifischen Nutzungsbedingungen.

  Zur Klarstellung: In Bezug auf die Verwendung von Agent Search zum Abrufen und Zusammenfassen vorhandener Medizinische Daten bedeutet die Einschränkung der Verwendung für klinische Zwecke die Einschränkung der Verwendung für direkte Diagnose- oder Behandlungszwecke ohne Überprüfung durch einen zugelassenen Arzt in Übereinstimmung mit den geltenden Gesetzen und Bestimmungen.

• Die generierte Ausgabe ist möglicherweise nicht immer zuverlässig. Aufgrund der Natur der LLMs und der generativen KI beinhalten Ausgaben möglicherweise falsche oder verzerrte Informationen (z. B. Stereotypen oder andere schädliche Inhalte). Sie sollten daher überprüft werden. Alle Zusammenfassungen oder Antworten sollten als Entwürfe betrachtet werden.
• Dieses Produkt ist nicht dazu bestimmt, Informationen zur Vorbeugung, Diagnose oder Behandlung von Krankheiten bereitzustellen. Fragen zu Diagnose- oder Behandlungsempfehlungen sollen nicht vom Produkt beantwortet werden. Dieses Produkt ist dazu bestimmt, vorhandene medizinische Informationen abzurufen und zusammenzufassen, die von Nutzern bereitgestellt werden.
• Aufgrund begrenzter Testdaten ist dieses Produkt möglicherweise nicht für die Altersgruppe 0–18 Jahre und für die Altersgruppe ab 85 Jahren geeignet. Daher müssen Kunden bei der Überprüfung der generierten Ausgabe die Repräsentativität von Untergruppen in ihren Quelldaten berücksichtigen.

Wenn Sie Gesundheitsdaten abfragen, können Sie Filter verwenden, um Ihre Suchantworten zu verfeinern. In einer Suchanfrage können Sie Filter angeben, um Kriterien zu erzwingen, die bestimmte Suchantworten ein- oder ausschließen.

Wenn Sie beispielsweise in den Daten eines einzelnen Patienten suchen, muss der Anfragetext der Suche den folgenden Filterausdruck enthalten, der die Patienten-ID angibt:

"filter": "patient_id: ANY(\"PATIENT_ID\")"

Auf dieser Seite erfahren Sie, wie Sie Filter für die Suche im Gesundheitswesen definieren.

Hinweis

Führen Sie zuerst folgende Schritte aus:

• Erstellen Sie eine Suchanwendung für das Gesundheitswesen und einen Datenspeicher für die Suche im Gesundheitswesen und importieren Sie FHIR R4-Daten. Weitere Informationen finden Sie unter Suchanwendung für das Gesundheitswesen erstellen und Datenspeicher für die Suche im Gesundheitswesen erstellen.
• Sehen Sie sich die Liste der FHIR R4-Ressourcen an, die von Agent Search als indexierbare, durchsuchbare und abrufbare Felder unterstützt werden. Weitere Informationen finden Sie in der Referenz zum FHIR R4-Datenschema für das Gesundheitswesen.
• Machen Sie sich mit der Syntax von Filterausdrücken vertraut.

Filter definieren

Filter werden im filter Feld im Anfragetext der servingConfigs.search Methode angegeben.

Die Filterdefinition folgt der Syntax von Filterausdrücken. Im Filterausdruck kann das Literal ein beliebiges indexierbares Feld aus der Antwort auf die Suchanfrage sein. Wenn die Antwort beispielsweise eine Beobachtungsressource enthält, kann die patient_id, auf die die Beobachtungsressource verweist, als Filterliteral verwendet werden.

In den folgenden Abschnitten finden Sie einige Beispiele für die Erstellung von Filtern.

resource_datetime-Filter definieren

In diesem Beispiel wird gezeigt, wie Sie einen Filter für eine Suche angeben, die nur Ressourcen enthält, deren Wert für resource_datetime nach dem angegebenen Datum und der angegebenen Uhrzeit liegt.

REST

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/servingConfigs/default_search:search" \
    -d '{
"query": "QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_datetime > \"DATE_TIME_VALUE,
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
}'

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID Ihres Google Cloud Projekts in.
• DATA_STORE_ID: die ID des Agent Search-Datenspeichers.
• QUERY: die Suchanfrage.
• PATIENT_ID: die Ressourcen-ID des Patienten, dessen Daten Sie durchsuchen möchten.
• DATE_TIME_VALUE: der Wert des resource_datetime Felds, der ein Datum und eine Uhrzeit im FHIR-dateTime-Format darstellt. Beispiele für dieses Feld:
  • Datum und Uhrzeit mit Zeitzone, getrennt durch ein T: 2022-08-05T01:00:00+00:00
  • Datum: 2022-08-05
  • Monat: 2022-08
  • Jahr: 2022

Antwort

Sie sollten eine JSON-Antwort ähnlich der folgenden gekürzten Antwort erhalten: Die Antwort enthält detaillierte Suchergebnisse, die in umgekehrt chronologischer Reihenfolge mit Snippets aufgeführt sind, sofern verfügbar. Das Feld structData enthält die strukturierten JSON-Daten für das Dokument.

{
    "results": [
    {
        "id": "DOCUMENT_ID",
        "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
            ...
            "resource_type": "FHIR_RESOURCE_TYPE",
            "resource_datetime": "RESOURCE_DATETIME",
            "patient_id": "PATIENT_ID",
            "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
            "snippets": [
            {
                "snippet": "SNIPPET_TEXT",
                "snippet_status": "SUCCESS"
            }
            ]
        }
        }
    }]
}

Ressourcentypfilter definieren

Im folgenden Beispiel wird gezeigt, wie Sie einen Filter erstellen, der mit einem AND-Operator zuerst alle Kompositionsressourcen filtert und dann diejenigen, deren Datum nach einem bestimmten Datum und einer bestimmten Uhrzeit liegt.

"filter": "resource_type: ANY("Composition") AND Composition.date > "2022-08-05T01:00:00+00:00""

FHIR-Ressourcenfilter definieren

Mit einem Filter können Sie prüfen, ob eine FHIR-Ressource im Agent Search-Datenspeicher vorhanden ist. Sie können beispielsweise mit dem folgenden Filter nach einer DocumentReference-Ressource mit der ID 6112d1ac-c6bd-4755-d689-bfb71d59afc5 suchen.

"filter": "DocumentReference.id: ANY(\"6112d1ac-c6bd-4755-d689-bfb71d59afc5\")"