Conectar uma origem de dados de terceiros

Esta página descreve como conectar fontes de dados de terceiros Vertex AI para Pesquisa.

Quando você conecta uma fonte de dados de terceiros, a Vertex AI para Pesquisa cria um conector de dados e associa repositórios de dados (chamados entity) com ele para as entidades que você especificar. Os tipos de entidade são específicos da fonte de dados à qual você está se conectando. Por exemplo: As entidades do Jira Cloud incluem problemas, anexos, comentários e registros de trabalho.

As origens de dados de terceiros estão disponíveis apenas para apps de pesquisa genérica. Chat, recomendações, e apps de agentes não podem usar fontes de dados de terceiros.

Os conectores de terceiros não são compatíveis com CMEK.

Para importar dados de uma origem de dados do Google, consulte Criar uma loja de dados de pesquisa.

Antes de começar

  1. Entre em contato com a equipe da sua Conta do Google e peça para ser adicionado à lista de permissões para conectores de fontes de dados de terceiros.

  2. Acesse a seção da fonte que você planeja usar:

Conecte o Confluence Cloud

Use o procedimento a seguir para sincronizar dados do Confluence Cloud com a Pesquisa da Vertex AI.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de configurar a conexão:

  • Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.

  • Tenha as seguintes informações de autenticação:

    • URL da instância. No formulário https://EXAMPLE.atlassian.net, por exemplo, https://google.atlassian.net.

    • ID da instância. Este é o cloudid. Para encontrá-lo, para https://EXAMPLE.atlassian.net/_edge/tenant_info e copiando o valor de cloudId.

  • Ative o OAuth 2.0 e receba o ID e a chave secreta do cliente.

    Use https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html como o URL do callback. Para informações sobre como ativar o OAuth 2.0 para o Confluence Cloud e consiga o ID e a chave secreta do cliente, consulte OAuth 2.0 (3LO) apps na documentação do Atlassian Developer.

  • Ao definir os escopos de permissão do OAuth 2.0, configure os seguintes escopos:

  • Para que as permissões do usuário sejam aplicadas corretamente, cada usuário do Confluence Cloud precisa deixar o e-mail visível para todos os usuários. Para isso, alterar as configurações de visibilidade de e-mail no Confluence Cloud e Defina a visibilidade como Anyone. Para mais informações, consulte Defina a visibilidade do e-mail no documentação da Atlassian.

Console

Para usar o console do Google Cloud e sincronizar dados do Confluence Cloud com a Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Novo repositório de dados.

  4. Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Confluence.

  5. Digite suas informações de autenticação e clique em Autenticar.

  6. Uma nova janela será aberta. Digite o nome de usuário e a senha da instância. Verifique se a autenticação foi bem-sucedida antes de retornar ao botão Especificar a fonte do Confluence do repositório de dados.

  7. Selecione as entidades que você quer sincronizar e clique em Continuar.

  8. Selecione uma região para o conector de dados.

  9. Insira um nome para o conector de dados.

  10. Selecione uma frequência de sincronização.

  11. Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.

  12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O Quando o estado do conector é iniciado, ele muda de Creating para Running. para sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas

Conectar o Jira Cloud

Use o procedimento a seguir para sincronizar dados do Jira Cloud com a Pesquisa da Vertex AI.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de configurar a conexão:

  • Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.

  • Prepare as seguintes informações de autenticação:

    • URL da instância. No formulário https://EXAMPLE.atlassian.net, por exemplo, https://google.atlassian.net.

    • ID da instância. Este é o cloudid. Para encontrá-lo, para https://EXAMPLE.atlassian.net/_edge/tenant_info e copiando o valor de cloudId.

    • Ative o OAuth 2.0 para receber o ID e a chave secreta do cliente.

      Usar https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html como o URL de callback. Para informações sobre como ativar o OAuth 2.0 e obter o ID e a chave secreta do cliente, consulte OAuth 2.0 (3LO) apps na documentação do Atlassian Developer.

  • Ao definir os escopos de permissão do OAuth 2.0, configure os seguintes escopos:

  • A função do usuário mínima exigida é de administrador da organização.

