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:você precisa estar na lista de permissões para usar os conectores de terceiros.

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 Adobe Experience Manager
   • Connect AODocs (lista de permissões adicional)
   • Conectar o Asana
   • Caixa Connect
   • Connect Coda (lista de permissões adicional)
   • Conectar o Confluence Cloud
   • Conectar o data center local do Confluence
   • Conectar o Dropbox
   • Conectar o Dynamics 365
   • Connect Entra ID
   • Conectar o GitHub (lista de permissões adicional)
   • Conectar o GitLab (lista de permissões adicional)
   • Conectar o Jira Cloud
   • Conectar o Jira Data Center on-premises
   • Conectar o Microsoft Outlook (lista de permissões adicional)
   • Conectar o Microsoft Teams (lista de permissões adicional)
   • Conectar segunda-feira
   • Connect Notion (lista de permissões adicional)
   • Conectar o Okta
   • Conectar o OneDrive
   • Conectar o Salesforce
   • Conectar o ServiceNow
   • Conectar o data center local do SharePoint
   • Conectar o SharePoint Online
   • Conectar o Slack
   • Conectar o Trello
   • Conectar o WordPress
   • Connect Workday
   • Conectar o Zendesk (lista de permissões adicional)

Conectar o Adobe Experience Manager

Use o procedimento a seguir para sincronizar dados do Adobe Experience Manager com a pesquisa do Vertex AI.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do Adobe Experience Manager precisa gerar ou receber o seguinte para integrar com a Vertex AI Search:

   • Credenciais de serviço da sua instância do Adobe Experience Manager
   • URL da instância do seu site do Adobe Experience Manager

Criar um conector do Adobe Experience Manager

Console

Para usar o console do Google Cloud e sincronizar dados do Adobe Experience Manager 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 Adobe Experience Manager para conectar a fonte externa.

5. Insira as informações de autenticação do Adobe Experience Manager e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o AODocs

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do AODocs precisa gerar ou receber o seguinte para fazer a integração com a Vertex AI para Pesquisa:

   • ID da instância (URL do domínio da sua instância do AODocs)
   • ID do cliente
   • Chave secreta do cliente

Criar um conector do AODocs

Console

Para usar o console do Google Cloud e sincronizar dados do AODocs 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 AODocs para conectar a fonte externa.

5. Insira as informações de autenticação do AODocs 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 AODocs 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 conector de dados.

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

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

12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa vão aparecer depois que o app for configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Asana

Use o procedimento a seguir para sincronizar dados da Asana com a Vertex AI para Pesquisa.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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

Antes de começar

Antes de configurar a conexão:

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

• Um administrador do Asana precisa gerar ou receber o token de acesso pessoal (PAT) a seguir para autenticação. Para mais informações, consulte Token de acesso pessoal na documentação da Asana.

Para convidar um membro para um espaço de trabalho do Asana, faça o seguinte:

1. Faça login no aplicativo Asana com sua conta de administrador.

2. Clique no ícone do perfil e selecione Admin Console.

3. Clique em Convidar membro. Digite o endereço de e-mail do usuário e o projeto que você quer adicionar.

4. Clique em Enviar. O usuário aceita o convite para garantir que ele seja adicionado ao projeto.

Para gerar um PAT, faça o seguinte:

1. Abra o console do desenvolvedor da Asana.

2. Clique em Meus apps.

3. Clique em Criar token.

4. Na caixa de diálogo Criar novo token, preencha as informações necessárias.

5. Clique em Criar token.

6. Copie o token para uso posterior.

7. Clique em Concluído.

Criar um conector de nuvem do Asana

Console

Para usar o console do Google Cloud e sincronizar dados do Asana 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, selecione Armazenamentos de dados.

3. Clique em Criar repositório de dados.

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

5. Insira os detalhes de autenticação, incluindo o PAT gerado.

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

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

8. Dê um nome ao repositório de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O 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 vão aparecer depois que o app e o repositório de dados forem configurados, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para 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:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Você precisa ter acesso de administrador à instância do Box com a 2FA ativada. Todas as instruções de configuração só podem ser realizadas na conta de administrador.

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

3. Leia Configuração com JWT na documentação do Box para ter uma visão geral da configuração com capturas de tela.

Criar um app do Box

1. Faça login no Console do desenvolvedor do Box com sua conta de administrador.
2. Clique em Criar app de plataforma.
3. Selecione Tipo de app como App personalizado.
4. Digite o Nome do app.
5. Defina as seguintes propriedades:
   1. Finalidade:integração
   2. Categorias:IA
   3. Sistema externo: Google Cloud Agent Builder
6. Selecione Authentication method como Server authentication (with JWT).
7. Clique em Criar App.

Configurar o app Box

1. No Console do desenvolvedor do Box, escolha o app da plataforma e acesse a guia Configuração.
2. Na seção Nível de acesso do app, selecione Acesso do app + Enterprise.

3. Na seção Âmbitos do aplicativo, selecione os seguintes:

   1. Ler todos os arquivos e pastas armazenados no Box
   2. Gravar todos os arquivos e pastas armazenados no Box
   3. Gerenciar usuários
   4. Gerenciar grupos
   5. Gerenciar propriedades empresariais

4. Na seção Recursos avançados, selecione Fazer chamadas de API usando o cabeçalho como usuário.

5. Na seção Adicionar e gerenciar chaves públicas, clique em Gerar um par de chaves pública/privada.

   1. A chave pública é enviada automaticamente para o console com um ID. Esse ID é usado ao criar uma conexão.
   2. É possível fazer o download de um arquivo de configuração com a chave privada e a senha longa. Mantenha esse arquivo para uso posterior.
   3. Se preferir, consulte o guia de configuração de pares de chaves do Box para gerar sua própria chave.

6. Clique em Salvar alterações.

Autorizar o app Box

1. No Console do desenvolvedor do Box, escolha o app da plataforma e acesse a guia Autorização.
2. Clique em Revisar e enviar.
3. Na caixa de diálogo Analisar envio de autorização do app, clique em Enviar.
4. Faça login no gestor de apps da plataforma de administração do Box com sua conta de administrador.
5. Escolha o app da plataforma que você configurou.
6. Clique nos três pontos (…) na linha correspondente.
7. Selecione Autorizar app na lista suspensa.
8. Na caixa de diálogo Autorizar app, clique em Autorizar para concluir o processo de autorização.

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

• ID da empresa: confira na guia Configurações gerais.
• ID do cliente e chave secreta do cliente: confira na guia Configuração, em Credenciais do OAuth 2.0.
• Chave privada, ID da chave e Senha: esses parâmetros já foram gerados e transferidos para um arquivo local na guia Configuração em Adicionar e gerenciar chaves públicas durante a configuração do app.

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 cria e exibe 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 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 Coda

Use o procedimento a seguir para sincronizar dados da Coda com a Vertex AI para Pesquisa.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do Coda precisa gerar ou receber o token da API Coda para fazer a integração com a Vertex AI para Pesquisa.

Criar um conector da Coda

Console

Para usar o console do Google Cloud e sincronizar dados do Coda 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 Coda para conectar a fonte externa.

5. Insira as informações de autenticação da Coda e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Confluence Cloud

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Verifique se você tem acesso de administrador à instância e ao projeto do Confluence.

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

Configurar a autenticação e as permissões no Confluence

Verifique se você tem os detalhes de autenticação necessários e acesso de administrador à sua instância do Confluence. Use as instruções a seguir para criar um ID e uma chave secreta do cliente pelo console do desenvolvedor da Atlassian, configurar os escopos OAuth 2.0 necessários, definir permissões para usuários, extrair o URL e o ID da instância, configurar papéis e autenticar para sincronizar dados entre o Confluence Cloud e a Pesquisa do Vertex AI. 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. Crie uma integração OAuth 2.0 no Atlassian Developer Console:

   1. Faça login no Atlassian Developer Console.
   2. Clique no ícone do perfil e selecione Atlassian Developer Console.
   3. Clique em Criar e selecione Integração OAuth 2.0.
   4. Digite um nome para o app e faça o seguinte:
      1. Marque a caixa de seleção "Termos e Condições".
      2. Clique em Criar.
      3. Clique em Autorização.
      4. Na tabela Tipo de autorização, selecione Adicionar para OAuth 2.0 (3LO).
   5. No campo URL de callback, insira https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html.
   6. Clique em Salvar alterações.

   Se você receber o aviso: Seu app não tem APIs. Adicionar APIs ao app, vá para a etapa 2 e conclua as etapas restantes. Caso contrário, pule para as etapas 4 e 5.

2. Ativar o OAuth 2.0:

   1. Clique em Permissões.
   2. Acesse a API Confluence.
   3. Clique em Adicionar.
   4. Clique em Configurar.
   5. Acesse a guia Escopos granulares e clique em Editar escopos.
   6. Selecione os seguintes escopos.

      Conferir escopos

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence
   7. Confirme se sete escopos estão selecionados e salve as alterações.

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

   1. Clique em Distribuição.
   2. Selecione Editar.
   3. Selecione Compartilhamento para permitir a edição de outros campos.
   4. Preencha os campos restantes.
   5. Selecione Sim quando aparecer Does your app store personal data?
   6. Selecione Configurações para copiar o ID do cliente e a Chave secreta do cliente.

