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
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.
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, parahttps://EXAMPLE.atlassian.net/_edge/tenant_info
e copiando o valor decloudId
.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Novo repositório de dados.
Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Confluence.
Digite suas informações de autenticação e clique em Autenticar.
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.
Selecione as entidades que você quer sincronizar e clique em Continuar.
Selecione uma região para o conector de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.
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
Para anexar o repositório de dados a um app, crie um app e selecione o repositório de dados seguindo as etapas em Criar um app de pesquisa.
Consulte Visualizar resultados de apps com controle de acesso de terceiros.
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, parahttps://EXAMPLE.atlassian.net/_edge/tenant_info
e copiando o valor decloudId
.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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Criar armazenamento de dados.
Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Jira.
Digite suas informações de autenticação e clique em Autenticar.
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.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.
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
Para anexar o repositório de dados a um app, crie um app e selecione o repositório de dados seguindo as etapas em Criar um app de pesquisa.
Consulte Visualizar resultados de apps com controle de acesso de terceiros.
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:
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 prontas. Para informações sobre configurar IDs de consumidores e secrets no Salesforce, consulte Configurar um App para as credenciais do cliente OAuth 2.0 Fluxo na documentação do Salesforce.
- URL da instância
- ID do consumidor
- Segredo do cliente
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:
Adicione o Google Cloud à lista de permissões do CORS do Salesforce. Se você já fez passe para a próxima etapa.
Siga as instruções na documentação do Salesforce para configurar a lista de permissões da CORS.
Insira
https://console.cloud.google.com/
como um URL de origem e salve a configuração.
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Criar armazenamento de dados.
Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Salesforce.
Insira as informações de autenticação do Salesforce.
Selecione as entidades que você quer sincronizar e clique em Continuar.
Selecione uma região para seu repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.
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
Para anexar seu repositório de dados a um app, crie um app e selecione o repositório seguindo as etapas Crie um app de pesquisa.
Consulte Visualizar resultados de apps com controle de acesso de terceiros.
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.
- URL da instância no formato
Console
Para usar o console do Google Cloud e sincronizar dados do ServiceNow com a Vertex AI para Pesquisa, siga estas etapas:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Criar armazenamento de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione ServiceNow.
Digite suas informações de autenticação do ServiceNow.
Selecione as entidades que você quer sincronizar e clique em Continuar.
Selecione uma região para seu conector de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.
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
Para anexar seu repositório de dados a um app, crie um app e selecione o repositório seguindo as etapas Crie um app de pesquisa.
Consulte Visualizar resultados de apps com controle de acesso de terceiros.
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.
- URL da instância. No formulário
A tabela a seguir descreve os papéis recomendados para configuração e as limitações deles.
Próximas etapas
Para anexar o repositório de dados a um app, crie um app e selecione o repositório de dados seguindo as etapas em Criar um app de pesquisa.
Consulte Visualizar resultados de apps com controle de acesso de terceiros.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Criar armazenamento de dados.
Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Slack.
Insira as informações de autenticação do Slack.
Selecione as entidades que você quer sincronizar e clique em Continuar.
Selecione uma região para seu repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para seu repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa cria e mostra seus repositórios de dados na página Repositórios de dados.
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
Para anexar o repositório de dados a um app, crie um app e selecione o repositório de dados seguindo as etapas em Criar um app de pesquisa.
Consulte Visualizar resultados de apps com acesso de terceiros controle.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Criar armazenamento de dados.
Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Dropbox.
Digite suas informações de autenticação do Dropbox e clique em Autenticar. Uma nova janela vai aparecer.
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.
Selecione as entidades que você quer sincronizar e clique em Continuar.
Selecione um local para seu repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para seu repositório de dados.
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.
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
Para anexar o repositório de dados a um app, crie um app e selecione o repositório de dados seguindo as etapas em Criar um app de pesquisa.
Para conferir como os resultados da pesquisa aparecem depois que o app e o repositório de dados são configurados, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Visualizar resultados de apps com controle de acesso de terceiros.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Criar armazenamento de dados.
Na página Selecionar uma origem de dados, acesse Origens de terceiros e selecione Box.
Digite suas informações de autenticação.
Selecione as entidades que você quer sincronizar e clique em Continuar.
Selecione uma região para seu repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para seu repositório de dados.
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.
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
Para anexar seu repositório de dados a um app, crie um app e selecione o repositório seguindo as etapas Crie um app de pesquisa.
Para conferir como os resultados da pesquisa vão aparecer depois que o app e o repositório de dados forem configurar, consulte Ver resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Visualizar resultados para apps com o controle de acesso.
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:
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 OneDrive:
ID do cliente, chave secreta do cliente e ID do locatário. Para informações sobre como configurar esses parâmetros, consulte o Guia de início rápido: registrar um aplicativo com o Plataforma de identidade da Microsoft no Microsoft na documentação do Google Cloud.
Especifique escopos de acesso. É necessário ter uma função de administrador. Para mais informações, consulte Guia de início rápido: configurar um aplicativo cliente para acessar um API web na documentação da Microsoft.
Configure os seguintes escopos:
Console
Para usar o console do Google Cloud e sincronizar dados do OneDrive com a Vertex AI para Pesquisa, siga estas etapas:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em Criar armazenamento de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione OneDrive.
Digite suas informações de autenticação do OneDrive.
Selecione as entidades que serão sincronizadas e clique em Continuar.
Selecione uma região para seu repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para seu repositório de dados.
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.
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
Para anexar o repositório de dados a um app, crie um app e selecione o repositório de dados seguindo as etapas em Criar um app de pesquisa.
Para conferir como os resultados da pesquisa aparecem depois que o app e o repositório de dados são configurados, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Visualizar resultados para apps com o controle de acesso.