A limitação a seguir se aplica:

  • Para que as permissões do usuário sejam aplicadas corretamente, os usuários do Jira Cloud precisam fornecer consentimento de compartilhamento.

Console

Para usar o console do Google Cloud e sincronizar dados do Jira Cloud com a Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Jira.

  5. Digite suas informações de autenticação e clique em Autenticar.

  6. Uma nova janela será aberta. Digite o nome de usuário e a senha da instância. Verifique se a autenticação foi bem-sucedida antes de retornar ao botão Especificar a fonte do Jira do repositório de dados.

  7. Selecione as entidades a serem sincronizadas e clique em Continuar.

  8. Selecione uma região para o repositório de dados.

  9. Insira um nome para o repositório de dados.

  10. Selecione uma frequência de sincronização.

  11. Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.

  12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O Quando o estado do conector é iniciado, ele muda de Creating para Running. para sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas

Conectar o Salesforce

Use o procedimento a seguir para sincronizar dados do Salesforce com a Vertex AI para Pesquisa.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de configurar a conexão:

A seguinte limitação se aplica:

  • Para sincronizar um usuário como uma entidade, ele precisa dar consentimento para compartilhamento.

Console

Para usar o console do Google Cloud e sincronizar dados do Salesforce com a Vertex AI para Pesquisa, siga estas etapas:

  1. Adicione o Google Cloud à lista de permissões do CORS do Salesforce. Se você já fez passe para a próxima etapa.

    1. Siga as instruções na documentação do Salesforce para configurar a lista de permissões da CORS.

    2. Insira https://console.cloud.google.com/ como um URL de origem e salve a configuração.

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

    Agent Builder.

  3. No menu de navegação, clique em Repositórios de dados.

  4. Clique em Criar armazenamento de dados.

  5. Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Salesforce.

  6. Insira as informações de autenticação do Salesforce.

  7. Selecione as entidades que você quer sincronizar e clique em Continuar.

  8. Selecione uma região para seu repositório de dados.

  9. Insira um nome para o repositório de dados.

  10. Selecione uma frequência de sincronização.

  11. Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.

  12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas

Conectar o ServiceNow

Use o procedimento a seguir para sincronizar dados do ServiceNow com a pesquisa da Vertex AI.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de configurar a conexão:

  • Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso da fonte de dados.

  • Tenha as seguintes informações de autenticação em mãos:

    • URL da instância no formato https://<domain-name>.service-now.com/.
    • ID e chave secreta do cliente. Para mais informações sobre configuração de endpoint e obter o ID e a chave secreta do cliente, consulte Criar um endpoint para o acesso à instância no Documentação do ServiceNow.

    • Nome de usuário e senha para um dos seguintes tipos de papel do ServiceNow:

      • Administrador. Consulte Papéis do sistema base no Documentação do ServiceNow.

      • Um papel personalizado do ServiceNow. Essa é uma alternativa ao uso da administrador do Google Cloud. Para usar um papel personalizado do ServiceNow, crie acesso de controle de acesso com os seguintes campos:

        Para mais informações, consulte Criar uma função e Criar uma regra de ACL na documentação do ServiceNow.

Console

Para usar o console do Google Cloud e sincronizar dados do ServiceNow com a Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione ServiceNow.

  5. Digite suas informações de autenticação do ServiceNow.

  6. Selecione as entidades que você quer sincronizar e clique em Continuar.

  7. Selecione uma região para seu conector de dados.

  8. Insira um nome para o conector de dados.

  9. Selecione uma frequência de sincronização.

  10. Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.

  11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas

Conectar o SharePoint Online