4. Acesse 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. Ele aparece como o subdomínio na barra de endereço.

5. Acesse 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 ou acesse admin.atlassian.com.
3. Na página Administrador, clique em Gerenciar usuários e acesse a página Grupos.
4. Acesse o site do seu domínio do Atlassian e abra a instância do Confluence Cloud.
5. Acesse o IAM.

6. Conceda ao administrador do Confluence o papel de Discovery Engine. Isso permite que o administrador do Confluence configure o conector conforme descrito em Criar um conector do Confluence Cloud.

7. Conceder a função de administrador a um usuário:

   1. Crie uma conta de usuário dedicada. Use essa conta para configurar o repositório de dados.
   2. Atribua a função de administrador ao novo usuário.

8. Configure as permissões no Atlassian:

   1. Acesse o site do seu domínio do Atlassian e abra a instância do Confluence Cloud. Você também pode acessar admin.atlassian.com.

   2. Clique no ícone de menu e selecione a opção necessária.

   3. Opcional: se solicitado, selecione a organização adequada na página de destino.

9. Criar e configurar grupos:

   1. Na página Administrador, clique no botão Gerenciar usuários, se necessário, e selecione Gerenciar usuários na lista suspensa.
   2. Na página Gerenciamento de usuários, selecione Grupos.
   3. Clique em Criar grupo e atribua um nome. Use esse grupo para atribuir as permissões necessárias pelo conector.

10. Adicione permissões ao grupo: atribua a função Administrador de acesso do usuário.

11. Atribuir participantes ao grupo:

    1. Na página Grupo, clique em Adicionar produto e selecione o papel apropriado na lista suspensa.Neste caso, selecione Administrador de acesso do usuário.
    2. Clique em Adicionar para confirmar a atribuição de função.
    3. Clique em Adicionar membros do grupo para incluir contas de usuários ou membros do grupo. Verifique se o conector faz a autenticação em nome desses usuários para buscar documentos.

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.

Criar um conector do Confluence Cloud

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

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

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 cria e exibe 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 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 Confluence Data Center local

Use este procedimento para criar um app de pesquisa e um repositório de dados do Confluence Data Center no Agent Builder, sincronizando dados locais do Confluence com a Vertex AI para Pesquisa.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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, verifique se você tem o seguinte:

1. Anexo de serviço (obrigatório apenas para o tipo de destino privado): configure um anexo de serviço para a transferência segura de dados.
2. Nome de usuário e senha: receba credenciais válidas para autenticação do administrador do Confluence.
3. Opcional para o tipo de destino particular: URL do domínio: especifique o URL da instância do Confluence Data Center.
4. Opcional: Nome de domínio de base: informe o nome de domínio de base da instância do Confluence.
5. Opcional: Porta de destino: identifique a porta usada para a comunicação com o Confluence Data Center.

6. Use as diretrizes de configuração a seguir para estabelecer conexões com o Private Service Connect(PSC). Ajuste ou adicione recursos conforme necessário. Verifique se o anexo de serviço do PSC está configurado corretamente para se conectar à instância particular e atende aos requisitos de um serviço publicado.

   1. Defina as configurações de rede:

      1. Coloque o anexo de serviço do PSC e o balanceador de carga em sub-redes diferentes na mesma rede de nuvem privada virtual.

      2. O sistema de back-end precisa permanecer fechado para a rede pública por motivos de segurança. No entanto, verifique se ele pode aceitar tráfego das seguintes origens:

         • Para balanceadores de carga baseados em proxy/HTTP(s) (ILB de proxy L4, ILB L7), configure o back-end para aceitar solicitações da sub-rede de proxy na rede de nuvem privada virtual.

         • Para mais informações, consulte a documentação Sub-redes somente proxy para balanceadores de carga baseados no Envoy.

   2. Ajuste as regras de firewall:

      1. Regras de entrada:

         • Permita o tráfego da sub-rede de vinculação do serviço do PSC para a sub-rede do balanceador de carga interno (ILB).
         • Verifique se o ILB pode enviar tráfego para o back-end.
         • Permitir que as sondagens de verificação de integridade alcancem o back-end.

      2. Regras de saída: ative o tráfego de saída por padrão, a menos que regras de negação específicas sejam aplicadas.

7. Considerações adicionais: mantenha todos os componentes, incluindo o anexo de serviço do PSC e o balanceador de carga, na mesma região.

Gerar um anexo de serviço

Siga estas etapas para gerar um anexo de serviço:

1. Definir o tipo de endpoint: selecione Público ou Particular.

2. Para o endpoint Público: se o Destino do Confluence Data Center for Público, não será necessário criar a configuração para o anexo de serviço. Em vez disso, use seu URL público no campo URL do domínio do console do Google Cloud ao criar o conector.

3. Para o endpoint Particular:

   1. Use o Private Service Connect (PSC) para ativar as conexões de instâncias particulares para Google Cloud.
   2. Crie uma rede de nuvem privada virtual e as sub-redes necessárias.
   3. Crie uma instância de máquina virtual (VM) e instale o serviço de back-end.
   4. Opcional: configure uma sondagem de verificação de integridade para monitorar a integridade do back-end.
   5. Adicione um balanceador de carga para rotear o tráfego para a VM ou o back-end.
   6. Defina regras de firewall para permitir o tráfego entre o endpoint do PSC e o back-end.
   7. Publique o endpoint criando um anexo de serviço do PSC.

Criar um usuário do Confluence Data Center e configurar permissões

Para permitir que a Pesquisa da Vertex AI receba dados do Confluence, crie um novo usuário com as permissões mínimas necessárias. Siga estas etapas para criar o usuário e configurar as permissões necessárias.

1. Faça login como administrador:

   1. Acesse o site do seu domínio da Atlassian e abra a instância do Confluence Data Center.
   2. Digite o nome de usuário e a senha do administrador.
   3. Clique em Fazer login.

2. Crie um novo usuário:

   Ao criar um repositório de dados, você precisa criar um usuário para receber dados da instância de terceiros.

   1. Clique no ícone de configurações.
   2. Selecione Gerenciamento de usuários.
   3. Digite as credenciais de administrador, se solicitado.
   4. Na página Administração, clique em Criar usuário.
   5. Digite o endereço de e-mail, o nome completo, o nome de usuário e a senha.
   6. Clique em Criar usuário.

3. Atribuir um usuário a um grupo:

   1. Na página Administração do Confluence, navegue até a guia "Usuários e segurança" e clique em Grupos.
   2. Clique em Adicionar grupo. Digite um nome para o grupo e crie-o.
   3. No campo Encontrar grupo, digite o nome do grupo para encontrá-lo.
   4. Clique no ícone de configurações.
   5. Selecione a conta de perfil e acesse Gerenciamento de usuários.
   6. Na página Usuários, em Listar usuários, procure o usuário recém-criado no campo Encontrar usuário.
   7. Clique no usuário para abrir a página Visualizar usuários.
   8. Clique em Editar grupos para abrir a página Editar grupo de usuários.
   9. Marque a caixa de seleção do grupo de usuários criado.
   10. Clique em Salvar para atribuir o usuário ao grupo recém-criado.

   O usuário adicionado é atribuído na seção Membros do grupo.

4. Configure as permissões do usuário:

   1. Na página Administração do Confluence, navegue até a guia Issues.
   2. Localize Permissões.
   3. Selecione Ver permissões globais.
   4. Selecione Editar permissões.
   5. Na página Editar permissões globais, procure o grupo atribuído ao usuário e ative a opção pode usar.

Configurar o espaço de documentação

1. Clique no ícone Confluence para acessar a página Painel.
2. Clique em Criar espaço.
3. Selecione Espaço de documentação e clique em Próxima.
4. Insira todos os detalhes necessários e clique em Criar para criar o espaço de documentação.
5. Em Meus espaços, clique no espaço recém-criado.
6. Acesse Páginas e abra o menu (três pontos).
7. Selecione Restrições.
8. No menu suspenso Restrições, selecione a opção Visualização e edição restritas.
9. Pesquise o grupo e atribua a permissão pode visualizar.
10. Clique em Aplicar. O usuário é criado com acesso mínimo e as permissões são definidas para os espaços. Você também pode atribuir permissões aos blogs.

Criar um conector do Confluence Data Center local

Console

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 Data center do Confluence para conectar a origem externa.

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

6. Na lista suspensa Tipo de destino, selecione Público ou Particular.

   1. Para o tipo de destino Público, não é necessário criar a configuração para o anexo de serviço. Em vez disso, use seu URL público no campo "URL do domínio" do console do Google Cloud.
   2. Para o tipo de destino Particular, insira todas as informações necessárias:
      1. Se a instância tiver um URL de domínio:
         • Anexo de serviço: insira o anexo de serviço.
         • Opcional: Nome de domínio de base: insira seu domínio de base.
         • URL do domínio: insira o URL do seu domínio.
         • Opcional: Porta de destino: insira a porta de destino.
      2. Se a instância não tiver um URL de domínio:
         • Anexo de serviço: insira o anexo de serviço.
         • Opcional: Porta de destino: insira a porta de destino.

