Conectar uma origem de dados de terceiros

Observação: este recurso é uma oferta de pré-lançamento, sujeita aos "Termos das Ofertas de pré-GA" dos Termos específicos de serviço do GCP. Os produtos e recursos pré-GA podem ter suporte limitado, e as mudanças neles podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições da fase de lançamento. Além disso, ao usar esse recurso, você concorda com os Termos e Condições da Prévia da IA generativa ("Termos de visualização"). Para esse recurso, é possível processar dados pessoais conforme descrito no Adendo sobre processamento de dados do Cloud, sujeito às restrições e obrigações aplicáveis no Contrato (conforme definido nos Termos de Pré-lançamento).

Nesta página, descrevemos como conectar fontes de dados de terceiros à Vertex AI Search.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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

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:

   • Conectar o Confluence Cloud
   • Conectar o Jira Cloud
   • Conectar o Salesforce
   • Conectar o ServiceNow
   • Conectar o SharePoint Online
   • Conectar o Slack
   • Conectar o Dropbox
   • Caixa Connect
   • Conectar o OneDrive

Conectar o Confluence Cloud

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

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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 em 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 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:

  Acessar escopos

  • read:attachment:confluence
  • read:configuration:confluence
  • read:content-details:confluence
  • read:content.metadata:confluence
  • read:group:confluence
  • read:space:confluence
  • read:user:confluence

• 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:

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 fonte de dados, acesse a seção Origens de terceiros e selecione Confluence.

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

6. 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.

7. Selecione as entidades a serem sincronizadas 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 repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.

12. 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 alguns minutos a algumas 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.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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.

1. Faça login em developer.atlassian.com.
2. Clique no ícone do perfil no canto superior direito e selecione Console do desenvolvedor.
3. Clique em Criar e selecione Integração OAuth 2.0.
4. Insira um nome para o app.
   • Marque a caixa de seleção "Termos e Condições".
   • Clique em Criar.

5. 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).

6. 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.

7. 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:

   Ver escopos

   • read:avatar:jira
   • read:audit-log:jira
   • read:group:jira
   • read:issue-security-level:jira
   • read:issue-security-scheme:jira
   • read:jira-user
   • read:jira-work
   • read:user:jira

   Confirme se os sete escopos estão selecionados e salve as alterações.

8. 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?

9. 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:

1. Acesse atlassian.net e faça login com sua conta de administrador.
2. Selecione o app que você quer sincronizar. Por exemplo, sincronize o primeiro app.
3. 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:

1. 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.
2. Acesse o link para encontrar o valor de cloudId. cloudId é o ID da instância.

Configurar permissões e funções

1. Faça login em atlassian.com com sua conta de administrador.
2. Clique no ícone de menu no canto superior esquerdo ou acesse admin.atlassian.com.

3. Na página Administrador, clique em Gerenciar usuários e acesse a página Grupos.

4. Clique em Criar grupo. Digite um nome para o grupo e crie-o.

5. Na seção Acesso de grupo a produtos da página do novo grupo, clique em Adicionar produtos ao grupo.

6. Para a Jira, selecione Administrador de acesso do usuário como a função do produto.

7. Para Administrador do Jira, selecione Administrador de produto como a função do produto e salve as alterações.

8. 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:

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 repositório de dados.

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

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

6. 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.

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 repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.

12. 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 alguns minutos a algumas 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.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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. Para saber como configurar o ID e o chave secreta do cliente no Salesforce, consulte Configurar um app conectado para o fluxo de credenciais do cliente OAuth 2.0 na documentação do Salesforce.

  • URL da instância: o nome de domínio da sua instância do Salesforce. Pesquise Meu domínio, copie o domínio que termina com my.salesforce.com e adicione https:// ao início.
  • ID do cliente: copie o ID do cliente do app conectado clicando em Gerenciar detalhes do cliente. Se o token de atualização estiver ativado, verifique se ele foi atualizado e forneça o token mais recente ao criar um repositório de dados.
  • Chave secreta do cliente: copie a chave secreta do cliente do app conectado clicando em Gerenciar detalhes do cliente. Se o token de atualização estiver ativado, verifique se ele foi atualizado e forneça o token mais recente ao criar um repositório de dados.

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