Use o procedimento a seguir para sincronizar dados do Sharepoint Online com o Vertex AI para Pesquisa.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de configurar a conexão:

  • Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso da fonte de dados.

  • A autenticação de dois fatores (2FA) precisa ser desativada para a conta do SharePoint. Só há suporte para a autenticação por senha básica do OAuth2.

  • Dê consentimento de administrador. Para saber como conceder consentimento, consulte Conceder consentimento de administrador em todo o locatário a um aplicativo na documentação da Microsoft.

  • Prepare as seguintes informações de autenticação do SharePoint Online para uso durante a configuração:

    • URL da instância. No formulário http://DOMAIN_OR_SERVER/[sites/]WEBSITE. Para mais informações sobre URLs, consulte URLs e tokens no SharePoint no Documentação do SharePoint.
    • ID do locatário, ID do cliente e chave secreta do cliente. Para registrar o aplicativo, selecione Somente contas neste diretório organizacional para o público-alvo de login e localize essas informações de autenticação. Para mais informações, consulte Guia de início rápido: registrar um aplicativo com o Identity Platform na documentação da Microsoft.
    • Nome de usuário e senha. Elas precisam corresponder a um administrador do site do SharePoint ou a um administrador do conjunto de sites do SharePoint com a 2FA desativada.

  • A tabela a seguir descreve os papéis recomendados para configuração e as limitações deles.

Console

Para usar o console do Google Cloud e sincronizar dados do Sharepoint Online com a Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Sharepoint Online.

  5. Digite suas informações de autenticação do SharePoint Online.

  6. Selecione as entidades a serem sincronizadas e clique em Continuar.

  7. Selecione uma região para seu repositório de dados.

  8. Insira um nome para o repositório de dados.

  9. Selecione uma frequência de sincronização para seu repositório de dados.

  10. Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.

  11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O Quando o estado do conector é iniciado, ele muda de Creating para Running. para sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas

Conecte-se ao Slack

Use o procedimento a seguir para sincronizar dados do Slack com o Vertex AI para Pesquisa.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de configurar a conexão:

  • Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso da fonte de dados.

  • Tenha as seguintes informações de autenticação do Slack:

    • ID do espaço de trabalho. Para saber como encontrar os IDs dos espaços de trabalho, consulte Especificar a fonte do Slack para seu repositório de dados na documentação do Slack.
    • Token de acesso. Para obter informações sobre como criar um aplicativo cliente e definir escopos, consulte o Guia de início rápido e Como implementar e use um token da API Slack na documentação do Slack.
    • Ao definir escopos de permissão do OAuth 2.0, configure os seguintes escopos:

A seguinte limitação se aplica:

  • O comportamento padrão do Slack restringe o rastreamento e a sincronização de conteúdo de canais privados, mensagens instantâneas de várias partes e mensagens instantâneas individuais.

Console

Usar o console do Google Cloud para sincronizar dados do Slack com o Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Slack.

  5. Insira as informações de autenticação do Slack.

  6. Selecione as entidades que você quer sincronizar e clique em Continuar.

  7. Selecione uma região para seu repositório de dados.

  8. Insira um nome para o repositório de dados.

  9. Selecione uma frequência de sincronização para seu repositório de dados.

  10. Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.

  11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O Quando o estado do conector é iniciado, ele muda de Creating para Running. para sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas

Conectar o Dropbox

Use o procedimento a seguir para sincronizar dados do Dropbox com a pesquisa da Vertex AI.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de começar

Antes de configurar a conexão:

  • Configure o controle de acesso para sua fonte de dados. Para mais informações, consulte Usar o controle de acesso à fonte de dados.

  • Tenha as seguintes informações de autenticação do Dropbox prontas. Para informações sobre como configurar esses parâmetros, consulte o Guia do OAuth em na documentação do Dropbox.

    • ID do cliente
    • Chave secreta do cliente

Console