7. Clique em Continuar.

8. Opcional: Opções avançadas: selecione e ative as Configurações de proxy e Configurações de SSL, se necessário.

9. Em Entidades para sincronizar, selecione todas as entidades necessárias e clique em Continuar.

10. Selecione uma região para o conector de dados e insira um nome.

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

Para o tipo de destino Privado, depois que você envia os detalhes do conector, o VAIS envia uma solicitação de conexão para o PSC. Acesse o conector para ver uma mensagem que permite adicionar um projectId à lista de permissões na PSC. O conector permanece no estado Erro até que você permita a conexão no PSC. Quando você aceita a solicitação de conexão, o conector muda para o estado Ativo durante a próxima execução de sincronização. Se você configurar o PSC para aceitar todas as conexões, o conector vai passar automaticamente para o estado Ativo após a criação.

No tipo de destino Público, o conector entra automaticamente no estado Ativo após o envio.

Para verificar o estado do repositório de dados e a atividade de ingestão, faça o seguinte:

1. Navegue até o conector na lista de armazenamento de dados e monitore o estado dele até que mude para Ativo.
2. Depois que o estado do conector mudar para Ativo, clique na entidade necessária e confirme se todas as entidades selecionadas foram processadas. O estado do repositório de dados muda de Criação para Em execução quando a sincronização começa e muda para Ativo quando a ingestão é concluída, indicando que o repositório de dados está configurado. Dependendo do tamanho dos dados, a ingestão pode levar 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.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

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

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

Criar um conector do Dropbox

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, role a tela ou pesquise Dropbox para conectar a origem externa.

5. Insira suas informações de autenticação do Dropbox e clique em Autenticar. Uma nova janela será aberta.

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

12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a 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 vão aparecer depois que o app e o repositório de dados forem configurados, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Dynamics 365 para Conectar

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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.

Atenção: esse conector oferece suporte parcial a ACLs. Durante a prévia particular, os domínios do usuário são verificados, mas a verificação granular do usuário não é aceita.

Antes de começar

Antes de criar um conector do Dynamics 365:

1. Um administrador do Dynamics 365 precisa gerar ou receber o seguinte para integrar com a Vertex AI para Pesquisa:

   • ID do cliente
   • Chave secreta do cliente
   • Azure Tenant
   • URL da organização

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

Criar um conector do Dynamics 365

Console

Para usar o console do Google Cloud e sincronizar dados do Dynamics 365 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 Dynamics 365 para conectar a origem externa.

5. Insira as informações de autenticação do Dynamics 365 e clique em Continuar.

6. Insira o URL do locatário e da organização do Azure e clique em Continuar.

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 conector de dados.

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

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

12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa vão aparecer depois que o app for configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Microsoft Entra ID

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

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

2. Para receber o ID e a chave secreta do cliente, faça o seguinte:

   1. Crie um aplicativo do Entra ID:

      1. Faça login no centro de administração do Microsoft Entra e clique em Aplicativo.
      2. Na lista suspensa Aplicativo, clique em Registros de app.
      3. Na página Registros de apps, clique em Novo registro.
      4. Clique em Adicionar novo registro e faça o seguinte:
         • Insira um nome para o aplicativo.
         • Em Supported account types, selecione Accounts in the organizational directory only.
         • Em URI de redirecionamento, adicione um URI de redirecionamento da Web que aponte para: https://login.microsoftonline.com/common/oauth2/nativeclient.
      5. Clique em Registrar.

   2. Salvar credenciais:

      Na janela do aplicativo registrado, salve os seguintes valores para uso posterior:

      1. Use o ID do aplicativo (cliente) para definir o parâmetro ID do cliente.
      2. Use o ID do diretório (locatário) para definir o parâmetro Azure Tenant.

   3. Crie uma chave secreta do cliente:

      1. Navegue até Certificados e chaves secretas e crie uma nova chave secreta do cliente:
      2. Clique em Nova chave secreta do cliente e especifique a duração necessária.
      3. Salve a chave secreta do cliente e copie o valor da chave para uso posterior.

Configurar as permissões da API Entra ID

1. Na janela do aplicativo registrado, clique em Permissões da API.

2. Em Permissões configuradas, selecione Microsoft Graph e configure a seguinte permissão:

   Ver permissões

   • User.Read.All (Application)

   Se você quiser importar profileCardAttributes, configure as seguintes permissões:

   Ver permissões

   • People.Read.All (Application)
   • PeopleSettings.Read.All (Application)

3. Conceda consentimento de administrador para todas as permissões adicionadas. O consentimento de um administrador é necessário para usar credenciais do cliente no fluxo de autenticação.

Criar um conector do Entra ID

Console

Para usar o console do Google Cloud e sincronizar dados do Entra ID 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 ID do Entra para conectar a origem externa.

5. Em Configurações de autenticação, insira o ID e a chave secreta do cliente.

6. Pule a opção Destinos e clique em Continuar.

7. Em Opções avançadas, insira o ID do locatário do Azure.

8. Clique em Continuar.

9. Em Entidades a sincronizar, selecione Perfis de usuário.

10. Clique em Continuar.

11. Em Configurar o conector de dados, selecione uma região para o repositório de dados.

12. Insira um nome para o conector de dados.

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

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

15. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.

16. Quando o estado do conector mudar para Ativo, navegue até a guia Entidade.

17. Clique na entidade userprofiles.

18. Verifique o número de documentos processados e confirme se ele corresponde ao número de usuários no ID do Entra.

    Se o app Entra ID tiver as permissões necessárias para importar atributos personalizados, ele vai importar até 15 atributos de cartão de perfil por registro. Por padrão, os atributos personalizados não são pesquisáveis.

Para tornar os atributos personalizados pesquisáveis, faça o seguinte:

1. Na página perfis, navegue até a guia Esquema.
2. Clique em Editar.

3. Desmarque os atributos, como endereço, para que não sejam recuperáveis, pesquisáveis e indexáveis e clique em Salvar.

   O botão Editar fica inativo por alguns minutos antes de ser reativado.

4. Quando o botão Editar estiver no estado Ativo, clique em Editar.

5. Selecione as caixas recuperáveis, pesquisáveis e indexáveis para os atributos personalizados obrigatórios.

6. Ative a pesquisa.

7. Clique em Salvar.

Testar o mecanismo de pesquisa

Depois de configurar o mecanismo de pesquisa, teste os recursos dele. Isso garante resultados precisos com base no acesso do usuário.

1. Ativar o app da Web:

   1. Acesse as configurações de integração do app e ative a opção Ativar o app da Web.

2. Testar o app da Web:

   1. Clique em Abrir ao lado do link do app da Web e faça login como um usuário.

   2. Verifique se os resultados da pesquisa estão restritos a itens acessíveis pelo usuário.

Visualizar os resultados da pesquisa de pessoas

1. No app de pesquisa, navegue até Pré-visualização e comece a pesquisar no console ao usar o IdP do Google.

   • Como alternativa, acesse o link fornecido e faça login com seu IdP para iniciar a pesquisa.
   • Os resultados da pesquisa aparecem como cards de pessoas, mostrando detalhes do usuário, como Nome, Cargo, E-mail e Foto do perfil.

2. Clique em um card de pessoa para acessar uma página de perfil detalhada, que inclui o seguinte:

   • Nome
   • Foto do perfil
   • Cargo
   • Departamento
   • Cadeia de gerenciamento
   • Subordinados diretos

3. Se atributos personalizados (propriedades do card de perfil) forem ingeridos e indexados, pesquisáveis e recuperáveis:

   • A pesquisa por um valor de atributo personalizado retorna apenas perfis de pessoas com esses atributos.
   • Os atributos personalizados aparecem nos resultados da pesquisa, mas só podem ser acessados pela API, não pela interface do usuário da Pesquisa Vertex.

Configurar o pool de força de trabalho para um IdP que não seja do Google sem SSO

1. Se os funcionários usarem um IdP que não seja do Google, não tiverem SSO com o Google ou não forem clientes do Google Workspace, configure um pool de força de trabalho conforme descrito em Usar o controle de acesso à fonte de dados para ativar a pesquisa de funcionários.

   O pool de colaboradores permite gerenciar e autenticar usuários de provedores de identidade externos, como o Azure ou o Okta, no console do Google Cloud.

2. Para configurar o pool de forças de trabalho e ativar o app da Web para acesso perfeito do usuário, faça o seguinte:

   1. Crie um pool de força de trabalho no nível da organização em Google Cloud seguindo o manual de configuração apropriado:

      1. Configuração do Azure OIDC
      2. Configuração do SAML do Azure
      3. Configuração do Okta e do OIDC
      4. Configuração do Okta e do SAML

   2. Configure o pool de força de trabalho em Agent Builder > Configurações para a região em que você criou o app.

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 GitHub

