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. Entidade são específicos à 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 de Contas 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 os dados do Confluence Cloud 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 sua 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 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 Definir a visibilidade do e-mail na documentação da Atlassian.
Console
Usar o console do Google Cloud para sincronizar dados do Confluence Cloud 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 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 ao botão Especificar a fonte do Confluence do repositório de dados.
Selecione as entidades a serem sincronizadas 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 do seu processamento, acesse a página Repositórios de dados e Clique no nome do repositório de dados para ver detalhes sobre ele 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 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.
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 o Vertex AI para Pesquisa.
Depois de configurar a fonte de dados e importar os dados pela primeira vez, você pode escolher a frequência com que o repositório de dados é sincronizado com essa fonte.
Antes de começar
Antes de configurar sua conexão:
- Configurar o controle de acesso. Verifique se o controle de acesso está configurado corretamente para sua 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 dar consentimento para compartilhamento.
- Verifique se você tem uma conta 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 o acesso de administrador à sua instância do Jira. Crie um ID e uma chave secreta do cliente pelo console do desenvolvedor da Atlassian, configure os escopos necessários do OAuth 2.0 e defina as permissões para os usuários. Por fim, recupere o URL e o ID da instância, configure papéis e autentique para sincronizar dados entre o Jira Cloud e a Vertex AI para Pesquisa.
Criar ID e chave secreta do cliente
OBSERVAÇÃO: para ativar o OAuth 2.0 e obter o ID e a chave secreta do cliente, consulte OAuth 2.0 (3LO) na documentação do Atlassian Developer.
- 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 Seu 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: quando você clica 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 que 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 outros campos.
- Selecione Sim para a pergunta:
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 será semelhante a este:
Assign appropriate permissions
.
Para conseguir o ID da instância:
- Abra uma nova guia, copie o URL da instância e anexe
/_edge/tenant_info
a ele. Por exemplo,https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
. - Navegue até o link para encontrar o valor
cloudId
.cloudId
é o ID da instância.
Configurar permissões e papéis
- 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 ao produto do grupo na página do novo grupo, clique em Adicionar produtos ao grupo.
Em Jira, selecione Administrador de acesso do usuário como a função do produto.
Em Jira Admin, selecione Product Admin 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
Usar o console do Google Cloud para sincronizar dados do Jira Cloud 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 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á exibida. 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 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 do seu processamento, acesse a página Repositórios de dados e Clique no nome do repositório de dados para ver detalhes sobre ele 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 demorar minutos ou 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 acesso de terceiros controle.
Conectar o Salesforce
Use o procedimento a seguir para sincronizar dados do Salesforce 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 sua 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. 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 limitação a seguir se aplica:
- Para sincronizar um usuário como uma entidade, ele precisa dar consentimento de 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 configure a lista de permissões do 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 origem de dados, acesse Origens de terceiros e selecione Salesforce.
Insira suas informações de autenticação do Salesforce.
Selecione as entidades que você quer sincronizar 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 conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório 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 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.
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 sincroniza os dados dessa fonte na frequência selecionada durante a configuração.
Antes de configurar sua 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 na forma de
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 papel do ServiceNow:
- Administrador. Consulte Papéis do sistema de base na documentação do ServiceNow.
Um papel personalizado do ServiceNow. Essa é uma alternativa ao uso da administrador do Google Cloud. 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 Crie uma regra de ACL na documentação do ServiceNow.
- URL da instância na forma de
Console
Para usar o console do Google Cloud para sincronizar dados do ServiceNow para 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 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 Creating para Running quando ele começa a sincronizar os 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 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.
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 sua 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.
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.
Conceda o consentimento do administrador. Para mais informações sobre como dar 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 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.
- Nome de usuário e senha. Precisam corresponder a um site do SharePoint Administrador ou administrador de conjunto de sites do SharePoint com a autenticação de dois fatores desativada.
- URL da instância. No formulário
A tabela a seguir descreve os papéis recomendados para e as limitações do aplicativo.
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 sua 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 prontas:
- ID do espaço de trabalho. Para informações sobre como conseguir os IDs dos espaços de trabalho, consulte Especifique a fonte do Slack para seu repositório de dados em a 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 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
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.
Digite suas 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 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 do seu processamento, acesse a página Repositórios de dados e Clique no nome do repositório de dados para ver detalhes sobre ele 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 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.
Consulte Visualizar resultados de apps com controle de acesso de terceiros.
Conectar ao Dropbox
Use o procedimento a seguir para sincronizar dados do Dropbox 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 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 da 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 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 origem de dados, acesse Origens de terceiros e selecione Dropbox.
Insira suas informações de autenticação do Dropbox e clique em Autenticar. Um uma nova janela será exibida.
Autentique sua conta e confirme que 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 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 de dados para ver detalhes sobre ele 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 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 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.
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 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 da fonte de dados.
Tenha em mãos as informações de autenticação do Box a seguir. Para informações sobre como configurar esses parâmetros, consulte Autenticação do JWT na caixa na documentação do desenvolvedor.
- 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:
- A sincronização de mudanças incrementais nos comentários pode levar mais tempo do que o configurado do intervalo de frequência.
- Se uma pasta que contém uma entidade for copiada ou movida, alterações incrementais pode levar mais tempo para sincronizar que o intervalo de frequência configurado.
Console
Usar o console do Google Cloud para sincronizar dados do Box 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 repositório 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 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 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 de dados para ver detalhes sobre ele 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 demorar minutos ou 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 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 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 da 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ária 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 repositório de dados.
Na página Selecionar uma fonte de dados, acesse a seção Origens de terceiros e selecione OneDrive.
Insira as informações de autenticação do OneDrive.
Selecione as entidades a serem 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 de dados para ver detalhes sobre ele 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 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.