Crie uma app de pesquisa de cuidados de saúde

Para pesquisar dados clínicos no Vertex AI Search, pode seguir um dos seguintes fluxos de trabalho:

  • Crie um arquivo de dados de cuidados de saúde, importe dados FHIR R4 para o arquivo de dados, associe-o a uma app de pesquisa de cuidados de saúde e consulte os dados clínicos. Para mais informações, consulte o artigo Crie um repositório de dados de cuidados de saúde.
  • Criar uma app de pesquisa de cuidados de saúde, criar um armazenamento de dados de cuidados de saúde e importar dados FHIR R4 para o armazenamento de dados durante o processo de criação da app, e consultar os dados clínicos.

Esta página descreve o segundo método.

Acerca da frequência da Importação de dados

Pode importar dados FHIR R4 para um repositório de dados das seguintes formas:

  • Importação em lote: uma importação única. Os dados são importados para um armazenamento de dados em lotes. Para importações incrementais adicionais, consulte o artigo Atualize os dados de cuidados de saúde.

  • Importação com streaming: uma importação de dados com streaming quase em tempo real. Todas as alterações incrementais na loja FHIR de origem são sincronizadas na loja de dados do Vertex AI Search. O streaming requer um conetor de dados, que é um tipo de arquivo de dados. Para criar um conetor de dados, tem de configurar uma recolha. Um conetor de dados contém uma entidade, que também é uma instância de armazenamento de dados.

    Também pode pausar e retomar o streaming, bem como fazer a sincronização manual sempre que necessário. Para mais informações, consulte o artigo Faça a gestão de um arquivo de dados de pesquisa de cuidados de saúde.

    A taxa de streaming de dados para um determinado Google Cloud projeto depende das seguintes quotas. Se exceder a quota, pode sofrer atrasos no streaming.

    • O número de escritas de streaming pendentes do FHIR ou do BigQuery por minuto. Para mais informações, consulte o artigo Quotas e limites.
    • O número de operações de leitura de FHIR por minuto por região. Para mais informações, consulte as quotas da API Cloud Healthcare FHIR.

Pode selecionar a frequência da Importação de dados no momento da criação do arquivo de dados e não pode alterar esta configuração posteriormente.

Antes de começar

Antes de criar a app de pesquisa de cuidados de saúde, compreenda o seguinte:

  • A relação entre as apps e os arquivos de dados para a pesquisa de cuidados de saúde. Para mais informações, consulte o artigo Acerca das apps e das lojas de dados.

  • A preparação dos seus dados FHIR para carregamento.

  • O Vertex AI Search for healthcare fornece serviços de pesquisa apenas na multirregião dos EUA (us). Por conseguinte, a sua app de pesquisa de cuidados de saúde e os repositórios de dados têm de residir na multirregião us.

  • Se estiver a importar dados de cuidados de saúde de uma loja FHIR da Cloud Healthcare API num Google Cloud projeto para uma loja de dados do Vertex AI Search num Google Cloud projeto diferente e estiver a usar os VPC Service Controls, os dois projetos têm de estar no mesmo perímetro.

Crie uma app

Pode criar uma app de pesquisa de cuidados de saúde na Google Cloud consola ou através da API. Para criar uma app de pesquisa de cuidados de saúde, siga estes passos:

Consola

  1. Na Google Cloud consola, aceda à página Aplicações de IA.

    Aplicações de IA

  2. Na página Apps, clique em Nova app.

  3. Na página Criar app, em Pesquisa de cuidados de saúde, clique em Criar.

  4. No painel Configuração da app de pesquisa, selecione Cuidados de saúde.

  5. Para ativar as funcionalidades avançadas de MDG para esta app, clique no botão Funcionalidades avançadas de MDG.

    Ative as funcionalidades avançadas de MDIs/CEs para receber resumos de pesquisa, que são breves resumos dos principais resultados da pesquisa.

    Quando ativa as funcionalidades de MDI/CE, pode demorar até cinco minutos para que as funcionalidades suportadas fiquem disponíveis.

  6. No campo Nome da sua app, introduza um nome para a app.

  7. No campo Nome externo da sua empresa ou organização, introduza o nome comum da sua empresa ou organização. Não tem de incluir sufixos, como Inc ou LLC. Este campo é útil para o MDG identificar a empresa que a app representa.

  8. Na secção Transparência de acesso, selecione Desativar métricas de pesquisa para esta app para desativar as métricas de registo da app atual. Esta opção não pode ser alterada depois de a app ser criada.

  9. Clique em Continuar.

  10. Para estabelecer ligação a um arquivo de dados, na página Arquivos de dados, faça uma das seguintes ações:

    • Selecione um arquivo de dados de cuidados de saúde existente para a importação em lote ou um conetor de dados existente para a importação por streaming. Para criar um repositório de dados ou um conetor de dados antes de criar uma app, consulte o artigo Crie um repositório de dados de saúde.
    • Crie um arquivo de dados (para importação em lote única) ou um conector de dados, que é uma instância de um arquivo de dados (para importação por streaming):
      1. Clique em Criar arquivo de dados.
      2. No painel Selecione uma origem de dados, selecione API Healthcare (FHIR) como origem de dados.
      3. Para importar dados da sua loja FHIR, faça uma das seguintes ações:
        • Selecione a loja FHIR na lista de lojas FHIR disponíveis:
          1. Expanda o campo FHIR store.
          2. Nesta lista, selecione um conjunto de dados que esteja numa localização permitida e, de seguida, selecione um armazenamento FHIR que use a versão R4 do FHIR.
        • Introduza a loja FHIR manualmente:
          1. Expanda o campo FHIR store.
          2. Clique em Introduzir loja FHIR manualmente.
          3. Na caixa de diálogo Nome da loja FHIR, introduza o nome completo da loja FHIR no seguinte formato:

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. Clique em Guardar.
      4. Na secção Sincronização, selecione uma das seguintes opções. Não é possível alterar esta seleção após a criação do arquivo de dados.
        • Uma vez: para fazer uma importação de dados em lote única. Para mais importações incrementais, consulte o artigo Atualize os dados de cuidados de saúde.
        • Streaming: para fazer uma importação de dados de streaming em tempo quase real. Para transmitir dados, tem de criar um conetor de dados, que é um tipo de armazenamento de dados. Para configurar um arquivo de dados de streaming com a API REST, contacte o seu engenheiro de clientes.
      5. Na secção Qual é o esquema destes dados?, selecione uma destas opções:
        • Esquema predefinido da Google: para reter as configurações do esquema definido pela Google, como a capacidade de indexação, a capacidade de pesquisa e a capacidade de obtenção, para os recursos e os elementos FHIR suportados. Depois de selecionar esta opção, não pode atualizar o esquema depois de criar o repositório de dados. Se quiser poder alterar o esquema após a criação do repositório de dados, selecione a opção Esquema personalizado.
          1. Clique em Continuar.
          2. No campo Nome da sua loja de dados, introduza um nome para a loja de dados.
          3. Clique em Criar.

            4. O arquivo de dados que criou é apresentado na página Arquivos de dados.

        • Esquema personalizado: para definir as suas próprias configurações de esquema, como a capacidade de indexação, a capacidade de pesquisa e a capacidade de obtenção, para os recursos e elementos FHIR suportados. Para configurar um esquema configurável, contacte o seu engenheiro de clientes.
          1. Clique em Continuar.
          2. Reveja o esquema, expanda cada campo e edite as definições dos campos.
          3. Clique em Adicionar novos campos para adicionar novos campos aos recursos FHIR suportados. Não pode remover os campos fornecidos no esquema definido pela Google.
          4. Clique em Continuar.
          5. No campo Nome do conetor de dados, introduza um nome para o conetor de dados.
          6. Clique em Criar.

            7. O conetor de dados que criou é apresentado na página Armazenamentos de dados. O FHIR store de origem é adicionado como uma entidade no conetor de dados.

      6. Clique em Continuar.
      7. Selecione o conetor de dados ou o arquivo de dados criado.

  11. Opcional: para ver uma lista de arquivos de dados indisponíveis, clique em Saiba porquê.

    É apresentada uma tabela com uma lista de armazenamentos de dados e o motivo pelo qual estão indisponíveis. Seguem-se alguns dos motivos pelos quais um repositório de dados pode estar indisponível:

    • O tipo de armazenamento de dados permite a ligação a apenas uma app e o armazenamento de dados já está ligado.
    • A sua loja de dados e a sua app são de tipos diferentes. Por exemplo, não pode associar um arquivo de dados de pesquisa de Websites a uma app de pesquisa de cuidados de saúde.

  12. Clique em Criar.

    Se a app e o respetivo repositório de dados forem criados com êxito, a página de detalhes do repositório de dados apresenta os detalhes dos dados FHIR importados.

REST

  1. Crie um arquivo de dados de saúde e importe dados de saúde para o mesmo.

  2. Crie uma app de pesquisa de cuidados de saúde e associe-a a um repositório de dados. Uma app de pesquisa de cuidados de saúde só pode estabelecer ligação a um repositório de dados, enquanto um determinado repositório de dados pode ser associado a várias apps.

    curl -X POST\
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
"https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines?engineId=APP_ID" \
 -d '{
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds":"DATA_STORE_ID",
    "industryVertical": "HEALTHCARE_FHIR",
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": ["SEARCH_ADD_ON"]
    }
}'

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • APP_ID: o ID da app do Vertex AI Search que quer criar.
    • APP_DISPLAY_NAME: o nome a apresentar da app Vertex AI Search que quer criar.
    • DATA_STORE_ID: o ID de um arquivo de dados do Vertex AI Search existente que quer adicionar à app Vertex AI Search.
    • SEARCH_ADD_ON: um campo opcional para especificar se quer as funcionalidades avançadas de GMLs, como pesquisar com respostas de IA generativa, para esta app. Para ativar as funcionalidades avançadas de GMLs, introduza o valor SEARCH_ADD_ON_LLM. Se não quiser funcionalidades de MDG avançadas, especifique SEARCH_ADD_ON_UNSPECIFIED ou remova o campo searchAddOns. Para mais informações, consulte o artigo Funcionalidades avançadas de MDIs.

Valide a criação da app

Esta tarefa mostra como verificar se uma app de pesquisa de cuidados de saúde foi criada com êxito e se os dados FHIR foram importados para o repositório de dados com êxito.

  • Na Google Cloud consola: selecione a app e verifique os respetivos detalhes.
  • Através da API REST, use o método engines.get para obter os detalhes da loja de dados de cuidados de saúde.

Para validar a criação do arquivo de dados e a importação de dados, conclua os seguintes passos.

Consola

  1. Na Google Cloud consola, aceda à página Aplicações de IA.

    Aplicações de IA

  2. Na página Apps, verifique se a app que criou está na lista de apps.

  3. Verifique se o armazenamento de dados que associou à app está listado na tabela Armazenamentos de dados associados.

  4. Selecione o arquivo de dados e valide os detalhes do arquivo de dados.

REST

  1. Valide a criação da app.

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
 "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • APP_ID: o ID da app Vertex AI Search.

  2. Verifique a criação do repositório de dados e a importação de dados FHIR.

O que se segue?