Use o procedimento a seguir para sincronizar dados do GitHub com a Vertex AI Search.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do GitHub precisa receber o token de acesso pessoal da instância do GitHub para fazer a integração com a Vertex AI Search.

Criar um conector do GitHub

Console

Para usar o console do Google Cloud para sincronizar dados do GitHub 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 GitHub para conectar a fonte externa.

5. Insira suas informações de autenticação do GitHub e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o GitLab

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do GitLab precisa receber o token de acesso pessoal da instância do GitLab para fazer a integração com a Vertex AI Search.

Criar um conector do GitLab

Console

Para usar o console do Google Cloud e sincronizar dados do GitLab 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 GitLab para conectar a fonte externa.

5. Insira as informações de autenticação do GitLab e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para 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:você precisa estar na lista de permissões para usar os conectores de terceiros.

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 dar consentimento para o 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 do desenvolvedor da Atlassian, configure os escopos OAuth 2.0 necessários, defina permissões para usuários, extraia o URL e o ID da instância, configure papéis e faça a autenticação para sincronizar dados entre o Jira Cloud e a Pesquisa do Vertex AI.

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)][confluence-oauth] na documentação para desenvolvedores da Atlassian.

1. Crie uma integração OAuth 2.0 no Atlassian Developer Console:

   1. Faça login no Atlassian Developer Console.
   2. Clique no ícone do perfil e selecione Console do desenvolvedor.
   3. Clique em Criar e selecione Integração OAuth 2.0.

   4. Digite um nome para o app e faça o seguinte:

      1. Marque a caixa de seleção "Termos e Condições".
      2. Clique em Criar.
      3. Clique em Autorização.
      4. Na tabela Tipo de autorização, selecione Adicionar para OAuth 2.0 (3LO).

   5. No campo URL de callback, insira https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html.

   6. Clique em Salvar alterações.

   Se você receber o aviso: Seu app não tem APIs. Adicionar APIs ao app, vá para a etapa 2 e conclua as etapas restantes. Caso contrário, pule para as etapas 4 e 5.

2. Ativar o OAuth 2.0:

   1. Selecione Permissões:

      1. Acesse a API da Jira.
      2. Clique em Adicionar.
      3. Clique em Configurar.
      4. Acesse a guia Alcances clássicos e clique em Editar escopos. Selecione os seguintes escopos:

         Conferir 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

   2. Confirme se oito escopos estão selecionados e salve as mudanças.

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

   1. Clique em Distribuição.

   2. Selecione Editar e faça o seguinte:

      1. Selecione Compartilhamento para permitir a edição de outros campos.
      2. Preencha os campos restantes.
      3. Selecione Sim quando aparecer Does your app store personal data?

   3. Selecione Configurações para copiar o ID do cliente e a chave secreta do cliente.

4. Acesse 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.

5. Acesse 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. Clique em Adicionar produto.
6. Na caixa de diálogo Adicionar produtos ao grupo, selecione Administrador de acesso do usuário como a função do produto.
7. Clique em Adicionar.
8. Na página Grupos, clique em Adicionar membros do grupo para adicionar usuários ou contas que o conector autentica.

Para que as permissões do usuário sejam aplicadas corretamente, cada usuário do Jira 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.

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, role a tela ou pesquise Jira Cloud para conectar a origem externa.

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

6. Insira o nome de usuário e a senha da instância.

7. Verifique se a autenticação foi bem-sucedida antes de retornar à página Especificar a fonte do Jira para o repositório de dados.

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

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

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

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

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

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

    Dependendo do tamanho dos dados, a ingestão pode levar de 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 Data Center local

Use este procedimento para criar um app de pesquisa e um repositório de dados do Jira Data Center no Agent Builder, sincronizando dados locais do Jira com a Vertex AI para Pesquisa.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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, verifique se você tem o seguinte:

1. Vinculação de serviço (obrigatório apenas para o tipo de destino particular): configure uma vinculação de serviço para a transferência segura de dados.
2. Nome de usuário e senha: receba credenciais válidas para autenticação do administrador do Jira.
3. Opcional para o tipo de destino particular: URL do domínio: especifique o URL da instância do Jira Data Center.
4. Opcional: Nome de domínio de base: informe o nome de domínio de base da instância do Jira.
5. Opcional: Porta de destino: identifique a porta usada para a comunicação com o data center do Jira.

6. Use as diretrizes de configuração a seguir para estabelecer conexões com o Private Service Connect(PSC). Ajuste ou adicione recursos conforme necessário. Verifique se o anexo de serviço do PSC está configurado corretamente para se conectar à instância particular e atende aos requisitos de um serviço publicado.

   1. Defina as configurações de rede:

      1. Coloque o anexo de serviço do PSC e o balanceador de carga em sub-redes diferentes na mesma rede de nuvem privada virtual.

      2. O sistema de back-end precisa permanecer fechado para a rede pública por motivos de segurança. No entanto, verifique se ele pode aceitar tráfego das seguintes origens:

         • Para balanceadores de carga baseados em proxy/HTTP(s) (ILB de proxy L4, ILB L7), configure o back-end para aceitar solicitações da sub-rede de proxy na rede de nuvem privada virtual.

         • Para mais informações, consulte a documentação Sub-redes somente proxy para balanceadores de carga baseados no Envoy.

   2. Ajuste as regras de firewall:

      1. Regras de entrada:

         • Permita o tráfego da sub-rede de vinculação do serviço do PSC para a sub-rede do balanceador de carga interno (ILB).
         • Verifique se o ILB pode enviar tráfego para o back-end.
         • Permitir que as sondagens de verificação de integridade alcancem o back-end.

      2. Regras de saída: ative o tráfego de saída por padrão, a menos que regras de negação específicas sejam aplicadas.

7. Considerações adicionais: mantenha todos os componentes, incluindo o anexo de serviço do PSC e o balanceador de carga, na mesma região.

Gerar um anexo de serviço

Siga estas etapas para gerar um anexo de serviço:

1. Definir o tipo de endpoint: selecione Público ou Particular.

2. Para o endpoint Público: se o tipo de destino do Jira Data Center for Público, não será necessário criar a configuração para o anexo de serviço. Em vez disso, use seu URL público no campo URL do domínio do console do Google Cloud.

3. Para o endpoint Particular:

   1. Use o PSC para permitir conexões de instâncias particulares para Google Cloud.
   2. Crie uma rede de nuvem privada virtual e as sub-redes necessárias.
   3. Crie uma instância de máquina virtual (VM) e instale o serviço de back-end.
   4. Opcional: configure uma sondagem de verificação de integridade para monitorar a integridade do back-end.
   5. Adicione um balanceador de carga para rotear o tráfego para a VM ou o back-end.
   6. Defina regras de firewall para permitir o tráfego entre o endpoint do PSC e o back-end.
   7. Publique o endpoint criando um anexo de serviço do PSC.

Criar um usuário do Jira Data Center e configurar permissões

Para permitir que a Pesquisa da Vertex AI receba dados do Jira, crie um novo usuário com as permissões mínimas necessárias. Siga estas etapas para criar o usuário e configurar as permissões necessárias.

1. Faça login como administrador:

   1. Acesse o site do seu domínio Atlassian e abra a instância do Jira Data Center.
   2. Digite o nome de usuário e a senha de administrador.
   3. Clique em Fazer login.

2. Crie um novo usuário:

   Ao criar um repositório de dados, você precisa criar um usuário para receber dados da instância de terceiros.

   1. Clique no ícone de configurações.
   2. Selecione Gerenciamento de usuários.
   3. Digite as credenciais de administrador, se solicitado.
   4. Na página Administração, clique em Criar usuário.
   5. Digite o endereço de e-mail, o nome completo, o nome de usuário e a senha.
   6. Clique em Criar usuário.

3. Atribuir um usuário a um grupo:

   1. Na página Administração, em Gerenciamento de usuários, clique em Grupos.
   2. Crie um grupo digitando um nome e clicando em Adicionar grupo.
   3. Selecione o grupo recém-criado.
   4. Clique em Adicionar/remover usuários.
   5. Clique no ícone de participante ao lado da caixa Adicionar membros aos grupos selecionados.
   6. Selecione o usuário recém-criado e clique em Salvar a seleção.
   7. Clique em Adicionar usuário selecionado para ver os novos usuários na seção "Membros do grupo".

   O usuário adicionado é atribuído na seção Membros do grupo.

4. Configure as permissões do usuário:

   1. Na página Administração, acesse a guia Problemas.
   2. Selecione Esquemas de permissões.
   3. Clique em Adicionar esquema de permissão.
   4. Digite um nome para o esquema e clique em Adicionar.
   5. Selecione o esquema e clique no ícone Permissão.
   6. Clique em Conceder permissão.
   7. Adicione as seguintes permissões, atribua-as ao grupo criado anteriormente e clique em Conceder:
      1. Procurar projetos.
      2. Procurar o arquivo de projetos.
   8. Adicione esse esquema a projetos em que os usuários do grupo precisam de acesso para visualizar o projeto, problemas, comentários, worklogs e anexos.