• Use um plano Enterprise ou para desenvolvedores. Não é possível usar contas de teste.

• Verifique se você está usando o Sales Cloud. O Service Cloud não é compatível.

• Adicione o Google Cloud à lista de permissões do CORS do Salesforce. Se você já concluiu essa tarefa, acesse a seção "Criar um app".

  • 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.

Criar um app

O Salesforce é compatível com os seguintes apps:

1. App conectado.
2. App cliente externo.

Criar um app conectado

Para configurar um app conectado no Salesforce para integração com o Google Cloud, faça o seguinte:

1. Faça login no Salesforce.
2. Clique no ícone de engrenagem e navegue até Configuração.
3. No menu Configuração, navegue até Gerenciador de apps.
4. Clique em Novo app conectado.

5. Para configurar o app conectado:

   a. Na página de criação do app conectado, faça o seguinte:

   • Marque a opção Ativar configurações do OAuth.
   • Defina o URL de callback como: https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
   • Selecione os seguintes escopos do OAuth:
     • Acesso total (full).
     • Fazer solicitações a qualquer momento (refresh_token, offline_access).

   b. Ative os fluxos:

   • Fluxo de credenciais do cliente.
   • Fluxo de código de autorização e credenciais.
   • Credenciais do usuário no corpo do POST para o fluxo de credenciais e o código de autorização.
   • Para o Fluxo de credenciais do cliente, atribua seu nome de usuário no campo Executar como. Você precisa ter permissões de leitura para todas as entidades que o conector pode extrair.

Depois de criar o app conectado, faça o seguinte:

1. Editar políticas de apps:

   • Acesse o App Manager e edite o app recém-criado.
   • Defina Relaxamento de IP como Relax IP restrictions.
   • Configure a política de tokens de atualização para Valid until revoked ou configurações mais restritivas, conforme necessário.
   • Verifique se a opção Usuários permitidos está definida como All users may self-authorize.

2. Configure as restrições de IP:

   • Se a Aplicação de intervalo de IP no nível da organização estiver ativada, defina Intervalos de IP confiáveis em Segurança > Acesso à rede. Para mais informações, consulte a documentação sobre Redução de IP do app conectado e aplicação contínua de IP.
   • Desative a opção Aplicar intervalos de IP de login em cada solicitação se não houver restrições de IP.

3. Configure um app conectado OAuth:

   • Use os guias abaixo para configurar um app conectado ao OAuth:
     • Noções básicas de apps conectados.
     • Integração de API.
     • Configuração das credenciais do cliente.

4. Salve o app conectado:

   • Salve e saia do app conectado.
   • Na barra de pesquisa, pesquise Configurações do OAuth e do OpenID Connect.
   • Ative a opção Permitir fluxos de código de autorização e credenciais e fluxos de nome de usuário e senha do OAuth.

Criar um app cliente externo

Para criar e configurar um app de cliente externo no Salesforce e ativar a autenticação baseada em OAuth para integrações, faça o seguinte:

1. Receba o ID e a chave secreta do cliente:

   • Faça login no Salesforce.
   • Clique no ícone de engrenagem e acesse Configuração.
   • Navegue até Configuração > Apps > Apps de cliente externos.
   • Clique em Novo app de cliente externo.

2. Forneça as informações necessárias:

   • Insira o nome do app e seu endereço de e-mail. O nome da API é preenchido automaticamente por padrão.
   • Deixe o Estado de distribuição como Local.

3. Ative as configurações do OAuth:

   • Expanda API (Enable OAuth Settings) e selecione Ativar OAuth.
   • Configurar:
     • URL de callback: https://login.salesforce.com/services/oauth2/callback
     • Escopos do OAuth: gerencie os dados do usuário por APIs (api).
     • Em Ativação de fluxo, selecione Ativar o fluxo de credenciais do cliente.
     • Clique em Criar para criar o app de cliente externo. Acesse o gerenciador de apps de cliente externo para conferir o app que você adicionou à lista.

4. Editar políticas de apps:

   • Abra o app criado.
   • Acesse Políticas e clique em Editar.
   • Em Fluxos OAuth e aprimoramentos de apps clientes externos, marque Ativar o fluxo de credenciais do cliente.
   • Insira seu nome de usuário do Salesforce no campo Executar como.

