Receber detalhes do repositório de dados e da entidade

Nesta página, explicamos como recuperar detalhes de recursos para repositórios de dados do Gemini Enterprise e as entidades subjacentes usando o console Google Cloud ou a API REST do Discovery Engine.

Ao interagir com repositórios de dados usando APIs, como configurar controles de acesso do IAM no nível do recurso, consultar endpoints de pesquisa ou automatizar pipelines de ingestão, você precisa dos IDs de recursos exclusivos dos repositórios de dados de destino e das entidades subjacentes.

Conceitos de repositório de dados

Para entender como os recursos do repositório de dados são estruturados na API Discovery Engine, considere os seguintes conceitos:

Conceito Descrição
Armazenamento de dados Um contêiner para dados ingeridos do Google ou de fontes de dados de terceiros. Os repositórios de dados independentes pertencem à coleção padrão (default_collection). Para mais informações, consulte Conceitos do Gemini Enterprise e Sobre apps e repositórios de dados.
Coleta de dados Um recurso de agrupamento lógico em um projeto e local do Google Cloud (projects/{project}/locations/{location}/collections/{collection}).

Os repositórios de dados de terceiros com várias entidades (como Jira, Salesforce ou SharePoint Online) criam uma coleção dedicada que representa a instância do repositório de dados.
Entidade de repositório de dados Quando você conecta uma fonte de dados de terceiros que contém vários tipos de entidades (como problemas do Jira, projetos do Jira ou arquivos do SharePoint), o Gemini Enterprise cria automaticamente um repositório de dados filho separado para cada tipo de entidade.

Esses repositórios de dados de entidades residem como recursos filhos em collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

Para mais informações, consulte Dados estruturados para repositórios de dados de terceiros e Introdução aos conectores e repositórios de dados.

Recuperar detalhes do repositório de dados e da entidade

Selecione uma das seguintes opções:

Console

Para recuperar detalhes do repositório de dados e da entidade no console do Google Cloud , siga estas etapas:

  1. No console Google Cloud , acesse a página Gemini Enterprise > Repositórios de dados.

    Acesse a página "Repositório de dados".

  2. Clique no nome do repositório de dados de destino.

  3. Na página de detalhes do repositório de dados, confira o ID do repositório de dados exibido no cabeçalho.

  4. Se o repositório de dados tiver entidades, clique na guia Entidades para conferir a lista de entidades configuradas, nomes de exibição e os IDs correspondentes do repositório de dados de entidades (por exemplo, DataConnector3_entityA e DataConnector3_entityB).

REST

Para recuperar IDs de repositório de dados e de entidades usando a API REST, siga estas etapas:

  1. Listar IDs de coleta do repositório de dados (para repositórios de dados de várias entidades):

    Para repositórios de dados de terceiros com várias entidades (como Jira ou Salesforce), o Gemini Enterprise cria uma coleção dedicada que representa a instância do conector. Chame o endpoint collections list para recuperar os IDs das coleções no seu projeto:

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"

    Substitua:

    • PROJECT_ID: o ID do seu projeto doGoogle Cloud .
    • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
      • us para a multirregião dos EUA
      • eu para a multirregião da UE
      • global para o local global
      Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
    • LOCATION: a multirregião do seu repositório de dados: global, us ou eu.

    A resposta contém a lista de coleções:

    {
  "collections": [
    {
      "name": "projects/123456789/locations/global/collections/DataConnector3",
      "displayName": "Jira Production Data Store"
    }
  ]
}

    Neste exemplo, o ID da coleção é DataConnector3. Use esse ID ao configurar controles de acesso no nível da coleta para a instância do conector.

  2. Liste os IDs de entidade e repositório de dados independente em default_collection:

    No Gemini Enterprise, todos os recursos de repositório de dados, incluindo repositórios independentes e entidades secundárias para conectores de várias entidades, residem em default_collection. Embora um repositório de dados de várias entidades tenha um ID de coleta dedicado (como DataConnector3), os repositórios de dados de entidades secundárias são registrados em default_collection e têm como prefixo o ID do conector.

    Chame o endpoint de lista dataStores em default_collection para localizar os IDs do repositório de dados e da entidade:

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"

    Substitua:

    • PROJECT_ID: o ID do seu projeto doGoogle Cloud .
    • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
      • us para a multirregião dos EUA
      • eu para a multirregião da UE
      • global para o local global
      Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
    • LOCATION: a multirregião do seu repositório de dados: global, us ou eu.

    A resposta contém a lista de armazenamentos de dados:

    {
  "dataStores": [
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA",
      "displayName": "Jira Issues Entity"
    },
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB",
      "displayName": "Jira Projects Entity"
    }
  ]
}

    Neste exemplo, os IDs repositório de dados de entidades são DataConnector3_entityA e DataConnector3_entityB. Use esses IDs ao configurar controles de acesso para todos os repositórios de dados de entidades subjacentes de um repositório de dados de várias entidades usando a API REST.

A seguir