É possível adicionar esse esquema aos projetos em que os usuários do grupo precisam ter acesso para visualizar o projeto e as questões, comentários, registros de trabalho e anexos.

Configurar o acesso de aplicativos

1. Na página Administration, acesse a guia Applications.
2. Na guia Apps, selecione Acesso a apps.
3. Pesquise e selecione o grupo criado.
4. Verifique se o grupo aparece na lista de acesso.

O usuário é criado com acesso mínimo. Esse esquema é adicionado aos projetos. O administrador do Jira pode adicionar mais membros a esse grupo ou adicionar usuários a esse projeto.

Criar um conector local do Jira Data Center

Console

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 Data center do Jira para conectar a origem externa.

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

6. Na lista suspensa Tipo de destino, selecione Público ou Particular.

   1. Para o tipo de destino Público, não é necessário criar a configuração para o anexo de serviço. Em vez disso, use seu URL público no campo "URL do domínio" do console do Google Cloud.

   2. Para o tipo de destino Privado, insira todas as informações necessárias:

      1. Se a instância tiver um URL de domínio:
         • Anexo de serviço: insira o anexo de serviço.
         • Opcional: Nome de domínio de base: insira seu domínio de base.
         • URL do domínio: insira o URL do seu domínio.
         • Opcional: Porta de destino: insira a porta de destino.
      2. Se a instância não tiver um URL de domínio:
         • Anexo de serviço: insira o anexo de serviço.
         • Opcional: Porta de destino: insira a porta de destino.

7. Clique em Continuar.

8. Opcional: Opções avançadas: selecione e ative as Configurações de proxy e Configurações de SSL, se necessário.

9. Em Entidades para sincronizar, selecione todas as entidades necessárias e clique em Continuar.

10. Selecione uma região para o conector de dados e insira um nome.

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

Para o tipo de destino Privado, depois que você envia os detalhes do conector, o VAIS envia uma solicitação de conexão para o PSC. Acesse o conector para ver uma mensagem que permite adicionar um projectId à lista de permissões na PSC. O conector permanece no estado Erro até que você permita a conexão no PSC. Quando você aceita a solicitação de conexão, o conector muda para o estado Ativo durante a próxima execução de sincronização. Se você configurar o PSC para aceitar todas as conexões, o conector vai passar automaticamente para o estado Ativo após a criação.

No tipo de destino Público, o conector entra automaticamente no estado Ativo após o envio. Para verificar o estado do repositório de dados e a atividade de ingestão, faça o seguinte:

1. Navegue até o conector na lista de armazenamento de dados e monitore o estado dele até que mude para Ativo.
2. Depois que o estado do conector mudar para Ativo, clique na entidade necessária e confirme se todas as entidades selecionadas foram processadas. O estado do repositório de dados muda de Criação para Em execução quando a sincronização começa e muda para Ativo quando a ingestão é concluída, indicando que o repositório de dados está configurado. Dependendo do tamanho dos dados, a ingestão pode levar 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 é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Microsoft Outlook

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do Microsoft Outlook precisa gerar ou receber o seguinte para fazer a integração com a Vertex AI para Pesquisa:

   • ID do cliente
   • Chave secreta do cliente
   • Código do locatário

Criar um conector do Microsoft Outlook

Console

Para usar o console do Google Cloud e sincronizar dados do Microsoft Outlook 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 Microsoft Outlook para conectar a fonte externa.

5. Insira as informações de autenticação do Microsoft Outlook e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Microsoft Teams

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do Microsoft Teams precisa gerar ou receber o seguinte para fazer a integração com a Vertex AI para Pesquisa:

   • ID do cliente
   • Chave secreta do cliente
   • Código do locatário

Criar um conector do Microsoft Teams

Console

Para usar o console do Google Cloud e sincronizar dados do Microsoft Teams 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 Microsoft Teams para conectar a fonte externa.

5. Insira as informações de autenticação do Microsoft Teams e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Connect Monday

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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, verifique se você tem o URL do domínio, o acesso de administrador e o token da API.

Para gerar o URL da conta e o token de API, faça o seguinte:

1. Faça login no app Monday com sua conta de administrador.
2. Clique no ícone Perfil.
3. Selecione Administração.
4. Acesse a guia Geral e insira o Nome da conta e o URL da conta.
5. Volte ao ícone Perfil e selecione Desenvolvedores.
6. Na página Monday developer center, clique em My access tokens.
7. Clique em Mostrar para exibir o token.
8. Copie o token para usar na autenticação.

Criar um conector do Monday

Console

Para usar o console do Google Cloud e sincronizar dados da Monday 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. Na página Repositórios de dados, clique em Criar repositório de dados.

3. Na página Selecionar uma fonte de dados, role a tela ou pesquise Monday para conectar a origem externa.

4. Insira as informações de autenticação da Monday e clique em Continuar.

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

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

7. Insira um nome para o conector de dados.

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

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

10. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Notion

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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.

Atenção: esse conector oferece suporte parcial a ACLs. Durante a prévia particular, os domínios do usuário são verificados, mas a verificação granular do usuário não é aceita.

Antes de começar

Antes de configurar o conector:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

2. Um administrador do Notion precisa gerar ou receber o seguinte para integrar com a Vertex AI para Pesquisa:

   • Token de API da instância do Notion
   • ID do espaço de trabalho

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

Criar um conector do Notion

Console

Para usar o console do Google Cloud e sincronizar dados do Notion 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 Notion para conectar a fonte externa.

5. Insira as informações de autenticação do Notion e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, 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 Okta

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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 o conector, verifique se você tem o URL do domínio e acesso de administrador à instância do Okta. Siga as etapas abaixo para receber o URL da instância, o ID do cliente e o token da API do Okta.

1. Para receber o URL da instância do Okta, faça o seguinte:

   1. Faça login na página de login do Okta com suas credenciais de administrador.
   2. Clique no ícone do seu perfil ou acesse diretamente o Admin Console. O URL da sua instância do Okta aparece como o subdomínio na barra de endereço.

2. Para gerar o ID do cliente e o token de API, faça o seguinte:

   1. Faça login no URL da sua instância do Okta com sua conta de administrador.
   2. Acesse o Painel de controle do administrador.
   3. Clique no ícone Apps e selecione Apps.
   4. Clique em Criar integração de app.
   5. Selecione OIDC - OpenID Connect.
   6. Selecione Aplicativo da Web como o tipo de aplicativo e clique em Próxima.
   7. Digite um nome no campo Nome da integração do app.
   8. Role a tela até Atribuições e selecione Ignorar atribuição de grupo por enquanto.
   9. Clique em Salvar.
   10. Na janela Credenciais do cliente, clique em Editar.
   11. Selecione Chave pública / chave privada.
   12. Em Chave pública, clique em Adicionar chave.
   13. Clique em Gerar nova chave e em Concluído e Salvar.
   14. Uma caixa de diálogo vai aparecer. Clique em Salvar.
   15. Em Configurações gerais, clique em Editar.
   16. Selecione Credenciais do cliente e clique em Salvar.

Criar um conector do Okta

Console

Para usar o console do Google Cloud e sincronizar dados da Okta com a Vertex AI Search, 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 Okta para conectar a fonte externa.

5. Insira as informações de autenticação do Okta e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para 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:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

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

2. Tenha as seguintes informações de autenticação do OneDrive:

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

   2. Especifique escopos de acesso. É necessário ter 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.

   3. Configure os seguintes escopos:

      Acessar escopos

      • Files.Read.All (Application)
      • Group.Read.All (Application)
      • User.Read.All (Application)

Criar um conector do OneDrive

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, role a tela ou pesquise OneDrive para conectar a fonte externa.

5. Insira as 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 cria e exibe 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 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 vão aparecer depois que o app e o repositório de dados forem configurados, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Salesforce

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

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

2. Tenha as seguintes informações de autenticação. Para saber como configurar o ID e o segredo 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
   • ID do consumidor
   • Chave secreta do consumidor

Considere as seguintes limitações:

1. Use um plano Enterprise ou para desenvolvedores. Não é possível usar contas de teste.
2. Verifique se você está usando o Sales Cloud. O Service Cloud não é compatível.
3. Adicione Google Cloud à lista de permissões do CORS do Salesforce. Siga para a próxima etapa se você já tiver concluído esta tarefa.
   1. Siga as instruções na documentação do Salesforce para configurar a lista de permissões do CORS.
   2. Insira https://console.cloud.google.com/ como um URL de origem e salve a configuração.

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 cria e exibe 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 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 pesquisa da Vertex AI.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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, verifique se você tem o seguinte:

1. Instância do ServiceNow: siga as instruções na documentação do ServiceNow Developer para criar uma instância do ServiceNow.

2. Google Cloud project: configure um projeto Google Cloud com uma conta de administrador capaz de gerenciar configurações no nível da organização, garantindo que a organização possa configurar um pool de colaboradores.

