Ordenar os resultados da pesquisa de saúde

Por padrão, quando você pesquisa dados de saúde, os resultados são retornados em ordem cronológica inversa. Ao pesquisar os seguintes tipos de recursos FHIR que contêm texto não estruturado, é possível ordenar os resultados de acordo com a relevância para sua consulta:

  • Composição
  • DiagnosticReport
  • DocumentReference

Exemplo de cenário

Suponha que você esteja pesquisando a palavra-chave insulin para um determinado paciente e tenha filtrado os resultados para os recursos que contêm texto não estruturado. Entre outros resultados, você recebe os seguintes documentos:

  • Resultado 1: um recurso DocumentReference, datado de 24 de abril de 2024, que contém observações sobre os níveis de "HbA1c" do paciente.
  • Resultado 2: um recurso DiagnosticReport, datado de 11 de janeiro de 2024, que contém observações sobre o "regime de insulina" que o paciente precisa seguir.

Por padrão, o resultado 1 aparece mais acima porque é um documento mais recente. No entanto, quando você ordena por relevância, o resultado 2 aparece mais acima. Isso acontece porque ele é mais relevante para a consulta de pesquisa insulin.

Ordenar os resultados da pesquisa de serviços de saúde

Para ordenar os resultados da pesquisa por relevância, siga estas etapas:

Console

  1. No console Google Cloud , acesse a página Aplicativos de IA.

    Aplicativos de IA

  2. Selecione o app de pesquisa de saúde que você quer consultar.

  3. No menu de navegação, clique em Pré-lançamento.

  4. No campo ID do paciente, insira o ID do paciente cujos dados você quer consultar. Os IDs de pacientes diferenciam maiúsculas de minúsculas.

  5. Pressione Enter ou clique em Visualizar para enviar o ID do paciente.

  6. Na barra de pesquisa Pesquisar aqui, digite sua consulta.

    Se você ativou o preenchimento automático, uma lista de sugestões vai aparecer abaixo da barra de pesquisa enquanto você digita.

  7. Pressione Enter para enviar a consulta.

    • Os resultados da pesquisa são exibidos em tabelas paginadas categorizadas com base no tipo de recurso do FHIR.
    • Por padrão, os resultados da pesquisa para todos os tipos de recursos do FHIR são mostrados em ordem cronológica inversa.

  8. Para os recursos "Composition", "DocumentReference" e "DiagnosticReport", clique no filtro Ordenar: cronologia inversa e selecione Relevância na lista. Os resultados desses recursos são ordenados de acordo com a relevância.

REST

Para ordenar os resultados da pesquisa por relevância, modifique sua solicitação search da seguinte maneira:

  • Adicione o campo filter à solicitação para limitar os resultados da pesquisa apenas aos recursos do FHIR que contêm texto não estruturado: Composition, DiagnosticReport e DocumentReference.
  • Adicione o campo orderBy à solicitação de pesquisa e defina o valor como _RELEVANCE para receber respostas classificadas de acordo com a relevância.

  1. Envie a solicitação de pesquisa.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
  -d '{
"query": "KEYWORD_QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_type: ANY(\"Composition\", \"DiagnosticReport\", \"DocumentReference\")",
"orderBy": "_RELEVANCE"
}'

    Substitua:

    • PROJECT_ID: o ID do seu Google Cloud projeto.
    • APP_ID: o ID do app da Vertex AI para Pesquisa que você quer consultar.
    • KEYWORD_QUERY: a palavra-chave que você quer pesquisar nos dados clínicos do paciente filtrado, como "diabetes" ou "a1c".
    • PATIENT_ID: o ID do recurso do paciente cujos dados você quer pesquisar.

    Você vai receber uma resposta JSON com os resultados da pesquisa detalhados listados na ordem de relevância.