Nesta página, descrevemos como conectar fontes de dados de terceiros à Vertex AI Search.
Quando você conecta uma fonte de dados de terceiros, a Vertex AI para Pesquisa cria um conector de dados e associa repositórios de dados (chamados entidade) a ele para as entidades especificadas. Os tipos de entidade são específicos da fonte de dados à qual você está se conectando. Por exemplo, as entidades do Jira Cloud incluem problemas, anexos, comentários e registros de trabalho.
As fontes de dados de terceiros estão disponíveis apenas para apps de pesquisa genérica. Apps de chat, recomendações e agentes não podem usar fontes de dados de terceiros.
Os conectores de terceiros não são compatíveis com CMEK.
Para importar dados de uma origem de dados do Google, consulte Criar uma loja de dados de pesquisa.
Antes de começar
Entre em contato com a equipe da sua Conta do Google e peça para ser adicionado à lista de permissões para conectores de fontes de dados de terceiros.
Acesse a seção da fonte que você planeja usar:
- Conectar o Adobe Experience Manager
- Connect AODocs (lista de permissões adicional)
- 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
- 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)
- Connect Notion (lista de permissões adicional)
- Conectar o OneDrive
- Conectar o Salesforce
- Conectar o ServiceNow
- Conectar o SharePoint Online
- Conectar o Slack
- Conectar o Trello
- Connect Workday (lista de permissões adicional)
- 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 Adobe Experience Manager precisa gerar ou receber o seguinte para fazer a integração 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Adobe Experience Manager para conectar a fonte externa.
Insira as informações de autenticação do Adobe Experience Manager e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 AODocs
Use o procedimento a seguir para sincronizar dados do AODocs com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise AODocs para conectar a fonte externa.
Insira as informações de autenticação do AODocs e clique em Autenticar. Uma nova janela vai aparecer.
Autentique sua conta e confirme se ela foi bem-sucedida antes de retornar à página Especificar a origem do AODocs para seu repositório de dados.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.
Caixa de conexão
Use o procedimento a seguir para sincronizar dados do Box com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.
Tenha as seguintes informações de autenticação do Box. Para informações sobre como configurar esses parâmetros, consulte Autenticação JWT na documentação para desenvolvedores do Box.
- ID corporativo
- ID do cliente
- Chave secreta do cliente
- ID da chave pública
- Chave privada
- Senha longa
Ao criar o endpoint JWT, configure os seguintes escopos:
As mudanças incrementais de comentários podem levar mais tempo para sincronizar do que o intervalo de frequência configurado. Se uma pasta que contém uma entidade for copiada ou movida, as mudanças incrementais podem levar mais tempo para sincronizar do que o intervalo de frequência configurado.
Criar um app do Box
- Faça login no Console do desenvolvedor do Box com sua conta de administrador.
- Clique em Criar novo app.
- Selecione o tipo App personalizado.
- Digite o Nome do app.
- Defina o propósito do app: integração, IA ou Google Cloud Agent Builder.
- Escolha Autenticação do servidor com JWT.
Configurar o app Box
Configure as configurações do app Box criando uma chave pública/privada:
- Acesse o console para desenvolvedores do Box.
Na guia Configuração, clique em Gerar um par de chaves pública/privada.
- A chave pública é enviada automaticamente ao console com um ID. Esse ID é usado ao criar uma conexão.
- Um arquivo de configuração com a chave privada e a senha longa pode ser transferido para o dispositivo. Mantenha esse arquivo de configuração para uso posterior.
- Se preferir, consulte o guia de configuração de pares de chaves do Box para gerar sua própria chave.
Configurar as permissões necessárias: na seção Escopos do aplicativo, selecione Ler todos os arquivos e pastas armazenados no Box.
- Na guia Autorização, clique em Revisar e enviar e aguarde a aprovação do administrador.
- Os administradores podem aprovar o app no Admin Console.
Após a autorização, a Box configura o app por completo.
Criar um conector do Box
Console
Para usar o console do Google Cloud e sincronizar dados do Box com a Vertex AI para Pesquisa, siga estas etapas:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecione uma fonte de dados, role a tela ou pesquise Box para conectar a origem externa.
Insira suas informações de autenticação.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecione uma fonte de dados, role a tela ou pesquise Coda para conectar a fonte externa.
Insira as informações de autenticação da Coda e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.
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 acesso de administrador à instância e ao projeto do Confluence.
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.
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.
Crie uma integração OAuth 2.0 no Atlassian Developer Console:
- Faça login no Atlassian Developer Console.
- Clique no ícone do perfil e selecione Atlassian Developer Console.
- Clique em Criar e selecione Integração OAuth 2.0.
- Digite um nome para o app e faça o seguinte:
- Marque a caixa de seleção "Termos e Condições".
- Clique em Criar.
- Clique em Autorização.
- Na tabela Tipo de autorização, selecione Adicionar para OAuth 2.0 (3LO).
- No campo URL de callback, insira
https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html
. - 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.
Ativar o OAuth 2.0:
- Clique em Permissões.
- Acesse a API Confluence.
- Clique em Adicionar.
- Clique em Configurar.
- Acesse a guia Escopos granulares e clique em Editar escopos.
- Selecione os seguintes escopos.
- Confirme se sete escopos estão selecionados e salve as alterações.
Receba o ID e a chave secreta do cliente:
- Clique em Distribuição.
- Selecione Editar.
- Selecione Compartilhamento para permitir a edição de outros campos.
- Preencha os campos restantes.
- Selecione Sim quando aparecer
Does your app store personal data?
- Selecione Configurações para copiar o ID do cliente e a Chave secreta do cliente.
Acesse o URL da instância:
- Acesse atlassian.net e faça login com sua conta de administrador.
- Selecione o app que você quer sincronizar. Por exemplo, sincronize o primeiro app.
- Encontre o URL da instância. Ele aparece como o subdomínio na barra de endereço.
Acesse o ID da instância:
- Abra uma nova guia, copie o URL da instância e adicione
/_edge/tenant_info
a ele. Por exemplo,https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
. - Acesse o link para encontrar o valor de
cloudId
.cloudId
é o ID da instância.
- Abra uma nova guia, copie o URL da instância e adicione
Configurar permissões e funções
- Faça login em atlassian.com com sua conta de administrador.
- Clique no ícone de menu ou acesse admin.atlassian.com.
- Na página Administrador, clique em Gerenciar usuários e acesse a página Grupos.
- Acesse o site do seu domínio do Atlassian e abra a instância do Confluence Cloud.
- Acesse o IAM.
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.
Conceder a função de administrador a um usuário:
- Crie uma conta de usuário dedicada. Use essa conta para configurar o repositório de dados.
- Atribua a função de administrador ao novo usuário.
Configure as permissões no Atlassian:
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.
Clique no ícone de menu e selecione a opção necessária.
Opcional: se solicitado, selecione a organização adequada na página de destino.
Criar e configurar grupos:
- Na página Administrador, clique no botão Gerenciar usuários, se necessário, e selecione Gerenciar usuários na lista suspensa.
- Na página Gerenciamento de usuários, selecione Grupos.
- Clique em Criar grupo e atribua um nome. Use esse grupo para atribuir as permissões necessárias pelo conector.
Adicione permissões ao grupo: atribua a função Administrador de acesso do usuário.
Atribuir participantes ao grupo:
- 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.
- Clique em Adicionar para confirmar a atribuição de função.
- 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Confluence para conectar a fonte externa.
Insira suas informações de autenticação e clique em Autenticar.
Uma nova janela será aberta. Insira o nome de usuário e a senha da instância. Verifique se a autenticação foi bem-sucedida antes de retornar à página Especificar a origem do Confluence para o repositório de dados.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o conector de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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.
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:
- Vinculação de serviço (obrigatória apenas para o tipo de destino privado): configure uma vinculação de serviço para a transferência segura de dados.
- Nome de usuário e senha: receba credenciais válidas para autenticação do administrador do Confluence.
- Opcional para o tipo de destino particular: URL do domínio: especifique o URL da instância do Confluence Data Center.
- Opcional: Nome de domínio de base: informe o nome de domínio de base da instância do Confluence.
- Opcional: Porta de destino: identifique a porta usada para a comunicação com o Confluence Data Center.
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.
Defina as configurações de rede:
Coloque o anexo de serviço do PSC e o balanceador de carga em sub-redes diferentes na mesma rede de nuvem privada virtual.
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.
Ajuste as regras de firewall:
Regras de entrada:
- Permita o tráfego da sub-rede de anexo 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.
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.
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:
Definir o tipo de endpoint: selecione Público ou Particular.
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.
Para o endpoint Particular:
Use o Private Service Connect (PSC) para ativar conexões de instâncias particulares para o Google Cloud.
Crie uma rede de nuvem privada virtual e as sub-redes necessárias.
Crie uma instância de máquina virtual (VM) e instale o serviço de back-end.
Opcional: configure uma sondagem de verificação de integridade para monitorar a integridade do back-end.
Adicione um balanceador de carga para rotear o tráfego para a VM ou o back-end.
Defina regras de firewall para permitir o tráfego entre o endpoint do PSC e o back-end.
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.
Faça login como administrador:
- Acesse o site do seu domínio da Atlassian e abra a instância do Confluence Data Center.
- Digite o nome de usuário e a senha do administrador.
- Clique em Fazer login.
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.
- Clique no ícone de configurações.
- Selecione Gerenciamento de usuários.
- Digite as credenciais de administrador, se solicitado.
- Na página Administração, clique em Criar usuário.
- Digite o endereço de e-mail, nome completo, nome de usuário e senha.
- Clique em Criar usuário.
Atribuir um usuário a um grupo:
- Na página Administração do Confluence, navegue até a guia "Usuários e segurança" e clique em Grupos.
- Clique em Adicionar grupo. Digite um nome para o grupo e crie-o.
- No campo Encontrar grupo, digite o nome do grupo que você quer encontrar.
- Clique no ícone de configurações.
- Selecione a conta de perfil e acesse Gerenciamento de usuários.
- Na página Usuários, em Listar usuários, procure o usuário recém-criado no campo Encontrar usuário.
- Clique no usuário para abrir a página Visualizar usuários.
- Clique em Editar grupos para abrir a página Editar grupo de usuários.
- Marque a caixa de seleção do grupo de usuários criado.
- 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.
Configure as permissões do usuário:
- Na página Administração do Confluence, navegue até a guia Issues.
- Localize Permissões.
- Selecione Ver permissões globais.
- Selecione Editar permissões.
- 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
- Clique no ícone Confluence para acessar a página Painel.
- Clique em Criar espaço.
- Selecione Espaço de documentação e clique em Próxima.
- Insira todos os detalhes necessários e clique em Criar para criar o espaço de documentação.
- Em Meus espaços, clique no espaço recém-criado.
- Acesse Páginas e abra o menu (três pontos).
- Selecione Restrições.
- No menu suspenso Restrições, selecione a opção Visualização e edição restritas.
- Pesquise o grupo e atribua a permissão pode visualizar.
- Clique em Aplicar. O usuário é criado com acesso mínimo e as permissões são definidas para os espaços. Também é possível atribuir permissões aos blogs.
Criar um conector do Confluence Data Center local
Console
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecione uma fonte de dados, role a tela ou pesquise Data center do Confluence para conectar a origem externa.
Insira suas informações de autenticação e clique em Continuar.
Na lista suspensa Tipo de destino, selecione Público ou Particular.
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.
Para o tipo de destino Privado, insira todas as informações necessárias:
- Por exemplo, com o URL do 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.
- Por exemplo, sem o URL do domínio:
- Anexo de serviço: insira o anexo de serviço.
- Opcional: Porta de destino: insira a porta de destino.
- Por exemplo, com o URL do domínio:
Clique em Continuar.
Opcional: Opções avançadas: selecione e ative as Configurações de proxy e Configurações de SSL, se necessário.
Em Entidades a serem sincronizadas, selecione todas as entidades necessárias e clique em Continuar.
Selecione uma região para o conector de dados e insira um nome.
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:
- Navegue até o conector na lista de repositório de dados e monitore o estado dele até que mude para Ativo.
- 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Configure o controle de acesso para sua fonte de dados. Para mais informações, consulte Usar o controle de acesso à fonte de dados.
Tenha as seguintes informações de autenticação do Dropbox. Para informações sobre como configurar esses parâmetros, consulte o guia OAuth na documentação do Dropbox.
- ID do cliente
- Chave secreta do cliente
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Dropbox para conectar a origem externa.
Insira suas informações de autenticação do Dropbox e clique em Autenticar. Uma nova janela será aberta.
Autentique sua conta e confirme se ela foi bem-sucedida antes de retornar à página Especificar a origem do Dropbox para o repositório de dados.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione um local para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada. 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 estiverem 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.
Dynamics 365 para Conectar
Use o procedimento a seguir para sincronizar dados do Dynamics 365 com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de criar um conector do Dynamics 365:
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
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Dynamics 365 para conectar a origem externa.
Insira as informações de autenticação do Dynamics 365 e clique em Continuar.
Insira o URL do locatário e da organização do Azure e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 GitHub
Use o procedimento a seguir para sincronizar dados do GitHub com a Vertex AI Search.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 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 e sincronizar dados do GitHub com a Vertex AI para Pesquisa, siga estas etapas:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise GitHub para conectar a fonte externa.
Insira suas informações de autenticação do GitHub e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise GitLab para conectar a fonte externa.
Insira as informações de autenticação do GitLab e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.
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 acesso de administrador à instância e ao projeto do Jira.
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.
Configurar a autenticação e as permissões no Jira
Verifique se você tem os detalhes de autenticação necessários e acesso de administrador à sua instância do Jira. 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 Jira 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.
Crie uma integração OAuth 2.0 no Atlassian Developer Console:
- Faça login no Atlassian Developer Console.
- Clique no ícone do perfil e selecione Console do desenvolvedor.
- Clique em Criar e selecione Integração OAuth 2.0.
- Digite um nome para o app e faça o seguinte:
No campo URL de callback, insira
https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html
.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.
Ativar o OAuth 2.0:
- Selecione Permissões:
- Acesse a API da Jira.
- Clique em Adicionar.
- Clique em Configurar.
- Acesse a guia Alcances clássicos e clique em Editar escopos. Selecione os seguintes escopos:
- Acesse a guia Escopos granulares e clique em Editar escopos. Selecione os seguintes escopos:
- Confirme se oito escopos estão selecionados e salve as mudanças.
Receba o ID e a chave secreta do cliente:
- Clique em Distribuição.
Selecione Editar e faça o seguinte:
- Selecione Compartilhamento para permitir a edição de outros campos.
- Preencha os campos restantes.
- Selecione Sim quando aparecer
Does your app store personal data?
Selecione Configurações para copiar o ID do cliente e a chave secreta do cliente.
Acesse o URL da instância:
- Acesse atlassian.net e faça login com sua conta de administrador.
- Selecione o app que você quer sincronizar. Por exemplo, sincronize o primeiro app.
- Encontre o URL da instância, que é o subdomínio na barra de endereço.
Acesse o ID da instância:
- Abra uma nova guia, copie o URL da instância e adicione
/_edge/tenant_info
a ele. Por exemplo,https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
. - Acesse o link para encontrar o valor de
cloudId
.cloudId
é o ID da instância.
- Abra uma nova guia, copie o URL da instância e adicione
Configurar permissões e funções
- Faça login em atlassian.com com sua conta de administrador.
- Clique no ícone de menu no canto superior esquerdo ou acesse admin.atlassian.com.
- Na página Administrador, clique em Gerenciar usuários e acesse a página Grupos.
- Clique em Criar grupo. Digite um nome para o grupo e crie-o.
- Clique em Adicionar produto.
- Na caixa de diálogo Adicionar produtos ao grupo, selecione Administrador de acesso do usuário como a função do produto.
- Clique em Adicionar.
- 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Jira Cloud para conectar a origem externa.
Insira suas informações de autenticação e clique em Autenticar.
Insira o nome de usuário e a senha da instância.
Verifique se a autenticação foi bem-sucedida antes de retornar à página Especificar a fonte do Jira para o repositório de dados.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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.
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:
- 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.
- Nome de usuário e senha: receba credenciais válidas para autenticação do administrador do Jira.
- Opcional para o tipo de destino particular: URL do domínio: especifique o URL da instância do Jira Data Center.
- Opcional: Nome de domínio de base: informe o nome de domínio de base da instância do Jira.
- Opcional: Porta de destino: identifique a porta usada para a comunicação com o data center do Jira.
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.
Defina as configurações de rede:
Coloque o anexo de serviço do PSC e o balanceador de carga em sub-redes diferentes na mesma rede de nuvem privada virtual.
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.
Ajuste as regras de firewall:
Regras de entrada:
- Permita o tráfego da sub-rede de anexo 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.
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.
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:
Definir o tipo de endpoint: selecione Público ou Particular.
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.
Para o endpoint Particular:
Use o PSC para ativar conexões de instâncias particulares para o Google Cloud.
Crie uma rede de nuvem privada virtual e as sub-redes necessárias.
Crie uma instância de máquina virtual (VM) e instale o serviço de back-end.
Opcional: configure uma sondagem de verificação de integridade para monitorar a integridade do back-end.
Adicione um balanceador de carga para rotear o tráfego para a VM ou o back-end.
Defina regras de firewall para permitir o tráfego entre o endpoint do PSC e o back-end.
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.
Faça login como administrador:
- Acesse o site do seu domínio Atlassian e abra a instância do Jira Data Center.
- Digite o nome de usuário e a senha do administrador.
- Clique em Fazer login.
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.
- Clique no ícone de configurações.
- Selecione Gerenciamento de usuários.
- Digite as credenciais de administrador, se solicitado.
- Na página Administração, clique em Criar usuário.
- Digite o endereço de e-mail, nome completo, nome de usuário e senha.
- Clique em Criar usuário.
Atribuir um usuário a um grupo:
- Na página Administração, em Gerenciamento de usuários, clique em Grupos.
- Crie um grupo digitando um nome e clicando em Adicionar grupo.
- Selecione o grupo recém-criado.
- Clique em Adicionar/remover usuários.
- Clique no ícone de participante ao lado da caixa Adicionar participantes aos grupos selecionados.
- Selecione o usuário recém-criado e clique em Salvar a seleção.
- 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.
Configure as permissões do usuário:
- Na página Administração, acesse a guia Problemas.
- Selecione Esquemas de permissões.
- Clique em Adicionar esquema de permissão.
- Digite um nome para o esquema e clique em Adicionar.
- Selecione o esquema e clique no ícone Permissão.
- Clique em Conceder permissão.
- Adicione as seguintes permissões, atribua-as ao grupo criado anteriormente e clique em Conceder:
- Procurar projetos.
- Procurar o arquivo de projetos.
- 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.
Configurar o acesso de aplicativos
- Na página Administration, acesse a guia Applications.
- Na guia Apps, selecione Acesso a apps.
- Pesquise e selecione o grupo criado.
- 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
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecione uma fonte de dados, role a tela ou pesquise Data center do Jira para conectar a origem externa.
Insira suas informações de autenticação e clique em Continuar.
Na lista suspensa Tipo de destino, selecione Público ou Particular.
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.
Para o tipo de destino Privado, insira todas as informações necessárias:
- Por exemplo, com o URL do 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.
- Por exemplo, sem o URL do domínio:
- Anexo de serviço: insira o anexo de serviço.
- Opcional: Porta de destino: insira a porta de destino.
- Por exemplo, com o URL do domínio:
Clique em Continuar.
Opcional: Opções avançadas: selecione e ative as Configurações de proxy e Configurações de SSL, se necessário.
Em Entidades a serem sincronizadas, selecione todas as entidades necessárias e clique em Continuar.
Selecione uma região para o conector de dados e insira um nome.
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:
- Navegue até o conector na lista de repositório de dados e monitore o estado dele até que mude para Ativo.
- 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 Microsoft Outlook
Use o procedimento a seguir para sincronizar dados do Microsoft Outlook com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecione uma fonte de dados, role a tela ou pesquise Microsoft Outlook para conectar a fonte externa.
Insira as informações de autenticação do Microsoft Outlook e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Microsoft Teams para conectar a fonte externa.
Insira as informações de autenticação do Microsoft Teams e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 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 Notion
Use o procedimento a seguir para sincronizar dados do Notion com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar o conector:
Além da lista de permissões do conector 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.
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
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.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Notion para conectar a fonte externa.
Insira as informações de autenticação do Notion e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 OneDrive
Use o procedimento a seguir para sincronizar dados do OneDrive com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.
Tenha as seguintes informações de autenticação do OneDrive:
ID do cliente, chave secreta do cliente e ID do locatário. Para informações sobre como configurar esses parâmetros, consulte Guia de início rápido: registre um aplicativo com a plataforma de identidade da Microsoft na documentação da Microsoft.
Especifique escopos de acesso. É necessária uma função de administrador. Para mais informações, consulte Início rápido: configurar um aplicativo cliente para acessar uma API da Web na documentação da Microsoft.
Configure os seguintes escopos:
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise OneDrive para conectar a fonte externa.
Insira suas informações de autenticação do OneDrive.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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 estiverem 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 para Pesquisa.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.
Tenha as seguintes informações de autenticação. Para saber como configurar o ID e o chave secreta do cliente no Salesforce, consulte Configurar um app conectado para o fluxo de credenciais do cliente OAuth 2.0 na documentação do Salesforce.
- URL da instância
- ID do consumidor
- Chave secreta do consumidor
Considere as seguintes limitações:
- Use um plano Enterprise ou para desenvolvedores. Não é possível usar contas de teste.
- Verifique se você está usando o Sales Cloud. O Service Cloud não é compatível.
- Adicione o Google Cloud à lista de permissões CORS do Salesforce. Siga para a próxima etapa se você já tiver concluído esta tarefa.
- Siga as instruções na documentação do Salesforce para configurar a lista de permissões do CORS.
- 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Salesforce para conectar a fonte externa.
Insira as informações de autenticação do Salesforce.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão, verifique se você tem o seguinte:
Instância do ServiceNow: siga as instruções na documentação do ServiceNow Developer para criar uma instância do ServiceNow.
Google Cloud project: configure um Google Cloud project 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 força de trabalho.
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:
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.
-
- 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.
Para criar um endpoint OAuth, faça o seguinte:
- Faça login na instância principal do ServiceNow com privilégios de administrador.
- Navegue até Todos > OAuth do sistema > Registro do aplicativo.
- Clique em Novo e selecione Criar um endpoint de API OAuth para clientes externos. Extraia o ID e a chave secreta do cliente.
Preencha as informações necessárias:
- Nome: nome exclusivo.
- URL de redirecionamento:
https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html
.
Clique em Enviar para criar a credencial.
Depois do envio, clique no nome para conferir o chave secreta do cliente.
O secret é mascarado. Clique no ícone de cadeado ao lado dele para mostrar o secret.
Mantenha uma cópia do ID e da chave secreta do cliente para usar quando necessário.
Acesse
developer.service-now.com
e clique em Gerenciar senha da instância.Mantenha uma cópia do nome de usuário e da senha para usar quando necessário.
Nesta etapa, 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.
Crie um papel personalizado com regras de ACL:
- Acesse Todos > Administração de usuários > Papéis.
- Clique em Nova para criar uma função.
- Selecione um nome e clique em Enviar.
- Navegue até Segurança do sistema > Controle de acesso (ACL) para criar uma nova regra de ACL.
- Clique em Nova para criar uma regra de ACL.
- Selecione uma função, como
sys_user_role
. - Clique em Enviar e atribua a função.
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:
- Incidente:
incident
. - 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
. - Conhecimento:
kb_knowledge
,kb_knowledge_base
,kb_uc_can_read_mtom
,kb_uc_can_contribute_mtom
. - Anexo: todos os itens listados.
- Identidade:
sys_user_role
,sys_user_has_role
,sys_user_group
,sys_user_grmember
,sys_user
. - Atualizado conforme novos critérios são extraídos:
core_company
,cmn_location
,cmn_department
. - Critérios do usuário:
user_criteria
.
- Incidente:
Verifique se todas as ACLs foram atualizadas acessando
sys_security_acl_role_list.do
na barra de pesquisa.Selecione a função a ser verificada.
Confirme se todas as ACLs necessárias foram atribuídas à função selecionada.
Conceda o papel a uma conta de serviço:
- Acesse Tudo > Administração de usuários > Usuários e selecione o usuário.
- Encontre e selecione o usuário para conceder a função.
Se nenhum usuário estiver disponível, acesse Segurança do sistema > Usuários e grupos > Usuários.
Clique em Nova para criar uma conta de serviço na tabela Usuário.
Marque a caixa de seleção Somente acesso ao serviço da Web.
Acesse a tabela Papéis na parte de baixo da página.
Clique em Editar à direita.
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.
Acessar o nome de usuário e a senha do usuário. Na mesma página, clique em Definir senha.
Gerar uma senha automaticamente e salvá-la para uso futuro:
- ID do usuário:
manager
. - Senha: digite a senha gerada automaticamente.
- ID do usuário:
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:
- Configuração do Azure OIDC
- Configuração do SAML do Azure
- Configuração do Okta e do OIDC
- 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecione uma fonte de dados, role a tela ou pesquise ServiceNow para conectar a origem externa.
Insira as informações de autenticação do ServiceNow.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o conector de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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 SharePoint Online
Use o procedimento a seguir para sincronizar dados do SharePoint Online com a pesquisa da Vertex AI.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.
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.
Prepare as seguintes informações de autenticação do SharePoint Online para usar durante a configuração:
URL da instância. Na forma
http://DOMAIN_OR_SERVER/[sites/]WEBSITE
.A autenticação federada exige o ID do locatário e do cliente, enquanto o OAuth exige o ID do locatário, do ID 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.
Ao registrar o aplicativo, use
https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html
como o URL do callback da Web.Ao configurar as permissões do aplicativo, adicione as seguintes permissões da API Graph:
Ao configurar as permissões do aplicativo, adicione as seguintes permissões delegadas para a API REST do Sharepoint:
A tabela a seguir descreve os papéis recomendados para configuração e as limitações deles.
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.
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:
Receba o ID do cliente da conta de serviço:
- No Console do Google Cloud, acesse a página Criador de agentes.
- No menu de navegação, clique em Repositórios de dados.
- Clique em Criar repositório de dados.
- Na página Selecionar uma fonte de dados, role a tela ou pesquise SharePoint Online para conectar a origem externa.
- Anote o Identificador do assunto.
Registrar o app no Microsoft Entra:
- Acesse a Central de administração do Entra.
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.
Anote o ID do cliente e o ID do locatário.
Adicionar credenciais federadas:
Acesse Certificados e secrets > Credenciais federadas > Adicionar credencial.
Use as seguintes configurações:
- Emissor:
https://accounts.google.com
- Identificador do assunto: use o identificador do assunto indicado.
- Nome: informe um nome exclusivo.
- Emissor:
Clique em Adicionar para conceder acesso.
Defina as permissões da API:
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.
Use
Sites.Selected
para atribuir permissões específicas do site em vez deSites.FullControl.All
. OSites.Selected
não pode ser configurado diretamente pela UI. Depois de selecionarSites.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.Conceda
Sites.Read.All
para rastrear todos os subsites em um URL de site raiz.
Token de atualização do OAuth 2.0: configure a autenticação OAuth 2.0 usando um chave secreta 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 chave secreta do cliente e atribuir permissões de API, faça o seguinte:
Criar registro de app:
Acesse a Central de administração do Entra.
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
.
Anote o ID do cliente e o ID do locatário.
Adicionar a chave secreta do cliente:
Acesse Certificados e chaves secretas > Nova chave secreta do cliente.
Anote a string secreta.
Defina as permissões da API:
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.
Use uma conta de usuário dedicada com acesso limitado a sites específicos.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise SharePoint Online para conectar a origem externa.
Insira as informações de autenticação do SharePoint Online e clique em Autenticar.
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
.
- Para um único site:
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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.
Ativar o app da Web:
- Acesse as configurações de integração do app e ative a opção Ativar o app da Web.
Testar o app da Web:
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.
Verifique se os resultados da pesquisa estão restritos a itens acessíveis pelo usuário conectado.
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:
Crie o pool de recursos humanos no nível da organização no Google Cloud seguindo o manual de configuração apropriado:
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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Configure o controle de acesso para sua fonte de dados. Para informações sobre como configurar o controle de acesso, consulte Usar o controle de acesso à fonte de dados.
Entre em contato com o proprietário do espaço de trabalho para receber as permissões de instalação de novos apps.
Prepare as seguintes informações de autenticação do Slack:
ID do espaço de trabalho: siga as instruções em Especificar a origem do Slack para seu repositório de dados na documentação do Slack para encontrar o ID do espaço de trabalho.
Token de acesso: crie um app cliente e defina os escopos necessários. Para mais informações, consulte Guia de início rápido e Como conseguir e usar rapidamente um token de API do Slack na documentação do Slack.
Ao definir os escopos de permissão do OAuth 2.0, configure os seguintes escopos:
Por padrão, o Slack restringe a análise 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.
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.
- Faça login nos Apps da API Slack.
- Clique em Criar novo app.
- Selecione Do zero.
- Insira um nome para o app e selecione o espaço de trabalho para a integração.
- Clique em Criar App.
- Clique em OAuth e permissões.
- Em Escopos do token de bot, adicione os seguintes escopos obrigatórios:
Por padrão, o bot lê dos canais
#general
e#random
.Para ativar o rastreamento, faça o seguinte:
- Para canais públicos, conceda o escopo
channels:join
para permitir que o bot entre automaticamente. - Para canais privados, convide o bot manualmente.
- Para canais públicos, conceda o escopo
Clique em Instalar no seu espaço de trabalho de nome de usuário.
Siga as instruções na tela para instalar o app e extrair o token do bot.
Gerar um token de usuário para acessar todos os canais públicos sem se inscrever neles 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.
- Faça login nos Apps da API Slack.
- Clique em Criar novo app.
- Selecione Do zero.
- Insira um nome para o app e selecione o espaço de trabalho para a integração.
- Clique em Criar App.
- Clique em OAuth e permissões.
Em Escopos de token do usuário, adicione os seguintes escopos obrigatórios:
Clique em Instalar no seu espaço de trabalho de nome de usuário.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Slack para conectar a fonte externa.
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.
- 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
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o repositório de dados.
Selecione uma frequência de sincronização para o repositório de dados.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para conferir o status da ingestão, acesse a página Repositórios de dados e clique no nome do repositório de dados para conferir os detalhes na página Dados. O estado do conector muda de Criação para Em execução quando ele começa a sincronizar dados. Quando a transferência for concluída, o estado vai mudar para Ativo para indicar que a conexão com a origem de dados está configurada e aguardando a próxima sincronização programada.
Dependendo do tamanho dos dados, a ingestão pode levar de 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar o conector, siga estas etapas:
- 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.
- Verifique se o projeto foi adicionado à lista de permissões para usar o Trello.
- 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.
Gerar chave e token da API no Trello
Um administrador do Trello precisa realizar as seguintes etapas:
- Crie um Power-up do Trello para gerar uma chave de API.
- Acesse a página de administrador do Trello.
- Acesse a guia "Chave de API" e selecione a opção para gerar uma nova chave.
- Clique em Token.
- Clique em Permitir.
- Copie o token.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Trello para conectar a fonte externa.
Insira as informações de autenticação do Trello e clique em Continuar.
Opcional: para rotear o tráfego HTTP, clique em Adicionar destino e digite o nome do host ou o endereço IP do servidor proxy. Em seguida, clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de criar um conector do Workday:
Além da lista de permissões do conector 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.
Um administrador do Workday precisa gerar ou receber o seguinte para integrar com a Vertex AI para Pesquisa:
- ID do cliente. Acesse a página "Visualizar clientes de API" no Workday.
- Chave secreta do cliente. Acesse a página "Visualizar clientes de API" no Workday.
- Token de atualização. Acesse a página "Visualizar clientes de API" no Workday.
- Opcional: servidor proxy. O nome de host ou o endereço IP de um proxy para rotear o tráfego HTTP.
- Opcional: URL base. O URL de base da conexão do Workday.
- Opcional: URL da API. O URL completo para o endpoint de 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>
- Locatário do Workday. O locatário da conta. Por exemplo,
abc_cms1
É possível conferir o nome do locatário nos detalhes de configuração da instância do Workday.
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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecione uma fonte de dados, role a tela ou pesquise Workday para conectar a fonte externa.
Insira as informações de autenticação do Workday e clique em Continuar.
Opcional: insira as informações de destino do Workday e clique em Continuar.
Insira seu locatário do Workday e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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.
Depois de configurar a fonte de dados e importar dados pela primeira vez, o repositório de dados sincroniza os dados dessa fonte com a frequência selecionada durante a configuração.
Antes de começar
Antes de configurar a conexão:
Além da lista de permissões do conector 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.
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 Zendesk precisa gerar ou receber o seguinte para fazer a integração com a Vertex AI Search:
- Token de acesso. Token da API da sua instância do Zendesk.
- 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:
No Console do Google Cloud, acesse a página Criador de agentes.
No menu de navegação, clique em Repositórios de dados.
Clique em
Criar repositório de dados.Na página Selecionar uma fonte de dados, role a tela ou pesquise Zendesk para conectar a fonte externa.
Insira as informações de autenticação do Zendesk e clique em Continuar.
Selecione as entidades a serem sincronizadas e clique em Continuar.
Selecione uma região para o repositório de dados.
Insira um nome para o conector de dados.
Selecione uma frequência de sincronização.
Clique em Criar. A Vertex AI para Pesquisa repositório de dados e mostra seus repositórios de dados na página Repositórios de dados.
Para verificar o status da ingestão, acesse a página Repositórios de dados e clique no nome do conector 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 uma prévia de 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.