3. Pool de funcionários: verifique se a sua organização está configurada para gerenciar um pool de funcionários.

Configurar o ServiceNow

A ServiceNow oferece dois sites principais:

1. Site principal do ServiceNow: o site da sua instância do ServiceNow.

   • Gerencia usuários, grupos e tarefas de administração do sistema.
   • URL: o URL da sua instância do ServiceNow.
   • Faça login usando suas credenciais de administrador.

2. Site para desenvolvedores:

   • Configura a base de conhecimento, configura fluxos de trabalho e desenvolve aplicativos personalizados.
   • URL: https://developer.service-now.com.
   • Faça login usando seu ID do ServiceNow.

Observação: para a configuração a seguir, use o site principal do ServiceNow para configurar o OAuth e as permissões.

Para criar um endpoint OAuth, faça o seguinte:

1. Faça login na instância principal do ServiceNow com privilégios de administrador.
2. Navegue até Todos > OAuth do sistema > Registro do aplicativo.
3. Clique em Novo e selecione Criar um endpoint da API OAuth para clientes externos. Extraia o ID e a chave secreta do cliente.

4. Preencha as informações necessárias:

   1. Nome: nome exclusivo.
   2. URL de redirecionamento: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html.

5. Clique em Enviar para criar a credencial.

6. Depois do envio, clique no nome para conferir o secret do cliente.

7. O secret é mascarado. Clique no ícone de cadeado ao lado dele para mostrar o secret.

8. Mantenha uma cópia do ID e da chave secreta do cliente para usar quando necessário.

9. Acesse developer.service-now.com e clique em Gerenciar senha da instância.

10. Mantenha uma cópia do nome de usuário e da senha para usar quando necessário.

11. Nesta fase, todas as cinco informações necessárias para configurar um repositório de dados do ServiceNow estão disponíveis. Se não houver problemas em usar a função de administrador para extrair dados, crie um repositório de dados.

Configurar funções e permissões

Você precisa ter uma função de administrador de segurança para criar e gerenciar usuários. Se você não tiver esse papel, eleve sua função para security_admin clicando em Elevar função no seu perfil. Selecione a função security_admin e clique em Atualizar. O papel security_admin é necessário para criar funções e gerenciar usuários.

1. Crie um papel personalizado com regras de ACL:

   1. Acesse Todos > Administração de usuários > Papéis.
   2. Clique em Nova para criar uma função.
   3. Selecione um nome e clique em Enviar.
   4. Navegue até Segurança do sistema > Controle de acesso (ACL) para criar uma nova regra de ACL.
   5. Clique em Nova para criar uma regra de ACL.
   6. Selecione uma função, como sys_user_role.
   7. Clique em Enviar e atribua a função.

   8. Repita esse processo até que todo o acesso à tabela seja concedido. O conector precisa ter acesso às seguintes tabelas para que cada entidade seja executada:

      1. Incidente: incident.
      2. Item de catálogo: sc_cat_item, sc_cat_item_user_criteria_mtom, sc_cat_item_user_criteria_no_mtom, sc_cat_item_user_mtom, sc_cat_item_user_no_mtom.
      3. Conhecimento: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom.
      4. Anexo: todos os itens listados.
      5. Identidade: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember, sys_user.
      6. Atualizado conforme novos critérios são extraídos: core_company, cmn_location, cmn_department.
      7. Critérios do usuário: user_criteria.

   9. Verifique se todas as ACLs foram atualizadas acessando sys_security_acl_role_list.do na barra de pesquisa.

   10. Selecione a função a ser verificada.

   11. Confirme se todas as ACLs necessárias foram atribuídas à função selecionada.

2. Conceda o papel a uma conta de serviço:

   1. Acesse Tudo > Administração de usuários > Usuários e selecione o usuário.
   2. Encontre e selecione o usuário para conceder a função.

3. Se nenhum usuário estiver disponível, acesse Segurança do sistema > Usuários e grupos > Usuários.

4. Clique em Nova para criar uma conta de serviço na tabela Usuário.

5. Marque a caixa de seleção Somente acesso ao serviço da Web.

6. Acesse a tabela Papéis na parte de baixo da página.

7. Clique em Editar à direita.

8. Conceda a função criada anteriormente e atribua-a ao usuário. Dependendo do tipo de função criada, selecione e atribua a função apropriada.

9. Acessar o nome de usuário e a senha do usuário. Na mesma página, clique em Definir senha.

10. Gerar uma senha automaticamente e salvá-la para uso futuro:

    1. ID do usuário: manager.
    2. Senha: digite a senha gerada automaticamente.

Configurar o pool de funcionários

Siga as instruções para configurar um pool de forças de trabalho com uma das seguintes configurações:

1. Configuração do Azure OIDC
2. Configuração do SAML do Azure
3. Configuração do Okta e do OIDC
4. Configuração do Okta e do SAML

Criar um conector 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 Selecione uma fonte de dados, role a tela ou pesquise ServiceNow para conectar a origem externa.

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

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

    Dependendo do tamanho dos dados, a ingestão pode levar de alguns 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 data center local do SharePoint

Use este procedimento para criar um app de pesquisa e um repositório de dados do SharePoint Data Center no Agent Builder, sincronizando dados locais do SharePoint com a Vertex AI para Pesquisa.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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, faça o seguinte:

1. Anexo de serviço (obrigatório apenas para o tipo de destino particular): siga as etapas abaixo para gerar um anexo de serviço para a transferência segura de dados.

   1. Definir o tipo de endpoint: selecione Público ou Particular.

   2. Para o endpoint Público: se o Destino do tipo do Data Center do SharePoint for Público, não será necessário criar a configuração para o anexo de serviço. Em vez disso, use seu URL público no campo URL do domínio do console do Google Cloud ao criar o conector.

   3. Para o endpoint Particular:

      1. Use o Private Service Connect (PSC) para ativar conexões de instâncias particulares para Google Cloud
      2. Crie uma rede de nuvem privada virtual e as sub-redes necessárias.
      3. Crie uma instância de máquina virtual (VM) e instale o serviço de back-end.
      4. Opcional: configure uma sonda de verificação de integridade para monitorar a integridade do back-end.
      5. Adicione um balanceador de carga para rotear o tráfego para a VM ou o back-end.
      6. Definir regras de firewall para permitir o tráfego entre o endpoint do PSC e o back-end
      7. Publicar o endpoint criando um anexo de serviço do PSC.

2. Nome de usuário e senha: receba credenciais válidas para autenticação do administrador do SharePoint.

3. Opcional para o tipo de destino particular: URL do domínio: mantenha o URL do domínio da instância do SharePoint Data Center se ela estiver por trás de um proxy ou de uma conexão SSL.

4. Opcional: Nome de domínio de base: informe o nome de domínio de base da instância do SharePoint.

5. Opcional: Porta de destino: identifique a porta usada para comunicação com o data center do SharePoint.

6. Use as diretrizes de configuração a seguir para estabelecer conexões com o Private Service Connect(PSC). Ajuste ou adicione recursos conforme necessário. Verifique se o anexo de serviço do PSC está configurado corretamente para se conectar à instância particular e atende aos requisitos de um serviço publicado.

   1. Defina as configurações de rede:

      1. Coloque o anexo de serviço do PSC e o balanceador de carga em sub-redes diferentes na mesma rede de nuvem privada virtual.

      2. O sistema de back-end precisa permanecer fechado para a rede pública por motivos de segurança. No entanto, verifique se ele pode aceitar tráfego das seguintes origens:

         • Para balanceadores de carga baseados em proxy/HTTP(s) (ILB de proxy L4, ILB L7), configure o back-end para aceitar solicitações da sub-rede de proxy na rede de nuvem privada virtual.

         • Para mais informações, consulte a documentação Sub-redes somente proxy para balanceadores de carga baseados no Envoy.

   2. Ajuste as regras de firewall:

      1. Regras de entrada:

         • Permita o tráfego da sub-rede de vinculação do serviço do PSC para a sub-rede do balanceador de carga interno (ILB).
         • Verifique se o ILB pode enviar tráfego para o back-end.
         • Permitir que as sondagens de verificação de integridade alcancem o back-end.

      2. Regras de saída: ative o tráfego de saída por padrão, a menos que regras de negação específicas sejam aplicadas.

7. Considerações adicionais: mantenha todos os componentes, incluindo o anexo de serviço do PSC e o balanceador de carga, na mesma região.

Criar um usuário do SharePoint Data Center

Para criar um usuário do SharePoint Data Center, solicite um nome de usuário e uma senha a um administrador. O administrador precisa seguir estas etapas para criar um novo usuário na instância do SharePoint Data Center.

1. Clique no menu Iniciar.
2. Navegue até Ferramentas administrativas do Windows > Usuários e computadores do Active Directory.
3. Inicie o aplicativo Usuários e computadores do Active Directory.
4. Abra sua unidade organizacional e navegue até o contêiner Usuários para adicionar o novo usuário.
5. Clique com o botão direito do mouse em Usuários e selecione Novo > Usuário.
6. Na caixa de diálogo Novo objeto: usuário:
   1. Insira Nome, Nome completo e Nome de logon do usuário.
   2. Clique em Próxima.
