Criar um app de pesquisa de saúde

Para pesquisar dados clínicos na Vertex AI para Pesquisa, siga um dos estes fluxos de trabalho:

  • Criar um repositório de dados de saúde, importar os dados do FHIR R4 para o repositório de dados conectá-lo a um app de pesquisa da área da saúde e consultar os dados clínicos. Para mais informações, consulte Criar um repositório de dados de saúde.
  • Criar um aplicativo de pesquisa de saúde, criar um repositório de dados de saúde e importar dados FHIR R4 para no repositório de dados durante o processo de criação do aplicativo e consultar os dados clínicos.

Nesta página, descrevemos o segundo método.

Sobre a frequência de importação de dados

É possível importar dados FHIR R4 para um repositório de dados das seguintes maneiras:

  • Importação em lote: uma importação única. Os dados são importados para um repositório de dados. Para outras importações incrementais, consulte Atualizar dados de saúde.

  • Importação de streaming (pré-lançamento): uma importação de dados de streaming quase em tempo real. Qualquer um alterações incrementais no repositório FHIR de origem são sincronizadas no repositório de dados da Vertex AI para Pesquisa. O streaming requer um conector de dados, que é um tipo de repositório de dados que contém uma entidade. Uma entidade também é uma instância do repositório de dados.

    A taxa de streaming de dados de um determinado projeto do Google Cloud depende das cotas a seguir. Se você exceder a cota, poderá ocorrer atrasos no streaming.

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

É possível selecionar a frequência de importação de dados ao criar o repositório de dados e não será possível alterar a configuração depois.

A importação de streaming está disponível para todos os recursos compatíveis com a Vertex AI para Pesquisa. Para mais informações, consulte a referência do esquema de dados FHIR R4 do Healthcare.

Antes de começar

Antes de criar o app de pesquisa de saúde, atenda a estes requisitos:

  • Entenda a relação entre apps e repositórios de dados para a pesquisa de saúde. Para mais informações, consulte Sobre apps e repositórios de dados.

  • Prepare seus dados FHIR para transferência.

  • A Vertex AI para Pesquisa para saúde oferece serviços de pesquisa apenas na Multirregião EUA (us). Portanto, o app de pesquisa de saúde e os repositórios de dados precisam residir na multirregião us.

Criar um app

É possível criar um app de pesquisa de saúde no console do Google Cloud ou usando o API. As duas abordagens diferem da seguinte maneira:

  • No console do Google Cloud: selecione o armazenamento FHIR de origem na API Cloud Healthcare e importe dados FHIR como parte do processo de criação do app de pesquisa de saúde. Para fazer streaming de dados FHIR (pré-lançamento), seu armazenamento FHIR de origem precisa estar no mesmo projeto do Google Cloud que o destino App Vertex AI para Pesquisa.
  • Por meio da API REST: é possível importar dados de FHIR de um armazenamento FHIR da API Cloud Healthcare. A loja FHIR pode estar no mesmo projeto do Google Cloud ou em outro.
    1. Use o dataStores.create método para criar um repositório de dados de saúde.
    2. Use o método documents.import para especificar o armazenamento FHIR na API Cloud Healthcare e importar dados FHIR.
    3. Use o método engines.create para criar o app de pesquisa de saúde e especificar um repositório de dados de saúde.

Para criar um app de pesquisa de saúde, siga estas etapas:

Console

  1. No Console do Google Cloud, acesse a página Criador de agentes.

    Agent Builder.

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

  3. Na página Criar app, selecione Procurar.

  4. No painel Configuração do app de pesquisa, selecione Saúde.

  5. Para ativar os recursos avançados de LLM para este app, clique em LLM avançado de recursos.

    Ative os recursos avançados do LLM para receber resumos de pesquisa, que são curtos resumos de um ou mais resultados de pesquisa principais.

    Quando você ativa os recursos do LLM, pode levar até cinco minutos para que os recursos com suporte sejam disponibilizados.

  6. No campo Nome do app, insira um nome para seu app.

  7. No campo Nome externo da sua empresa ou organização, insira o nome comum da empresa ou organização. Não é necessário incluir sufixos como Inc ou LLC. Esse campo é útil para que o LLM identifique a empresa que o app representa.

  8. Clique em Continuar.

  9. Para se conectar a um repositório de dados, na página Repositórios de dados, faça o seguinte:

    • Selecione um repositório de dados de saúde para importação em lote ou conector de dados atual para importação de streaming. Para criar um repositório de dados conector de dados antes de criar um aplicativo, consulte Criar um repositório de dados de saúde.
    • Crie um repositório de dados (para uma importação em lote única) ou um conector de dados, que é uma instância de um repositório de dados (para importação por streaming):
      1. Clique em Criar repositório de dados.
      2. No painel Selecionar uma fonte de dados, escolha API Healthcare (FHIR) como sua fonte de dados.
      3. Para importar dados do armazenamento FHIR, faça o seguinte:
        • Selecione o armazenamento de FHIR na lista de opções disponíveis:
          1. Abra o campo Armazenamento FHIR.
          2. Nessa lista, selecione um conjunto de dados que esteja em um local permitido e, em seguida, selecione um armazenamento de FHIR que use a versão R4.

            Para transmitir dados FHIR (pré-lançamento), a loja de FHIR de origem precisa estar no mesmo projeto do Google Cloud que a loja de dados de destino Vertex AI para Pesquisa.

        • Insira o armazenamento FHIR manualmente:
          1. Abra o campo Armazenamento FHIR.
          2. Clique em Inserir armazenamento FHIR manualmente.
          3. Na caixa de diálogo Nome da loja FHIR, insira o nome completo da loja FHIR no seguinte formato:

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

          4. Clique em Salvar.
      4. Na seção Sincronização, selecione uma das opções a seguir. Essa seleção não pode ser alterada depois que o repositório de dados é criado.
        • Uma vez: para executar uma importação única de dados em lote. Para mais importações incrementais, consulte Atualizar dados de saúde.
        • Streaming: para realizar uma importação de dados de streaming quase em tempo real. Para dados de stream, é preciso criar um conector de dados, que é um tipo de repositório de dados. Este é um recurso em fase de pré-lançamento. Para configurar um repositório de dados de streaming usando a API REST, entre em contato com seu engenheiro de clientes.
      5. Na seção What is the schema for this data?, selecione uma das estas opções:
        • Esquema predefinido do Google: para manter as configurações de esquema definidas pelo Google, como capacidade de indexação, pesquisa e recuperação, para os recursos e elementos do FHIR com suporte. Depois de selecionar essa opção, não será possível atualizar o esquema após a criação do repositório de dados. Se você quiser ser conseguir alterar o esquema após a criação do repositório de dados, selecione o Opção Esquema personalizado (pré-lançamento).
          1. Clique em Continuar.
          2. No campo Nome do repositório de dados, insira um nome para o repositório de dados.
          3. Clique em Criar.

            4. O repositório de dados que você criou é listado na página Repositórios de dados.

        • Esquema personalizado (pré-lançamento): para definir suas próprias configurações de esquema, como capacidade de indexação, pesquisabilidade e recuperação, para os recursos e elementos do FHIR compatíveis. Este é um recurso em fase de pré-lançamento. Para definir um elemento configurável esquema, entre em contato com seu engenheiro de clientes.
          1. Clique em Continuar.
          2. Revise o esquema, expanda cada campo e edite as configurações.
          3. Clique em Adicionar novos campos para adicionar novos campos na recursos FHIR suportados. Não é possível remover os campos fornecidos no esquema definido pelo Google.
          4. Clique em Continuar.
          5. No campo Nome do conector de dados, insira um nome para ele.
          6. Clique em Criar.

            7. O conector de dados criado é listado na página Repositórios de dados. O repositório FHIR de origem é adicionado como uma entidade nos dados. conector.

      6. Clique em Continuar.
      7. Selecione o repositório de dados ou o conector de dados criado.

  10. Opcional: para conferir uma lista dos repositórios de dados indisponíveis, clique em Saiba o motivo.

    Uma tabela é exibida com uma lista de repositórios de dados e a razão pela qual eles são indisponível. Estes são alguns dos motivos pelos quais um repositório de dados pode ser indisponível:

    • O tipo de repositório de dados permite a conexão com apenas um app, e o repositório já está conectado.
    • O repositório de dados e o app são de tipos diferentes. Por exemplo, não é possível conectar um repositório de dados de pesquisa em sites a uma pesquisa de saúde app.

  11. Clique em Criar.

    Se o app e o repositório de dados forem criados, a página de detalhes do repositório de dados vai mostrar os detalhes dos dados FHIR importados.

REST

  1. Crie um repositório de dados de saúde e importe dados de saúde para ele.

  2. Crie um app de pesquisa de saúde e conecte-o a um repositório de dados. Um app de pesquisa de saúde só pode conectar a um repositório de dados, enquanto um determinado repositório de dados pode ser conectado ao vários aplicativos.

    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/v1alpha/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:

    • PROJECT_ID: o ID do seu projeto do Google Cloud.
    • APP_ID: o ID do app da Vertex AI para Pesquisa que você quer criar.
    • APP_DISPLAY_NAME: o nome de exibição do app Vertex AI para Pesquisa que você quer criar.
    • DATA_STORE_ID: o ID de um repositório de dados da Vertex AI para Pesquisa. que você quer adicionar ao app Vertex AI para Pesquisa.
    • SEARCH_ADD_ON: um campo opcional para especificar se você quer os recursos avançados do LLM, como a pesquisa com respostas de IA generativa, para esse app. Para ativar os recursos avançados do LLM, insira o valor SEARCH_ADD_ON_LLM. Se não quiser recursos avançados de LLM, especifique SEARCH_ADD_ON_UNSPECIFIED ou remova o searchAddOns. Para mais informações, consulte Recursos avançados do LLM.

Verificar a criação do app

Esta tarefa mostra como verificar se um app de pesquisa de saúde foi criado e se os dados FHIR foram importados para o repositório de dados.

  • No console do Google Cloud: selecione o app e verifique os detalhes.
  • Usando a API REST, use o método engines.get para conferir os detalhes do armazenamento de dados de saúde.

Para verificar a criação do repositório de dados e a importação de dados, conclua as etapas a seguir.

Console

  1. No Console do Google Cloud, acesse a página Criador de agentes.

    Agent Builder.

  2. Na página Apps, verifique se o app que você criou está nos apps lista.

  3. Verifique se o repositório de dados que você conectou ao app está listado na coluna Repositórios de dados conectados.

  4. Selecione o repositório de dados e verificar os detalhes do repositório de dados.

REST

  1. Verifique a criação do 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/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Substitua:

    • PROJECT_ID: o ID do seu projeto do Google Cloud.
    • APP_ID: o ID do app Vertex AI para Pesquisa.

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

A seguir