Rechercher des données de santé

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Sélectionnez l'application de recherche de services de santé que vous souhaitez interroger.

3. Dans le menu de navigation, cliquez sur Aperçu.

4. Dans le champ ID du patient, saisissez l'ID du patient dont vous souhaitez interroger les données. Les ID de patient sont sensibles à la casse.

5. Appuyez sur Entrée ou cliquez sur Aperçu pour envoyer l'ID du patient.

6. Dans la barre de recherche Rechercher ici, saisissez un mot clé pour effectuer une recherche.

   Si vous avez activé la saisie semi-automatique, une liste de suggestions de saisie semi-automatique s'affiche sous la barre de recherche à mesure que vous saisissez du texte.

7. Appuyez sur Entrée pour envoyer la requête.

   • Les résultats de la recherche sont affichés dans des tableaux paginés classés en fonction de leur type de ressource FHIR.
   • Par défaut, les résultats de recherche pour tous les types de ressources FHIR sont affichés dans l'ordre chronologique inverse.

8. Facultatif. Pour filtrer les résultats, sélectionnez une ou plusieurs catégories de ressources FHIR sous la barre de recherche.

9. Facultatif. Pour trier les résultats en fonction de la pertinence pour les ressources Composition, DocumentReference et DiagnosticReport, cliquez sur le filtre Trier: ordre chronologique inverse, puis sélectionnez Relevance (Pertinence) dans la liste. Pour en savoir plus, consultez Ordonner les résultats de recherche de prestataires de santé.

REST

L'exemple suivant montre comment rechercher les données FHIR R4 d'un seul patient dans l'application de recherche de soins de santé à l'aide d'un mot clé. Cet exemple utilise la méthode servingConfigs.search.

Par défaut, les résultats de recherche sont renvoyés dans l'ordre chronologique inverse. Lorsque vous effectuez une recherche dans les ressources Composition, DiagnosticReport et DocumentReference, vous pouvez trier les résultats de recherche en fonction de leur pertinence. Pour en savoir plus, consultez Ordonner les résultats de recherche de prestataires de santé.

1. Effectuez une recherche à l'aide d'un mot clé.

   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/engines/APP_ID/servingConfigs/default_search:search" \
     -d '{
   "query": "KEYWORD_QUERY",
   "filter": "patientId: ANY(\"PATIENT_ID\")",
   "contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet Google Cloud
   • APP_ID: ID de l'application Vertex AI Search que vous souhaitez interroger.
   • KEYWORD_QUERY: mot clé que vous souhaitez rechercher dans les données cliniques du patient filtré, par exemple "diabète" ou "a1c".
   • PATIENT_ID: ID de la ressource du patient dont vous souhaitez rechercher les données.

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

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Sélectionnez l'application de recherche de services de santé que vous souhaitez interroger.

3. Dans le menu de navigation, cliquez sur Aperçu.

4. Dans le champ ID du patient, saisissez l'ID du patient dont vous souhaitez interroger les données. Les ID de patient sont sensibles à la casse.

5. Appuyez sur Entrée ou cliquez sur Aperçu pour envoyer l'ID du patient.

6. Dans la barre de recherche Rechercher ici, saisissez une requête en langage naturel, par exemple "Résultats d'analyse liés au diabète".

   Si vous avez activé la saisie semi-automatique, une liste de suggestions de saisie semi-automatique s'affiche sous la barre de recherche à mesure que vous saisissez du texte.

7. Appuyez sur Entrée pour envoyer la requête.

   • Les résultats de la recherche sont affichés dans des tableaux paginés classés en fonction de leur type de ressource FHIR.
   • Par défaut, les résultats de recherche pour tous les types de ressources FHIR sont affichés dans l'ordre chronologique inverse.

8. Facultatif. Sélectionnez une ou plusieurs catégories de ressources FHIR sous la barre de recherche pour filtrer les résultats.

9. Facultatif. Pour trier les résultats en fonction de la pertinence pour les ressources Composition, DocumentReference et DiagnosticReport, cliquez sur le filtre Trier: ordre chronologique inverse, puis sélectionnez Relevance (Pertinence) dans la liste. Pour en savoir plus, consultez Ordonner les résultats de recherche de prestataires de santé.

REST

L'exemple suivant montre comment rechercher les données FHIR R4 d'un seul patient dans l'application de recherche de services de santé à l'aide d'une requête en langage naturel. Cet exemple utilise la méthode servingConfigs.search. Pour effectuer une recherche à l'aide d'une requête en langage naturel, vous devez ajouter le champ naturalLanguageQueryUnderstandingSpec au corps de la requête.

Par défaut, les résultats de recherche sont renvoyés dans l'ordre chronologique inverse. Lorsque vous effectuez une recherche dans les ressources Composition, DiagnosticReport et DocumentReference, vous pouvez trier les résultats de recherche en fonction de leur pertinence. Pour en savoir plus, consultez Ordonner les résultats de recherche de prestataires de santé.

1. Envoyez une requête en langage naturel.

   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/engines/APP_ID/servingConfigs/default_search:search" \
     -d '{
   "query": "NATURAL_LANGUAGE_QUERY",
   "filter": "patientId: ANY(\"PATIENT_ID\")",
   "contentSearchSpec":{"snippetSpec":{"returnSnippet":true}},
   "naturalLanguageQueryUnderstandingSpec":{"filterExtractionCondition":"ENABLED"}
   }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet Google Cloud
   • APP_ID: ID de l'application Vertex AI Search que vous souhaitez interroger.
   • NATURAL_LANGUAGE_QUERY: la requête en langage naturel, par exemple "Résultats d'analyse liés au diabète" ou "Le patient prend-il actuellement des médicaments ?"
   • PATIENT_ID: ID de la ressource du patient dont vous souhaitez rechercher les données.

   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.

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