7. Na caixa de diálogo Novo objeto: usuário:
   1. Preencha as informações necessárias:
      1. Senha
      2. Confirmar senha
   2. Selecione as seguintes opções:
      1. O usuário não pode mudar a senha
      2. A senha nunca expira
   3. Clique em Próxima.
8. Clique em Concluir.
9. Localize o usuário criado na seção Usuários, clique duas vezes nele e selecione Propriedades.
10. Na caixa de diálogo Propriedades:
    1. Adicione um endereço de e-mail para o usuário.
    2. Clique em Aplicar.

Configurar a coleção de sites no SharePoint

1. Faça login no console do administrador do SharePoint.
2. Na página Administração central, navegue até Gerenciamento de aplicativos.
3. Clique em Criar coleções de sites.
4. Na página Criar uma coleção de sites, insira as informações necessárias nos campos Título e Descrição.
5. Na seção Endereço dos sites da Web, insira o nome do URL do site.
6. Na seção Administrador principal da coleção de sites, clique na opção Procurar ao lado do campo Nome do usuário.
7. Na caixa de diálogo Select people, insira o nome de usuário do administrador e clique no ícone search.
8. Selecione o usuário e clique em Ok. A página Site criado com sucesso aparece e o URL do site é exibido.
9. Copie o URL e abra em uma nova guia. O site vai aparecer.

Fazer login com o usuário criado

1. Use as credenciais do usuário criado para fazer login no site do SharePoint.
2. Verifique o acesso e as permissões do usuário.

Criar um conector local do data center do SharePoint

Console

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 Centro de dados do SharePoint para conectar a origem externa.

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

6. Na lista suspensa Tipo de destino, selecione Público ou Particular.

   1. No tipo de destino Público, não é necessário criar a configuração para o anexo de serviço. Em vez disso, use seu URL público no campo URL do domínio do console do Google Cloud.

   2. Para o tipo de destino Privado, insira todas as informações necessárias:

      1. Se a instância tiver um URL de domínio:
         • Anexo de serviço: insira o anexo de serviço.
         • Opcional: Nome de domínio de base: insira seu domínio de base.
         • URL do domínio: insira o URL do seu domínio.
         • Opcional: Porta de destino: insira a porta de destino.
      2. Se a instância não tiver um URL de domínio:
         • Anexo de serviço: insira o anexo de serviço.
         • Opcional: Porta de destino: insira a porta de destino.

7. Clique em Continuar.

8. Opcional: Opções avançadas: selecione e ative as Configurações de proxy e as Configurações de SSL, se necessário.

9. Em Entidades a serem sincronizadas, selecione todas as entidades necessárias para sincronização e clique em Continuar.

10. Selecione uma região para o conector de dados e insira um nome.

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

Para gerenciar os estados do conector, faça o seguinte:

1. Para o tipo de destino particular:

   1. Envie os detalhes do conector.
   2. O VAIS envia uma solicitação de conexão para a PSC.
   3. Navegue até o conector para ver uma mensagem de inclusão de uma projectId na lista de permissões do PSC.
   4. Permita a conexão no PSC:
      1. O conector permanece no estado Erro até que você aprove a solicitação.
      2. Após a aprovação, o conector muda para o estado Ativo na próxima execução de sincronização.
   5. Se o PSC estiver configurado para aceitar todas as conexões, o conector será movido automaticamente para o estado Ativo após a criação.

2. Para o tipo de destino público:

   1. Envie os detalhes do conector.
   2. O conector entra automaticamente no estado Ativo após o envio.

Para verificar o estado do repositório de dados e a atividade de ingestão, faça o seguinte:

1. Navegue até o conector na lista de armazenamentos de dados e monitore o estado dele até que mude para Ativo.
2. Depois que o estado do conector mudar para Ativo, clique na entidade necessária e confirme se todas as entidades selecionadas foram processadas. O estado do repositório de dados transita de Criação para Em execução quando a sincronização começa e muda para Ativo quando a ingestão é concluída, indicando que o repositório de dados está configurado. Dependendo do tamanho dos dados, a ingestão pode levar 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.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

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

2. 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 Entra.

3. Prepare as seguintes informações de autenticação do SharePoint Online para usar durante a configuração:

   1. URL da instância. No formulário http://DOMAIN_OR_SERVER/[sites/]WEBSITE.

   2. A autenticação federada exige o ID do locatário e do cliente, enquanto o OAuth exige o ID do locatário, do cliente e a 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 Entra.

   3. Ao registrar o aplicativo, use https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html como o URL do callback da Web.

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

   5. Ao configurar as permissões do aplicativo, adicione as seguintes permissões delegadas para a API REST do SharePoint:

      Acessar escopos

      • AllSites.FullControl

4. 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	Buscar o conteúdo de todas as entidades	Buscar ACL	Buscar 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: o administrador global não pode buscar entidades de identidade ou de comentários e anexos.
Proprietário do site	Não	Sim	Sim	Não	Limitação: o proprietário do site se relaciona com o centro de administração do Microsoft 365 / centro de administração do Entra, não é específico do SharePoint.
Administrador do aplicativo	Sim	N/A	N/A	N/A	A função de administrador do aplicativo está relacionada à Central de administradores do Microsoft 365 / Central de administradores do Entra. Ele não é específico do Sharepoint.

Use esse método para controlar de forma granular as permissões da API REST do SharePoint, permitindo restringir o acesso a recursos na conta de usuário. Crie um novo usuário do SharePoint, o que pode aumentar os custos de licenciamento. Use o método Token de atualização do OAuth 2.0 para configurar um registro de aplicativo do Entra e ativar o acesso seguro ao SharePoint.

Configurar o registro do aplicativo Entra

Configure um registro de aplicativo do Entra para permitir o acesso seguro ao SharePoint. Escolha entre credenciais federadas para acesso baseado em token ou token de atualização do OAuth 2.0 para controle granular. Siga as etapas abaixo para configurar o registro do app, conceder permissões e estabelecer a autenticação.

1. Credenciais federadas: configure credenciais federadas para permitir que o Google acesse o SharePoint com segurança usando tokens assinados criptograficamente, evitando a necessidade de um usuário principal real. Para configurar permissões e conceder acesso, faça o seguinte:

   1. Receba o ID do cliente da conta de serviço:

      1. No Console do Google Cloud, acesse a página Criador de agentes.
      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 SharePoint Online para conectar a origem externa.
      5. Anote o Identificador do assunto.

   2. Registre o app no Microsoft Entra:

      1. Acesse a Central do administrador do Entra.

      2. Crie um registro de app:

         • Tipos de conta com suporte: somente contas no diretório organizacional.
         • Mantenha as outras configurações padrão e clique em Registrar.

      3. Anote o ID do cliente e o ID do locatário.

   3. Adicionar credenciais federadas:

      1. Acesse Certificados e secrets > Credenciais federadas > Adicionar credencial.

      2. Use as seguintes configurações:

         • Emissor: https://accounts.google.com
         • Identificador do assunto: use o identificador do assunto indicado.
         • Nome: informe um nome exclusivo.

      3. Clique em Adicionar para conceder acesso.

   4. Defina as permissões da API:

      1. Adicione e conceda o consentimento do administrador para as seguintes permissões:

         • GroupMember.Read.All (aplicativo): ler todas as associações a grupos.
         • Sites.Read.All (aplicação): leia todos os sites.
         • User.Read.All (aplicativo): ler os perfis completos de todos os usuários.
         • Sites.FullControl.All (aplicativo): controle total sobre todos os sites.

      2. Use Sites.Selected para atribuir permissões específicas do site em vez de Sites.FullControl.All. O Sites.Selected não pode ser configurado diretamente pela interface. Depois de selecionar Sites.Selected, é necessário chamar a API Microsoft Graph para conceder explicitamente o papel de controle total ao aplicativo para os sites que você quer rastrear.

      3. Conceda Sites.Read.All para rastrear todos os subsites em um URL de site raiz.

2. Token de atualização do OAuth 2.0: configure a autenticação OAuth 2.0 usando um segredo do cliente e um token de atualização do usuário do SharePoint para ativar o controle granular sobre o acesso à API do SharePoint. Para configurar o registro do app, adicionar um segredo de cliente e atribuir permissões de API, faça o seguinte:

   1. Criar registro do app:

      1. Acesse a Central do administrador do Entra.

      2. Crie um registro de app:

         • Tipos de conta com suporte: somente contas no diretório organizacional.
         • URI de redirecionamento: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

      3. Anote o ID do cliente e o ID do locatário.

   2. Adicionar a chave secreta do cliente:

      1. Acesse Certificados e chaves secretas > Nova chave secreta do cliente.

      2. Anote a string secreta.

   3. Defina as permissões da API:

      1. Adicione e conceda o consentimento do administrador para as seguintes permissões:

         • GroupMember.Read.All: ler todas as associações a grupos.
         • Sites.FullControl.All: controle total de todas as coleções de sites.
         • User.Read.All: ler os perfis completos de todos os usuários.
         • AllSites.FullControl: controle total sobre todos os sites.

      2. Use uma conta de usuário dedicada com acesso limitado a sites específicos.

      3. Verifique se a conta tem acesso de proprietário aos sites selecionados.