5. Acessar credenciais do OAuth:

   • Clique em Configurações.
   • Clique em Configurações do OAuth.
   • Clique em Chave e secret do consumidor para acessar as credenciais. O código de verificação é enviado para seu endereço de e-mail.
   • Insira o código de verificação e clique em Verificar.
   • Copie a chave do consumidor e use-a como o ID do cliente.
   • Copie o secret do consumidor e use-o como a chave secreta do cliente.

Criar um conector do Salesforce

Console

Para usar o console do Google Cloud e sincronizar dados do Salesforce 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 repositório de dados.

4. Na página Selecionar uma fonte de dados, role a tela ou pesquise Salesforce para conectar a fonte externa.

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

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

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

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

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

10. 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.

11. 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 alguns minutos a algumas 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.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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:

      Campos de visualização

      • Tipo: record
      • Operação: read
      • Nome: é necessária uma regra de controle de acesso separada para cada um deles:
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • Requer papel: nome do papel personalizado.

      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 repositório de dados.

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

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

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

7. Selecione uma região para o 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 repositório de dados 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 alguns minutos a algumas 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.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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:

    Acessar escopos

    • GroupMember.Read.All
    • Sites.FullControl.All
    • User.Read.All

  • Ao configurar as permissões do aplicativo, adicione as seguintes permissões delegadas para a API REST do Sharepoint:

    Acessar escopos

    • AllSites.FullControl

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

  Conferir funções

  Papéis	Registro do aplicativo cliente	Pode buscar conteúdo de todas as entidades	Consegue buscar ACL	Pode buscar a identidade	Observações
  Administradores do site	Não	Sim	Sim	Sim
  Administrador da coleção de sites	Não	Sim	Sim	Sim
  Administrador global	Sim	Não	Sim	Não	Limitação: não é possível buscar a identidade ou as entidades de comentários e anexos.
  Proprietário do site	Não	Sim	Sim	Não	Limitação: não é possível buscar a identidade
  Administrador do aplicativo	Sim	N/A	N/A	N/A	A função de administrador do aplicativo está relacionada à Central de administração do Microsoft 365 / Central de administração do Entra. Ele não é específico do Sharepoint.

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 repositório de dados.

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

5. Insira as informações de autenticação do SharePoint Online e clique em Autenticar.

6. 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 Sharepoint Online para seu 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 para o repositório de dados.

11. 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.

12. 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 alguns minutos a algumas 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 Slack

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

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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.

• Entre em contato com o proprietário do Workspace para receber as permissões de instalação de novos apps.

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

  • ID do espaço de trabalho: siga as instruções em Especificar a origem do Slack para seu repositório de dados na documentação do Slack para encontrar o ID do espaço de trabalho.
  • Token de acesso: crie um app cliente e defina os escopos necessários. Para mais informações, consulte Guia de 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:

    Acessar escopos

    • users:read.email
    • channels:history
    • channels:read
    • groups:history
    • groups:read
    • im:history
    • im:read
    • mpim:history
    • mpim:read
    • team:read
    • users:read
    • files:read

• Por padrão, o Slack restringe o rastreamento e a sincronização de conteúdo de canais particulares, mensagens em grupo e mensagens diretas.

Configurar o app Slack

Receba um token de acesso para permitir que a Vertex AI para Pesquisa colete documentos do seu espaço de trabalho do Slack.

Observação: crie um app do Slack e escolha entre o bot (Gerar um token de bot) ou o token do usuário (Gerar um token do usuário) com base no requisito.

Gerar um token de bot

Gere um token de bot para acessar com segurança canais particulares, mensagens instantâneas (IMs) e mensagens instantâneas multilaterais (MPIMs). O token do bot não pode rastrear os canais públicos dos quais não faz parte, e a participação em canais públicos gera uma mensagem de participação.

1. Faça login nos Apps da API Slack.
2. Clique em Criar novo app.
3. Selecione Do zero.
4. Insira um nome para o app e selecione o espaço de trabalho para a integração.
5. Clique em Criar App.
6. Clique em OAuth e permissões.