Console

1. Dans la console Google Cloud, accédez à la page Agent Builder.

   Agent Builder

2. Sélectionnez l'application de recherche de services de santé que vous souhaitez interroger.

3. Dans le menu de navigation, cliquez sur Configurations.

4. Personnalisez le widget Recherche:

   1. Dans le champ Type de recherche, sélectionnez Recherche avec une réponse.
   2. Sélectionnez le modèle que vous souhaitez utiliser pour générer le résumé. Pour en savoir plus, consultez Configurer les résultats de recherche pour les données de santé.
   3. Enregistrez et publiez vos préférences.

5. Dans le menu de navigation, cliquez sur Aperçu.

6. Dans le champ ID du patient, saisissez l'ID du patient dont vous souhaitez interroger les données. Les ID de patient sont sensibles à la casse.

7. Appuyez sur Entrée ou cliquez sur Aperçu pour envoyer l'ID du patient.

8. Dans la barre de recherche Rechercher ici, saisissez une requête en langage naturel, par exemple "nsaids", "Quels sont les résultats lipidiques du patient" ou "Quel est le résultat A1C le plus récent".

   Si vous avez activé la saisie semi-automatique, une liste de suggestions de saisie semi-automatique s'affiche sous la barre de recherche à mesure que vous saisissez du texte.

9. Appuyez sur Entrée pour envoyer la requête.

   • La réponse de l'IA générative s'affiche sous la barre de recherche.
   • Les résultats de la recherche sont affichés dans des tableaux paginés classés en fonction de leur type de ressource FHIR.
   • Par défaut, les résultats de recherche pour tous les types de ressources FHIR sont affichés dans l'ordre chronologique inverse.

10. Facultatif. Développez un segment de la réponse qui comporte des citations pour afficher ses références dans les résultats de recherche.

11. Facultatif. Sélectionnez une ou plusieurs catégories de ressources FHIR sous la barre de recherche pour filtrer les résultats.

12. Facultatif. Pour trier les résultats en fonction de la pertinence pour les ressources Composition, DocumentReference et DiagnosticReport, cliquez sur le filtre Trier: ordre chronologique inverse, puis sélectionnez Relevance (Pertinence) dans la liste. Pour en savoir plus, consultez Ordonner les résultats de recherche de prestataires de santé.

REST

L'exemple suivant montre comment rechercher les données FHIR R4 d'un seul patient dans l'application de recherche de soins de santé à l'aide d'une requête en langage naturel avec des réponses d'IA générative. Cet exemple utilise la méthode servingConfigs.search.

• Pour effectuer une recherche à l'aide d'une requête en langage naturel, vous devez ajouter le champ naturalLanguageQueryUnderstandingSpec au corps de la requête.
• Pour inclure des index de citations intégrés, vous devez ajouter le champ includeCitations. Il s'agit d'un champ booléen dont la valeur par défaut est false.

Par défaut, les résultats de recherche sont renvoyés dans l'ordre chronologique inverse. Lorsque vous effectuez une recherche dans les ressources Composition, DiagnosticReport et DocumentReference, vous pouvez trier les résultats de recherche en fonction de leur pertinence. Pour en savoir plus, consultez Ordonner les résultats de recherche de prestataires de santé.

1. Envoyez une requête en langage naturel.

   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/engines/APP_ID/servingConfigs/default_search:search" \
     -d '{
           "query": "QUERY",
           "filter": "patientId: ANY(\"PATIENT_ID\")",
           "contentSearchSpec": {
             "snippetSpec": {
               "returnSnippet": true
             },
             "summarySpec": {
               "summaryResultCount": 1,
               "includeCitations": true,
               "modelSpec": {
                 "version": "MODEL_VERSION"
               }
             }
           },
           "naturalLanguageQueryUnderstandingSpec": {
             "filterExtractionCondition": "ENABLED"
           }
         }'
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet Google Cloud
   • APP_ID: ID de l'application Vertex AI Search que vous souhaitez interroger.
   • QUERY: la requête en langage naturel, par exemple "nsaids", "Quels sont les résultats lipidiques des patients" ou "Quel est le résultat A1C le plus récent". Si la requête inclut une apostrophe ', vous devez la remplacer par la référence de caractère numérique de l'apostrophe: '.
   • PATIENT_ID: ID de la ressource du patient dont vous souhaitez rechercher les données.
   • MODEL_VERSION: version du modèle que vous souhaitez utiliser pour générer la réponse.

   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, ainsi que les champs suivants dans l'objet summary:

   • summaryText: contient le résumé de la réponse générée.
   • summaryWithMetadata: contient le résumé de la réponse générée, avec des citations. Ce champ ne s'affiche que s'il existe des citations. Toutes les réponses générées ne comportent pas de citations. Lorsque le champ summaryWithMetadata est disponible, Google recommande d'utiliser le champ summaryWithMetadata plutôt que le champ summaryText.
   • citations.sources.referenceIndex: contient l'index de référence des documents cités dans la réponse. Cela permet de trouver le nom complet de la ressource du document dans le champ references.

   {
     "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"
               }
             ]
           }
         }
       }
     ],
     "summary": {
       "summaryText": "GENERATE_ANSWER_TEXT",
       "summaryWithMetadata": {
         "summary": "GENERATE_ANSWER_TEXT",
         "citationMetadata": {
           "citations": [
             {
               "sources": [
                 {
                   "id": "DOCUMENT_ID",
                   "referenceIndex": "REFERENCE_INDEX_FROM_SUMMARY_METADATA"
                 }
               ]
             }
          ]
         },
         "references": [
           {
             "document": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID"
           },
           ...
         ]
       },
     }
   ...
   }