Nesta página, descrevemos como conectar fontes de dados de terceiros à Vertex AI Search.
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 entidade) a ele para as entidades especificadas. 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 fontes de dados de terceiros estão disponíveis apenas para apps de pesquisa genérica. Apps de chat, recomendações e 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:
Conectar 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 de dados sincroniza os dados dessa fonte com a 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. Esse é o
cloudid
e pode ser encontrado emhttps://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 saber como ativar o OAuth 2.0 para o Confluence Cloud e receber o ID e a chave secreta do cliente, consulte Apps OAuth 2.0 (3LO) na documentação para desenvolvedores da Atlassian.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, mude as configurações de visibilidade de e-mail no Confluence Cloud e defina a visibilidade como
Anyone
. Para mais informações, consulte Definir a visibilidade do e-mail na 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 fonte de dados, acesse a seção Origens de terceiros e selecione Confluence.
Insira suas informações de autenticação e clique em Autenticar.
Uma nova janela será aberta. Insira o nome de usuário e a senha da instância. Verifique se a autenticação foi bem-sucedida antes de retornar à página Especificar a origem do Confluence para seu repositório de dados.
Selecione as entidades a serem sincronizadas 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 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 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 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 os dados pela primeira vez, você pode escolher com que frequência o repositório de dados é sincronizado com essa fonte.
Antes de começar
Antes de configurar a conexão:
- Configurar o controle de acesso. Verifique se o controle de acesso está configurado corretamente para a fonte de dados. Essa etapa garante que apenas usuários autorizados possam acessar e gerenciar os dados. Para mais informações, consulte a documentação Usar o controle de acesso à fonte de dados.
- Para que as permissões do usuário sejam aplicadas corretamente, os usuários do Jira Cloud precisam fornecer o consentimento de compartilhamento.
- Verifique se você tem uma conta da Atlassian, uma instância do Jira e um projeto.
- Verifique se você tem acesso de administrador à instância e ao projeto do Jira.
Configurar a autenticação e as permissões no Jira
Usando as instruções nas seções a seguir, verifique se você tem os detalhes de autenticação necessários e acesso de administrador à sua instância do Jira. Crie um ID e uma chave secreta do cliente pelo console de desenvolvedor da Atlassian, configure os escopos necessários do OAuth 2.0 e defina as permissões para os usuários. Por fim, extraia o URL e o ID da instância, configure as funções e faça a autenticação para sincronizar dados entre o Jira Cloud e a Vertex AI para Pesquisa.
Criar um ID e uma chave secreta do cliente
OBSERVAÇÃO:para ativar o OAuth 2.0 e receber o ID e a chave secreta do cliente, consulte Apps OAuth 2.0 (3LO) na documentação para desenvolvedores da Atlassian.
- Faça login em developer.atlassian.com.
- Clique no ícone do perfil no canto superior direito e selecione Console do desenvolvedor.
- Clique em Criar e selecione Integração OAuth 2.0.
- Insira um nome para o app.
- Marque a caixa de seleção "Termos e Condições".
- Clique em Criar.
Você vai encontrar cinco opções: Visão geral, Distribuição, Permissões, Autorização e Configurações. Comece com a autorização:
a. Clique em Autorização.
b. Na tabela Tipo de autorização, selecione Adicionar para OAuth 2.0 (3LO).
No campo URL de chamada de retorno, digite
https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html
e clique em Salvar alterações.OBSERVAÇÃO: se você receber o aviso O app não tem APIs, Adicionar APIs ao seu app., que será abordado na próxima seção.
Selecione Permissões:
a. Acesse a API JIRA, clique em Adicionar e em Configurar.
OBSERVAÇÃO:ao clicar em Adicionar, o botão muda para Configurar.
b. Acesse a guia Escopos clássicos e clique em Editar escopos. Selecione os seguintes escopos:
Confirme se os sete escopos estão selecionados e salve as alterações.
Clique em Distribuição, selecione Editar e faça o seguinte:
- Selecione o botão de opção Compartilhamento primeiro para permitir a edição de outros campos.
- Preencha os campos restantes.
- Selecione Sim quando solicitado:
Does your app store personal data?
Selecione Configurações para copiar o ID do cliente e a chave secreta do cliente.
Recuperar o URL e o ID da instância
Para encontrar o URL da instância:
- Acesse atlassian.net e faça login com sua conta de administrador.
- Selecione o app que você quer sincronizar. Por exemplo, sincronize o primeiro app.
- Encontre o URL da instância, que é o subdomínio na barra de endereço. Ele vai ficar assim:
Assign appropriate permissions
.
Para conseguir o ID da instância:
- Abra uma nova guia, copie o URL da instância e adicione
/_edge/tenant_info
a ele. Por exemplo,https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
. - Acesse o link para encontrar o valor de
cloudId
.cloudId
é o ID da instância.
Configurar permissões e funções
- Faça login em atlassian.com com sua conta de administrador.
- Clique no ícone de menu no canto superior esquerdo ou acesse admin.atlassian.com.
Na página Administrador, clique em Gerenciar usuários e acesse a página Grupos.
Clique em Criar grupo. Digite um nome para o grupo e crie-o.
Na seção Acesso de grupo a produtos da página do novo grupo, clique em Adicionar produtos ao grupo.
Para a Jira, selecione Administrador de acesso do usuário como a função do produto.
Para Administrador do Jira, selecione Administrador de produto como a função do produto e salve as alterações.
Na página Grupos, clique em Adicionar membros do grupo e adicione usuários ou contas que o conector vai autenticar.
Criar um conector do Jira do Cloud
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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione Jira.
Insira suas informações de autenticação e clique em Autenticar.
Uma nova janela será aberta. Insira o nome de usuário e a senha da instância. Verifique se a autenticação foi bem-sucedida antes de retornar à página Especificar a fonte do Jira para seu 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 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 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 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 de dados sincroniza os dados dessa fonte com a 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. Para informações sobre como configurar IDs e segredos de consumidores no Salesforce, consulte Configurar um app conectado para o fluxo de credenciais de cliente OAuth 2.0 na documentação do Salesforce.
- URL da instância
- ID do consumidor
- Segredo do cliente
A limitação a seguir 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 à sua lista de permissões do CORS do Salesforce. Se você já fez isso, pule 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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione Salesforce.
Insira as informações de autenticação do Salesforce.
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 repositório de dados e exibe seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para ver 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 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 ServiceNow
Use o procedimento a seguir para sincronizar dados do ServiceNow com a Vertex AI Search.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a 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 formato
https://<domain-name>.service-now.com/
. - ID e chave secreta do cliente. Para informações sobre a configuração do endpoint e como receber o ID e a chave secreta do cliente, consulte Criar um endpoint para clientes acessarem a instância na documentação do ServiceNow.
Nome de usuário e senha para um dos seguintes tipos de função do ServiceNow:
- Função de administrador. Consulte Papéis do sistema de base na documentação do ServiceNow.
Uma função personalizada do ServiceNow. Essa é uma alternativa ao uso de uma função de administrador. Para usar uma função personalizada do ServiceNow, crie regras 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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione ServiceNow.
Insira as informações de autenticação do ServiceNow.
Selecione as entidades a serem sincronizadas 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 repositório de dados 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 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 SharePoint Online
Use o procedimento a seguir para sincronizar dados do Sharepoint Online com a Pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a 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.
Conceda o consentimento do 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 usar 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 na 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: registre um aplicativo com a plataforma de identidade da Microsoft na documentação da Microsoft.
Ao registrar o aplicativo, use
https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html
como o URL do callback da Web.Ao configurar as permissões do aplicativo, adicione as seguintes permissões da API Graph:
Ao configurar as permissões do aplicativo, adicione as seguintes permissões delegadas para a API REST do Sharepoint:
- 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.
Conectar o Slack
Use o procedimento a seguir para sincronizar dados do Slack com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a 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 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 saber como criar um app cliente e definir escopos, consulte Início rápido e Como conseguir e usar rapidamente um token de API do Slack na documentação do Slack.
- Ao definir os escopos de permissão do OAuth 2.0, configure os seguintes escopos:
A limitação a seguir se aplica:
- O comportamento padrão do Slack restringe o rastreamento e a sincronização de conteúdo de canais particulares, mensagens instantâneas com várias partes e mensagens instantâneas individuais.
Console
Para usar o console do Google Cloud e sincronizar dados do Slack 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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Fontes de terceiros e selecione Slack.
Insira as informações de autenticação do Slack.
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 para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados 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 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 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 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 de dados sincroniza os dados dessa fonte com a 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. Para informações sobre como configurar esses parâmetros, consulte o guia OAuth 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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Fontes de terceiros e selecione Dropbox.
Insira suas informações de autenticação do Dropbox e clique em Autenticar. Uma nova janela vai aparecer.
Autentique sua conta e confirme se ela foi bem-sucedida antes de retornar à página Especificar a origem do Dropbox para o repositório de dados.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione um local para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório 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. Verifique a guia Documentos para verificar se as entidades foram ingeridas corretamente.
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 de apps com controle de acesso de terceiros.
Caixa de conexão
Use o procedimento a seguir para sincronizar dados do Box com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a 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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione Box.
Insira suas informações de autenticação.
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 para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório 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 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.
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 de dados sincroniza os dados dessa fonte com a 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 Guia de início rápido: registre um aplicativo com a plataforma de identidade da Microsoft na documentação da Microsoft.
Especifique escopos de acesso. É necessária uma função de administrador. Para mais informações, consulte Início rápido: configurar um aplicativo cliente para acessar uma API da 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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione OneDrive.
Insira suas informações de autenticação do OneDrive.
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 para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório 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 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.