7. Em Escopos do token de bot, adicione os seguintes escopos obrigatórios:

   Acessar escopos

   • users:read.email
   • channels:history
   • channels:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • team:read
   • users:read
   • files:read

   Por padrão, o bot lê dos canais #general e #random. Para ativar o rastreamento, faça o seguinte:

   • Para canais públicos, conceda o escopo channels:join para permitir que o bot entre automaticamente.
   • Para canais privados, convide o bot manualmente.

8. Clique em Instalar no seu espaço de trabalho de nome de usuário.

9. Siga as instruções na tela para instalar o app e extrair o token do bot.

Gerar um token de usuário

Gerar um token de usuário para acessar todos os canais públicos sem precisar se inscrever neles. O token do usuário não pode rastrear canais, mensagens instantâneas ou MPIMs particulares, a menos que o usuário tenha acesso.

1. Faça login nos Apps da API Slack.
2. Clique em Criar novo app.
3. Selecione Do zero.
4. Insira um nome para o app e selecione o espaço de trabalho para a integração.
5. Clique em Criar App.
6. Clique em OAuth e permissões.

7. Em Escopos de token do usuário, adicione os seguintes escopos obrigatórios:

   Acessar escopos

   • users:read.email
   • channels:history
   • channels:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • users:read
   • files:read

8. Clique em Instalar no seu espaço de trabalho de nome de usuário.

9. Siga as instruções na tela para instalar o app e extrair o token do usuário.

Criar um conector do Slack Cloud

Console

Para usar o console do Google Cloud e sincronizar dados do Slack 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 repositório de dados.

4. Na página Selecionar uma fonte de dados, role a tela ou pesquise Slack para conectar a fonte externa.

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

   • ID da instância (ID do Workspace): acesse seu espaço de trabalho do Slack para fazer login em um navegador. O ID do espaço de trabalho é o segmento após /client no URL.
   • Token de autenticação: use o token recebido na seção anterior.

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

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

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

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

10. 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.

11. 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 alguns minutos a algumas 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.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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:

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 repositório de dados.

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

5. Insira 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 foi bem-sucedida antes de retornar à página Especificar a origem do Dropbox para o repositório de dados.

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

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

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

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

11. 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.

12. 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 alguns minutos a algumas 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.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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:

  Acessar escopos

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

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 podem levar mais tempo para sincronizar do que o intervalo de frequência configurado.

Criar o app do Box

1. Faça login no Console do desenvolvedor do Box com sua conta de administrador.
2. Clique em Criar novo app.
3. Selecione o tipo App personalizado.
4. Digite o Nome do app.
5. Defina o propósito do app: integração, IA ou Google Cloud Agent Builder.
6. Escolha Autenticação do servidor com JWT.

Configurar o app Box

Defina as configurações do app Box.

Criar chave pública/privada

1. Acesse o console para desenvolvedores do Box.

2. Na guia Configuração, clique em Gerar um par de chaves pública/privada.

   • A chave pública é enviada automaticamente ao console com um ID. Esse ID é usado ao criar uma conexão.
   • Um arquivo de configuração com a chave privada e a senha longa pode ser transferido para o dispositivo. Mantenha esse arquivo de configuração para uso posterior.
   • Se preferir, consulte o guia de configuração de pares de chaves do Box para gerar sua própria chave.

Configurar as permissões necessárias

1. Na seção Âmbitos do aplicativo, selecione a seguinte permissão:
   • Ler todos os arquivos e pastas armazenados no Box.

Autorizar o app

1. Na guia Autorização, clique em Revisar e enviar e aguarde a aprovação do administrador.
2. Os administradores podem aprovar o app no Admin Console.

Após a autorização, a Box configura o app por completo.

Criar um conector do Box

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 repositório de dados.

4. Na página Selecione uma fonte de dados, role a tela ou pesquise Box para conectar a origem externa.

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

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

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

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

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

10. 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.

11. 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 alguns minutos a algumas 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.

Pré-lançamento:os conectores de terceiros estão em pré-lançamento com lista de permissões. Você precisa estar na lista de permissões para usar esse recurso.

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:

    Acessar escopos

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

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 repositório de dados.

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

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

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

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

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

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

10. 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.

11. 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 alguns minutos a algumas 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.