Filtrer la recherche de données de santé

Attention :

• Restrictions pour le secteur de la santé: en tant que client, vous ne devez pas utiliser les Services d'IA générative à des fins cliniques (par souci de clarté, la recherche non clinique, la planification ou les autres tâches administratives ne font pas l'objet de restrictions) ni les utiliser en remplacement de conseils médicaux professionnels, ni de quelque manière que ce soit qui fait l'objet d'une supervision par un organisme de réglementation, ou qui nécessite une autorisation ou une approbation de sa part. Pour en savoir plus, consultez la page Conditions spécifiques du service.

  Pour plus de clarté, concernant l'utilisation de Vertex AI Search pour récupérer et résumer des informations médicales existantes, la restriction d'utilisation à des fins cliniques signifie la restriction d'utilisation à des fins de diagnostic ou de traitement direct sans examen par un professionnel agréé, conformément aux lois et règlements applicables.

• Le résultat généré n'est pas toujours totalement fiable. En raison de la nature des LLM et de l'IA générative, les résultats peuvent contenir des informations incorrectes ou biaisées (par exemple, stéréotypes ou autres contenus nuisibles) et doivent être examinés. L'ensemble des synthèses ou des réponses doivent être considérées comme des brouillons et non comme définitives.
• L'utilisation prévue de ce produit n'est pas de fournir des informations sur la prévention, le diagnostic ou le traitement de maladies. Le produit n'est pas destiné à répondre aux questions concernant les diagnostics ou les recommandations de traitement. L'objectif de ce produit est de récupérer et de résumer les informations médicales existantes fournies par les utilisateurs.
• En raison de données de test limitées, ce produit peut être applicable ou non aux groupes d'âge de 0 à 18 ans et de 85 ans et plus. Par conséquent, lorsque les clients examinent la sortie générée, ils doivent tenir compte de la représentativité des sous-populations dans leurs données sources.

Lorsque vous interrogez des données de santé, vous pouvez utiliser des filtres pour affiner les réponses de recherche. Dans une requête de recherche, vous pouvez fournir des filtres pour appliquer des critères qui incluent ou excluent certaines réponses de recherche.

Par exemple, lorsque vous effectuez une recherche sur les données d'un seul patient, le corps de la requête de recherche doit contenir l'expression de filtre suivante qui spécifie l'ID du patient:

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

Cette page vous explique comment définir des filtres pour la recherche de prestataires de santé.

Avant de commencer

Avant de commencer, procédez comme suit :

• Créez une application de recherche de services de santé et un data store de recherche de services de santé, puis importez des données FHIR R4. Pour en savoir plus, consultez les pages Créer une application de recherche dans le domaine de la santé et Créer un datastore de recherche dans le domaine de la santé.
• Consultez la liste des ressources FHIR R4 compatibles avec Vertex AI Search en tant que champs indexables, recherchables et récupérables. Pour en savoir plus, consultez la documentation de référence sur le schéma de données FHIR R4 pour les soins de santé.
• Familiarisez-vous avec la syntaxe des expressions de filtre.

Définir des filtres

Les filtres sont spécifiés dans le champ filter du corps de la requête de la méthode servingConfigs.search.

La définition du filtre suit la syntaxe des expressions de filtre. Dans l'expression de filtre, le littéral peut être n'importe quel champ indexable de la réponse à la requête de recherche. Par exemple, si la réponse contient une ressource Observation, l'patient_id référencée par la ressource Observation peut être utilisée comme littéral de filtre.

Les sections suivantes présentent quelques exemples de création de filtres.

Définir un filtre resource_datetime

Cet exemple montre comment spécifier un filtre pour une recherche qui n'inclut que les ressources dont la valeur resource_datetime est postérieure à la date et à l'heure spécifiées.

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}}
}'

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud
• DATA_STORE_ID: ID du data store Vertex AI Search.
• QUERY: requête de recherche.
• PATIENT_ID: ID de la ressource du patient dont vous souhaitez rechercher les données.
• DATE_TIME_VALUE: valeur du champ resource_datetime représentant une date et une heure au format dateTime FHIR. Voici quelques exemples de ce champ :
  • Pour spécifier une date et une heure avec un fuseau horaire séparé par un séparateur T: 2022-08-05T01:00:00+00:00
  • Pour spécifier une date: 2022-08-05
  • Pour spécifier un mois: 2022-08
  • Pour spécifier une année: 2022

Réponse

Vous devriez recevoir une réponse JSON semblable à la réponse tronquée suivante. La réponse contient les résultats de recherche détaillés listés dans l'ordre chronologique inverse avec des extraits, le cas échéant. Le champ structData contient les données JSON structurées du document.

{
    "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"
            }
            ]
        }
        }
    }]
}

Définir un filtre de type de ressource

L'exemple suivant montre comment créer un filtre qui utilise un opérateur AND pour filtrer d'abord toutes les ressources de composition, puis celles dont la date est postérieure à une date et une heure spécifiées.

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

Définir un filtre de ressources FHIR

Vous pouvez utiliser un filtre pour vérifier si une ressource FHIR est présente dans le data store Vertex AI Search. Par exemple, vous pouvez rechercher une ressource DocumentReference dont l'ID est 6112d1ac-c6bd-4755-d689-bfb71d59afc5 à l'aide du filtre suivant.

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