Conector Salesforce V2.0

Faça login no Console de gerenciamento da AWS e abra o Amazon Kendra console.

No painel de navegação esquerdo, escolha Índices e, em seguida, escolha o índice que deseja usar na lista de índices.

Na página Introdução, escolha Adicionar fonte de dados.

Na página Adicionar fonte de dados, escolha o Conector do Salesforce e Adicionar conector. Se estiver usando a versão 2 (se aplicável), escolha o conector Salesforce com a tag V2.0 "”.

Na página Especar detalhes da fonte de dados, insira as seguintes informações:

1. Em Nome e descrição, em Nome da fonte de dados: insira um nome para a fonte de dados. Você pode incluir hífens, mas não espaços.

2. (Opcional) Descrição: insira uma descrição opcional para a fonte de dados.

3. Em Idioma padrão: escolha um idioma para filtrar os documentos do índice. A menos que você especifique o contrário, o idioma padrão é o inglês. O idioma especificado nos metadados do documento substitui o idioma selecionado.

4. Em Tags, para Adicionar nova tag — Inclua tags opcionais para pesquisar e filtrar seus recursos ou monitorar seus AWS custos.

5. Escolha Próximo.

Na página Definir seção e segurança, insira as informações a seguir:

1. URL do Salesforce: insira o URL da instância do site do Salesforce que você deseja indexar.

2. Autorização: ative ou desative as informações da lista de controle de acesso (ACL) para seus documentos, caso tenha uma ACL e queira usá-la para controle de acesso. A ACL especifica quais documentos usuários e grupos podem acessar. As informações da ACL são usadas para filtrar os resultados da pesquisa com base no acesso do usuário ou do grupo aos documentos. Para obter mais informações, consulte Filtrar o contexto do usuário.

3. Insira uma senha existente ou, se você criar uma nova senha, uma janela secreta da AWS Secrets Manager será aberta.

   1. Autenticação — Escolha seu tipo de autenticação:

      • Fluxo de credenciais do cliente (recomendado) — usa somente client_id e client_secret para integrações de servidor a servidor.

      • Username-Password Flow (Legacy) — usa nome de usuário, senha, token de segurança, chave do consumidor e segredo do consumidor. Obsoleto pela Salesforce no inverno de 2027.

   2. Nome do segredo: um nome para o segredo. O prefixo 'AmazonKendra-Salesforce-' é adicionado automaticamente ao seu nome secreto.

   3. Para fluxo de credenciais do cliente:

      • Chave do consumidor — A ID do cliente do seu aplicativo Salesforce External Client

      • Segredo do consumidor — O segredo do cliente do seu aplicativo Salesforce External Client

      • URL de autenticação — Sua URL do Meu domínio (por exemplo, https://<orgDomain>.my.salesforce.com/services/oauth2/token).

        nota

        https://login.salesforce.come não https://test.salesforce.com são compatíveis com esse fluxo.

   4. Para Username-Password Flow:

      • Nome de usuário — Seu nome de usuário de administrador do Salesforce

      • Senha — Sua senha de administrador do Salesforce

      • Token de segurança — O token de segurança da sua conta do Salesforce

      • Chave do consumidor — A ID do cliente do seu aplicativo Salesforce Connected

      • Segredo do consumidor — O segredo do cliente do seu aplicativo Salesforce Connected

      • URL de autenticação — Para o Salesforce Developer Edition, use https://login.salesforce.com/services/oauth2/token nossa URL de login do Meu domínio (por exemplo, https://MyCompany.my.salesforce.com). Para o Salesforce Sandbox Edition, use https://test.salesforce.com/services/oauth2/token nossa URL de login do Meu domínio (por exemplo, MyDomainName--SandboxName.sandbox.my.salesforce.com).

   5. Escolha Salvar autenticação.

4. Nuvem privada virtual (VPC): você pode escolher usar uma VPC. Nesse caso, você deve adicionar sub-redes e grupos de segurança da VPC.

5. Crawler de identidade: especifique se deseja ativar o crawler de identidade do Amazon Kendra. O crawler de identidade usa as informações da lista de controle de acesso (ACL) de seus documentos para filtrar os resultados da pesquisa com base no acesso do usuário ou do grupo aos documentos. Se você tiver uma ACL para seus documentos e optar por usá-la, também poderá optar por ativar o rastreador de identidade para configurar a filtragem de contexto Amazon Kendra do usuário dos resultados da pesquisa. Caso contrário, se o crawler de identidade estiver desativado, todos os documentos poderão ser pesquisados publicamente. Se você quiser usar o controle de acesso para seus documentos e o rastreador de identidade estiver desativado, você também pode usar a PutPrincipalMapping API para carregar informações de acesso de usuários e grupos para filtragem de contexto de usuário.

6. IAM função — Escolha uma IAM função existente ou crie uma nova IAM função para acessar suas credenciais do repositório e o conteúdo do índice.

   nota

   IAM as funções usadas para índices não podem ser usadas para fontes de dados. Se você não tiver certeza se uma função existente é usada para um índice ou perguntas frequentes, escolha Criar uma nova função para evitar erros.

7. Escolha Próximo.

Na página Configurações de sincronização, insira as seguintes informações:

1. Para Rastrear anexos: selecione para rastrear todos os objetos do Salesforce.

2. Em Objetos padrão, Objetos padrão com anexos e Objeto padrão sem anexo e Artigos de conhecimento: selecione entidades do Salesforce ou tipos de conteúdo dos quais você deseja fazer crawling.

3. Você deve fornecer informações de configuração para indexar pelo menos um dos objetos padrão, artigos de conhecimento ou feeds do Chatter. Se você optar por rastrear Artigos de conhecimento, deverá especificar os tipos de artigos de conhecimento a serem indexados. Você pode escolher textos publicados, arquivados, rascunhos e anexos.

   Filtro Regex: especifique um padrão regex para incluir itens específicos do catálogo.

Para Configuração adicional:

Modo de sincronização: escolha como você deseja atualizar o índice quando o conteúdo da fonte de dados for alterado. Ao sincronizar a fonte de dados com o Amazon Kendra pela primeira vez, é feito crawling de e indexação de todo o conteúdo por padrão. Você deve executar uma sincronização completa dos seus dados se o processo inicial falhar, mesmo que não escolha essa opção de modo de sincronização.

Escolha Próximo.

Na página Definir mapeamentos de campo, insira as seguintes informações:

1. Para artigos de conhecimento padrão, anexos de objetos padrão e mapeamentos de campo adicionais sugeridos, selecione entre os campos de fonte de dados padrão Amazon Kendra gerados que você deseja mapear para seu índice.

   nota

   É necessário um mapeamento de _document_body. Você não pode alterar o mapeamento entre o campo Salesforce ID e o campo Amazon Kendra _document_id . Você pode mapear qualquer campo do Salesforce para os campos de índice Amazon Kendra reserved/default do título ou corpo do documento.

   Se você associar qualquer campo do Salesforce aos campos de título e corpo do documento do Amazon Kendra, este usará os dados desses campos nas respostas da pesquisa.

2. Adicionar campo: para adicionar campos de fonte de dados personalizados, crie um nome de campo de índice para mapear e o tipo de dados do campo.

3. Escolha Próximo.

Na página Revisar e criar, verifique se as informações inseridas estão corretas e selecione Adicionar fonte de dados. Você também pode optar por editar as informações a partir desta página. Sua fonte de dados aparecerá na página Fontes de dados depois que a fonte de dados for adicionada com sucesso.