Criar um conector do SharePoint Online

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, role a tela ou pesquise SharePoint Online para conectar a origem externa.

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

6. Insira o URL do site do SharePoint:

   • Para um único site: https://<domain_name>.sharepoint.com/sites/<site_name>.
   • Para todos os sites de primeiro nível: https://<domain_name>.sharepoint.com.

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 cria e exibe 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 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.

Testar o mecanismo de pesquisa

Depois de configurar o mecanismo de pesquisa, teste os recursos dele. Isso garante resultados precisos com base no acesso do usuário.

1. Ativar o app da Web:

   1. Acesse as configurações de integração do app e ative a opção Ativar o app da Web.

2. Testar o app da Web:

   1. Clique em Abrir ao lado do link do app da Web e faça login com um usuário do seu pool de recursos humanos.

   2. Verifique se os resultados da pesquisa estão restritos a itens acessíveis pelo usuário conectado.

Observação: se você tiver problemas para fazer login com um ID da Microsoft, verifique se o usuário foi adicionado aos usuários do aplicativo Enterprise no Microsoft Entra.

Configurar o pool de funcionários

Com o pool de força de trabalho, você pode gerenciar e autenticar usuários de provedores de identidade externos, como o Azure ou o Okta, no console do Google Cloud. Para configurar o pool de forças de trabalho e ativar o app da Web para acesso sem problemas do usuário, faça o seguinte:

1. Crie um pool de força de trabalho no nível da organização em Google Cloud seguindo o manual de configuração apropriado:

   1. Configuração do Azure OIDC
   2. Configuração do SAML do Azure
   3. Configuração do Okta e do OIDC
   4. Configuração do Okta e do SAML

2. Configure o pool de força de trabalho em Agent Builder > Configurações para a região em que você criou o app.

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:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

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

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

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

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

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

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

4. 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 bot (gerar um token de bot) ou usuário (gerar um token de usuário) com base no seu requisito.

1. Gere um token de bot para acessar com segurança canais particulares, mensagens instantâneas (IMs, na sigla em inglês) e mensagens instantâneas multiparte (MPIMs, na sigla em inglês). O token do bot não pode rastrear os canais públicos dos quais não faz parte, e a adesão a canais públicos gera uma mensagem de adesã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.

   1. Para ativar o rastreamento, faça o seguinte:

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

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

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

2. Gerar um token de usuário para acessar todos os canais públicos sem se inscrever primeiro. 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 cria e exibe 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 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 Trello

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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

Atenção: esse conector oferece suporte parcial a ACLs. Durante a prévia particular, os domínios do usuário são verificados, mas a verificação granular do usuário não é aceita.

Antes de começar

Antes de configurar o conector, siga estas etapas:

1. Verifique se você tem acesso de administrador ao Trello. Um administrador do Trello precisa gerar uma chave e um token de API na seção a seguir.
2. Verifique se o projeto foi adicionado à lista de permissões para usar o Trello.
3. 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.

Um administrador do Trello precisa realizar as seguintes etapas:

1. Gere uma chave de API no Trello:

   1. Faça login na instância do Trello usando as credenciais de usuário de teste fornecidas no Trello.

   2. Na página Administrador dos Power-ups do Trello, navegue até Acesso ao administrador do Power-up.

   3. Clique em Novo para criar um novo power-up.

   4. Preencha os detalhes necessários:

      Observação: o URL do conector de iframe é necessário apenas se você quiser criar um Power-up. Caso contrário, deixe o campo em branco.

   5. Clique em Próxima para continuar e gerar uma chave de API. Copie a chave e o secret da API.

2. Gere um token da API no Trello:

   1. Clique no link Generate token à direita para gerar um token da API.

      1. Clique em Permitir para conceder acesso ao token da API.
      2. Verifique se todas as entidades necessárias têm as permissões corretas no escopo.

   2. Copie o token da API gerado. Use esse token para o conector do Trello na Vertex AI Search.

Para mais informações sobre a API do Trello, consulte Introdução à API.

Criar um conector do Trello

Console

Para usar o console do Google Cloud e sincronizar dados do Trello 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 Trello para conectar a fonte externa.

5. Insira as informações de autenticação do Trello e clique em Continuar.

6. Opcional: para rotear o tráfego HTTP, clique em Adicionar destino e insira o nome do host ou o endereço IP do servidor proxy. Em seguida, clique em Continuar.

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 conector de dados.

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

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

12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o WordPress

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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.

Atenção: não há suporte para o controle de acesso do WordPress.

Antes de começar

Antes de configurar a conexão, verifique se você tem o seguinte:

• Nome de usuário e senha: obtenha as credenciais do administrador do WordPress.
• URL do site: use esse URL para a criação de repositórios de dados.

Criar um usuário do WordPress

Para criar um usuário do WordPress, solicite um nome de usuário e uma senha a um administrador. O administrador precisa fazer login e seguir estas etapas para criar um novo usuário na instância do WordPress.

1. Faça login como administrador:

   1. Acesse a plataforma de hospedagem e faça login com suas credenciais de administrador para acessar o site do WordPress.
   2. Clique no ícone Site.
   3. Clique em Administrador do WordPress no seu site.

2. Crie um novo usuário:

   1. Na página Administrador do WordPress, navegue até a guia Usuários.
   2. Clique em Adicionar novo.
   3. Preencha todos os detalhes necessários, incluindo:
      • Nome de usuário
      • Endereço de e-mail
      • Opcional: nome e sobrenome
      • Papel
      • Senha (se solicitado)
   4. Clique em Adicionar novo usuário para salvar as mudanças.

Criar um conector do WordPress

Console

Para usar o console do Google Cloud e sincronizar dados do WordPress 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 WordPress para conectar a fonte externa.

5. Insira as informações de autenticação do WordPress e clique em Continuar.

6. No campo URL, digite o URL do site do WordPress e clique em Continuar.

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 conector de dados.

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

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

12. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Workday

Use o procedimento a seguir para sincronizar dados do Workday com a Vertex AI Search.

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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.

Atenção: não há suporte para o controle de acesso do Workday.

Antes de começar

Antes de criar um conector do Workday:

1. Um administrador do Workday precisa gerar ou receber o seguinte para integrar com a Vertex AI para Pesquisa:

   1. ID do cliente. Acesse a página "Visualizar clientes de API" no Workday.
   2. Chave secreta do cliente. Acesse a página "Visualizar clientes de API" no Workday.
   3. Token de atualização. Acesse a página "View API Clients" no Workday.
   4. Opcional: servidor proxy. O nome do host ou o endereço IP de um proxy para rotear o tráfego HTTP.
   5. Opcional: URL base. O URL de base da conexão do Workday.
   6. Opcional: URL da API. O URL completo para o endpoint da API a ser usado para fazer solicitações SOAP. Por exemplo: https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>
   7. Locatário do Workday. O locatário da conta. Por exemplo, abc_cms1 Você pode conferir o nome do locatário nos detalhes de configuração da instância do Workday.

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

Criar um conector do Workday

Console

Para usar o console do Google Cloud e sincronizar dados do Workday 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 Workday para conectar a fonte externa.

5. Insira as informações de autenticação do Workday e clique em Continuar.

6. Opcional: insira as informações de destino do Workday e clique em Continuar.

7. Insira seu locatário do Workday e clique em Continuar.

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

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

10. Insira um nome para o conector de dados.

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

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

13. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.

Conectar o Zendesk

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

Pré-lançamento:você precisa estar na lista de permissões para usar os conectores de terceiros.

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:

1. Além da lista de permissões de conectores de terceiros, esse conector exige que seu projeto seja adicionado a outra lista de permissões. Para ser adicionado a essa lista de permissões, entre em contato com a equipe da sua conta da Vertex AI para Pesquisa.

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

3. Um administrador do Zendesk precisa gerar ou receber o seguinte para fazer a integração com a Vertex AI Search:

   1. Token de acesso. Token da API da sua instância do Zendesk.
   2. URI da instância.

Criar um conector do Zendesk

Console

Para usar o console do Google Cloud e sincronizar dados do Zendesk 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 Zendesk para conectar a fonte externa.

5. Insira as informações de autenticação do Zendesk e clique em Continuar.

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 conector de dados.

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

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

11. Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 conector a um app, crie um app e selecione o conector seguindo as etapas em Criar um app de pesquisa.

• Para conferir como os resultados da pesquisa aparecem depois que o app é configurado, consulte Receber resultados da pesquisa. Se você usou o controle de acesso de terceiros, consulte Prévia de resultados para apps com controle de acesso de terceiros.