Filtrar pesquisa de serviços de saúde

Cuidado:

• Restrições para a área da saúde: como cliente, você não pode usar os Serviços de IA generativa para fins clínicos (para fins de esclarecimento, pesquisas não clínicas, agendamento ou outras tarefas administrativas não são restritas), como substituto de orientação médica profissional ou de qualquer maneira que seja supervisionada ou exija autorização ou aprovação de qualquer autoridade reguladora aplicável. Para mais informações, consulte os Termos específicos do serviço.

  Para fins de esclarecimento, no que diz respeito ao uso da Pesquisa da Vertex AI para recuperar e resumir informações médicas, a restrição de uso para fins clínicos significa a restrição de uso para fins de diagnóstico ou tratamento direto sem revisão por um profissional licenciado em conformidade com as leis e regulamentações aplicáveis.

• A saída gerada nem sempre é totalmente confiável. Devido à natureza dos LLMs e da IA generativa, as saídas podem ter informações incorretas ou tendenciosas (por exemplo, estereótipos ou outros conteúdos nocivos) e precisam ser revisadas. Todos os resumos ou respostas devem ser considerados rascunho e não resultados finais.
• O uso pretendido deste produto não é fornecer informações relacionadas à prevenção, diagnóstico ou tratamento de doenças. O produto não foi criado para responder a perguntas sobre recomendações de diagnóstico ou tratamento. O uso pretendido deste produto é recuperar e resumir informações médicas fornecidas pelos usuários.
• Devido à limitação dos dados de teste, este produto pode ou não ser aplicável à faixa etária de 0 a 18 anos e à faixa etária de 85 anos ou mais. Portanto, ao analisar a saída gerada, os clientes precisam considerar a representatividade das subpopulações nos dados de origem.

Ao consultar dados de saúde, você pode usar filtros para refinar as respostas da pesquisa. Em uma solicitação de pesquisa, é possível fornecer filtros para aplicar critérios que incluem ou excluem determinadas respostas de pesquisa.

Por exemplo, ao pesquisar os dados de um único paciente, o corpo da solicitação de pesquisa precisa conter a seguinte expressão de filtro que especifica o ID do paciente:

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

Nesta página, mostramos como definir filtros para a pesquisa de saúde.

Antes de começar

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

• Crie um app e um repositório de dados de pesquisa de saúde e importe dados FHIR R4. Para mais informações, consulte Criar um app de pesquisa de saúde e Criar um repositório de dados de pesquisa de saúde.
• Confira a lista de recursos do FHIR R4 que a Vertex AI para Pesquisa aceita como campos indexáveis, pesquisáveis e recuperáveis. Para mais informações, consulte Referência do esquema de dados R4 do FHIR de saúde.
• Entenda a sintaxe da expressão de filtro.

Definir filtros

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

A definição de 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 referenciado por ele poderá ser usado como um literal de filtro.

As seções a seguir mostram alguns exemplos de como criar filtros.

Definir um filtro resource_datetime

Este exemplo mostra como especificar um filtro para uma pesquisa que inclui apenas os recursos com um valor resource_datetime posterior à data e hora especificadas.

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:

• PROJECT_ID: o ID do seu projeto Google Cloud .
• DATA_STORE_ID: o ID do repositório de dados da Vertex AI para Pesquisa.
• QUERY: a consulta de pesquisa.
• PATIENT_ID: o ID do recurso do paciente cujos dados você quer pesquisar.
• DATE_TIME_VALUE: o valor do campo resource_datetime que representa uma data e hora no formato dateTime do FHIR. Confira alguns exemplos desse campo:
  • Para especificar uma data e 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

Você vai receber uma resposta JSON semelhante a esta, que está truncada. A resposta contém resultados da pesquisa detalhados listados em ordem cronológica inversa com snippets, se 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"
            }
            ]
        }
        }
    }]
}

Definir um filtro de tipo de recurso

O exemplo a seguir mostra como criar um filtro que usa um operador AND para primeiro filtrar todos os recursos de composição e depois aqueles cuja data é posterior a uma data e hora especificadas.

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

Definir um filtro de recursos FHIR

É possível usar um filtro para verificar se um recurso FHIR está presente no repositório de dados da Vertex AI para Pesquisa. Por exemplo, é possível pesquisar um recurso DocumentReference que tenha o ID 6112d1ac-c6bd-4755-d689-bfb71d59afc5 usando o filtro a seguir.

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