Para usar o console do Google Cloud e sincronizar dados do Dropbox com a Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Dropbox.

  5. Digite suas informações de autenticação do Dropbox e clique em Autenticar. Uma nova janela vai aparecer.

  6. Autentique sua conta e confirme se ela bem-sucedido antes de retornar à página Especificar a origem da caixa de depósito para página do repositório de dados.

  7. Selecione as entidades que você quer sincronizar e clique em Continuar.

  8. Selecione um local para seu repositório de dados.

  9. Insira um nome para o repositório de dados.

  10. Selecione uma frequência de sincronização para seu repositório de dados.

  11. Clique em Criar. A Vertex AI para Pesquisa cria seu repositório de dados e exibe seus repositórios de dados na página Repositórios de dados.

  12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a ingestão é concluída, o estado muda para Ativo para indicar que a conexão com a fonte de dados está configurada e aguardando a próxima sincronização programada. Verifique a guia Documentos para verificar se as entidades foram ingeridas corretamente.

    Dependendo do tamanho dos dados, a ingestão pode demorar minutos ou várias horas.

Próximas etapas

Caixa de conexão

Use o procedimento a seguir para sincronizar dados do Box com o Vertex AI para Pesquisa.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de começar

Antes de configurar a conexão:

  • Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.

  • Tenha as seguintes informações de autenticação do Box. Para informações sobre como configurar esses parâmetros, consulte Autenticação JWT na documentação para desenvolvedores do Box.

    • ID corporativo
    • ID do cliente
    • Chave secreta do cliente
    • ID da chave pública
    • Chave privada
    • Senha longa

  • Ao criar o endpoint JWT, configure os seguintes escopos:

Considere as seguintes limitações:

  • As mudanças incrementais de comentários podem levar mais tempo para sincronizar do que o intervalo de frequência configurado.
  • Se uma pasta que contém uma entidade for copiada ou movida, as mudanças incrementais poderão levar mais tempo para sincronizar do que o intervalo de frequência configurado.

Console

Para usar o console do Google Cloud e sincronizar dados do Box com a Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Box.

  5. Digite suas informações de autenticação.

  6. Selecione as entidades que você quer sincronizar e clique em Continuar.

  7. Selecione uma região para seu repositório de dados.

  8. Insira um nome para o repositório de dados.

  9. Selecione uma frequência de sincronização para seu repositório de dados.

  10. Clique em Criar. A Vertex AI para Pesquisa cria seu repositório de dados e exibe seus repositórios de dados na página Repositórios de dados.

  11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O Quando o estado do conector é iniciado, ele muda de Creating para Running. para sincronizar dados. Quando a ingestão é concluída, o estado muda para Ativo para indicar que a conexão com a fonte de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas

Conectar o OneDrive

Use o procedimento a seguir para sincronizar dados do OneDrive com a pesquisa da Vertex AI.

Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório sincroniza os dados dessa fonte na frequência selecionada durante a configuração.

Antes de começar

Antes de configurar a conexão:

Console

Para usar o console do Google Cloud e sincronizar dados do OneDrive com a Vertex AI para Pesquisa, siga estas etapas:

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

    Agent Builder.

  2. No menu de navegação, clique em Repositórios de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione OneDrive.

  5. Digite suas informações de autenticação do OneDrive.

  6. Selecione as entidades que serão sincronizadas e clique em Continuar.

  7. Selecione uma região para seu repositório de dados.

  8. Insira um nome para o repositório de dados.

  9. Selecione uma frequência de sincronização para seu repositório de dados.

  10. Clique em Criar. A Vertex AI para Pesquisa cria seu repositório de dados e exibe seus repositórios de dados na página Repositórios de dados.

  11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O Quando o estado do conector é iniciado, ele muda de Creating para Running. para sincronizar dados. Quando a ingestão é concluída, o estado muda para Ativo para indicar que a conexão com a fonte de dados está configurada e aguardando a próxima sincronização programada.

    Dependendo do tamanho dos dados, a ingestão pode levar de vários minutos a várias horas.

Próximas etapas