Filtre a pesquisa de cuidados de saúde

Atenção:

• Restrições para cuidados de saúde: enquanto cliente, não pode utilizar, nem permitir que os utilizadores finais utilizem os serviços de IA generativa para fins clínicos (para esclarecimento, a investigação não clínica, o agendamento ou outras tarefas administrativas não estão restritos), como substituto de aconselhamento médico profissional ou de qualquer forma supervisionada por ou que exija autorização ou aprovação de qualquer autoridade regulamentar aplicável. Para mais informações, consulte os Termos Específicos do Serviço.

  Para esclarecer, no que diz respeito à utilização da Pesquisa da Vertex AI para obter e resumir informações médicas existentes, a restrição de utilização para fins clínicos significa a restrição de utilização para fins de diagnóstico ou tratamento direto sem revisão por parte de um profissional licenciado em conformidade com as leis e os regulamentos aplicáveis.

• Os resultados gerados podem nem sempre ser totalmente fiáveis. Devido à natureza dos MDIs e da IA generativa, os resultados podem ter informações incorretas ou tendenciosas (por exemplo, estereótipos ou outro conteúdo prejudicial) e devem ser revistos. Todos os resumos ou respostas devem ser considerados rascunhos e não definitivos.
• A utilização prevista deste produto não é fornecer informações relativas à prevenção, ao diagnóstico ou ao tratamento de doenças. O produto não se destina a responder a perguntas sobre recomendações de diagnóstico ou tratamento. A utilização prevista deste produto é obter e resumir informações médicas existentes fornecidas pelos utilizadores.
• Devido aos dados de teste limitados, este produto pode ou não ser aplicável ao grupo etário de 0 a 18 anos e ao grupo etário de 85 anos ou mais. Por conseguinte, ao rever o resultado gerado, os clientes têm de considerar a representatividade das subpopulações nos respetivos dados de origem.

Quando consulta dados de cuidados de saúde, pode usar filtros para refinar as respostas da pesquisa. Num pedido de pesquisa, pode fornecer filtros para aplicar critérios que incluam ou excluam determinadas respostas de pesquisa.

Por exemplo, quando pesquisa os dados de um único paciente, o corpo do pedido de pesquisa tem de conter a seguinte expressão de filtro que especifica o ID do paciente:

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

Esta página mostra-lhe como definir filtros para a pesquisa de cuidados de saúde.

Antes de começar

Antes de começar, faça o seguinte:

• Crie uma app de pesquisa de cuidados de saúde e um arquivo de dados de pesquisa de cuidados de saúde, e importe dados FHIR R4. Para mais informações, consulte os artigos Crie uma app de pesquisa de cuidados de saúde e Crie um arquivo de dados de pesquisa de cuidados de saúde.
• Reveja a lista de recursos FHIR R4 que a Vertex AI Search suporta como campos indexáveis, pesquisáveis e recuperáveis. Para mais informações, consulte a referência do esquema de dados FHIR R4 de cuidados de saúde.
• Compreenda a sintaxe das expressões de filtro.

Defina filtros

Os filtros são especificados no campo filter no corpo do pedido do método servingConfigs.search.

A definição do filtro segue a sintaxe da expressão de filtro. Na expressão de filtro, o literal pode ser qualquer campo indexável da resposta à consulta de pesquisa. Por exemplo, se a resposta contiver um recurso Observation, o patient_id que o recurso Observation referencia pode ser usado como um literal de filtro.

As secções seguintes mostram alguns exemplos de como criar filtros.

Defina um filtro resource_datetime

Este exemplo mostra como especificar um filtro para uma pesquisa que inclua apenas os recursos que tenham um valor resource_datetime posterior ao valor de data e hora especificado.

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

Substitua o seguinte:

• PROJECT_ID: o ID do seu projeto Google Cloud .
• DATA_STORE_ID: o ID do arquivo de dados do Vertex AI Search.
• QUERY: a consulta de pesquisa.
• PATIENT_ID: o ID do recurso do paciente cujos dados quer pesquisar.
• DATE_TIME_VALUE: o valor do campo resource_datetime que representa uma data e uma hora no formato dateTime do FHIR. Seguem-se alguns exemplos deste campo:
  • Para especificar uma data e uma hora com um fuso horário separado por um separador T: 2022-08-05T01:00:00+00:00
  • Para especificar uma data: 2022-08-05
  • Para especificar um mês: 2022-08
  • Para especificar um ano: 2022

Resposta

Deve receber uma resposta JSON semelhante à seguinte resposta reduzida. A resposta contém resultados da pesquisa detalhados apresentados por ordem cronológica inversa com fragmentos, se estiverem disponíveis. O campo structData contém os dados JSON estruturados do documento.

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

Defina um filtro de tipo de recurso

O exemplo seguinte mostra como criar um filtro que usa um operador AND para filtrar primeiro todos os recursos Composition e, em seguida, filtrar aqueles cuja data seja posterior a uma data e hora especificadas.

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

Defina um filtro de recursos FHIR

Pode usar um filtro para verificar se um recurso FHIR está presente no repositório de dados do Vertex AI Search. Por exemplo, pode pesquisar um recurso DocumentReference que tenha o ID 6112d1ac-c6bd-4755-d689-bfb71d59afc5 através do seguinte filtro.

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