Busque conhecimento em documentos Quip com pesquisa inteligente usando o conector Quip para Amazon Kendra

As organizações usam soluções colaborativas de criação de documentos como o Salesforce Quip para incorporar documentos colaborativos em tempo real nos registros do Salesforce. Quip é a plataforma de produtividade da Salesforce que transforma a forma como as empresas trabalham juntas, oferecendo colaboração moderna de forma segura e simples em qualquer dispositivo. Um repositório Quip captura conhecimento organizacional inestimável na forma de documentos e fluxos de trabalho colaborativos. No entanto, encontrar esse conhecimento organizacional de forma fácil e segura junto com outros repositórios de documentos, como Box ou Serviço de armazenamento simples da Amazon (Amazon S3), pode ser um desafio. Além disso, a natureza conversacional dos fluxos de trabalho colaborativos torna a abordagem tradicional baseada em palavras-chave para pesquisa ineficaz devido a informações fragmentadas e dispersas em vários lugares.

Temos o prazer de anunciar que agora você pode usar o Amazona Kendra conector para o Quip pesquisar mensagens e documentos em seu repositório do Quip. Neste post, mostramos como encontrar as informações necessárias em seu repositório Quip usando a função de pesquisa inteligente do Amazon Kendra, com tecnologia de aprendizado de máquina.

Visão geral da solução

Com o Amazon Kendra, você pode configurar vários fontes de dados para fornecer um local central para pesquisar em seu repositório de documentos. Para nossa solução, demonstramos como configurar um repositório Quip como fonte de dados de um índice de pesquisa usando o conector Amazon Kendra para Quip.

A captura de tela a seguir mostra um exemplo de repositório do Quip.

A área de trabalho neste exemplo tem uma pasta privada que não é compartilhada. Essa pasta tem uma subpasta que é usada para guardar recibos de despesas. Outra pasta chamada example.com é compartilhada com outras pessoas e usada para colaborar com a equipe. Esta pasta possui cinco subpastas que contêm documentação para desenvolvimento.

Para configurar o conector do Quip, primeiro observamos o nome do domínio, os IDs das pastas e o token de acesso do repositório do Quip. Em seguida, simplesmente criamos o índice do Amazon Kendra e adicionamos o Quip como fonte de dados.

Pré-requisitos

Para começar a usar o conector Quip para Amazon Kendra, você deve ter um repositório Quip.

Coletar informações do Quip

Antes de configurarmos a fonte de dados do Quip, precisamos de alguns detalhes sobre seu repositório. Vamos recolhê-los com antecedência.

Nome do domínio

Descubra o nome de domínio. Por exemplo, para o URL do Quip https://example-com.quip.com/browse, o nome de domínio é quip. Dependendo de como o logon único (SSO) está configurado em sua organização, o nome de domínio pode variar. Salve este nome de domínio para usar mais tarde.

IDs de pasta

As pastas no Quip têm um ID exclusivo associado a elas. Precisamos configurar o conector Quip para acessar as pastas corretas fornecendo os IDs de pasta corretos. Para este post, indexamos a pasta example.com.

Para encontrar o ID da pasta, escolha a pasta. A URL muda para mostrar o ID da pasta.

O ID da pasta neste caso é xj1vOyaCGB3u. Faça uma lista dos IDs de pasta a serem verificados; usamos esses IDs ao configurar o conector.

Token de acesso

Faça login no Quip e abra https://{subdomain.domain}/dev/token em um navegador da web. No exemplo a seguir, navegamos para https://example-com.quip.com/dev/token. Então escolha Obter token de acesso pessoal.

Copie o token para usar em uma etapa posterior.

Agora temos as informações necessárias para configurar a fonte de dados.

Criar um índice do Amazon Kendra

Para configurar seu índice do Amazon Kendra, conclua as seguintes etapas:

1. Entre no Console de gerenciamento da AWS e abra o console do Amazon Kendra.

Se você estiver usando o Amazon Kendra pela primeira vez, deverá ver a captura de tela a seguir.

2. Escolha Crie um índice.
   
3. Escolha Nome do índice, entrar my-quip-example-index.
4. Escolha Descrição, insira uma descrição opcional.
5. Escolha Papel do IAM, use uma função existente ou crie uma nova.
6. Escolha Próximo.
   
7. Debaixo Configurações de controle de acesso, selecione Não para disponibilizar todo o conteúdo indexado para todos os usuários.
8. Escolha Expansão do grupo de usuários, selecione nenhum.
9. Escolha Próximo.
   

Escolha Edições de provisionamento, você pode escolher entre duas opções, dependendo do volume do conteúdo e da frequência de acesso.

10. Para esta postagem, selecione Edição de desenvolvedor.
11. Escolha Crie.
    

A criação da função leva aproximadamente 30 segundos; a criação do índice pode levar até 30 minutos. Quando concluído, você pode visualizar seu índice no console do Amazon Kendra.

Adicionar Quip como fonte de dados

Agora vamos adicionar o Quip como fonte de dados ao índice.

1. No console do Amazon Kendra, em Gestão de dados no painel de navegação, escolha As fontes de dados.
2. Escolha Adicionar conector para Quip.
   
3. Escolha Nome da fonte de dados, entrar my-quip-data-source.
4. Escolha Descrição, insira uma descrição opcional.
5. Escolha Próximo.
   
6. Digite o nome de domínio do Quip que você salvou anteriormente.
7. Debaixo Segredos, escolha Criar e adicionar um novo segredo do Secrets Manager.
8. Escolha Nome secreto, digite o nome do seu segredo.
9. Escolha Token de piada, insira o token de acesso que você salvou anteriormente.
10. Escolha Salvar e adicionar segredo.
    
11. Debaixo Papel do IAM, escolha uma função ou crie uma nova.
12. Escolha Próximo.
    
13. Debaixo Escopo de sincronização, Por Adicionar IDs de pasta para rastrear, insira os IDs de pasta que você salvou anteriormente.
14. Debaixo Sincronizar cronograma de execuçãopara Frequência, selecione Executar sob demanda.
15. Escolha Próximo.
    

O conector Quip permite capturar campos adicionais como autores, categorias e nomes de pastas (e até renomear conforme necessário).

16. Para este post, não configuramos nenhum mapeamento de campo.
17. Escolha Próximo.
    
18. Confirme todas as opções e adicione a fonte de dados.

Sua fonte de dados está pronta em alguns minutos.

19. Quando sua fonte de dados estiver pronta, escolha Sincronize agora.
    

Dependendo do tamanho dos dados no repositório do Quip, esse processo pode levar de alguns minutos a algumas horas. A sincronização é um processo de duas etapas. Primeiro, os documentos são rastreados para determinar aqueles a serem indexados. Em seguida, os documentos selecionados são indexados. Alguns fatores que afetam a velocidade de sincronização incluem a taxa de transferência e a limitação do repositório, a largura de banda da rede e o tamanho dos documentos.

O status de sincronização é exibido como bem-sucedido quando a sincronização é concluída. Seu repositório Quip agora está conectado.

Faça uma pesquisa no Amazon Kendra

Vamos testar o conector executando algumas pesquisas.

1. No console do Amazon Kendra, em Gestão de dados no painel de navegação, escolha Pesquisar conteúdo indexado.
   
2. Digite sua pesquisa no campo de pesquisa. Para este post, buscamos EC2 on Linux.

A imagem a seguir mostra nossos resultados.

Limitações

Existem algumas limitações conhecidas para a ingestão da fonte de dados. Algumas limitações se devem à necessidade de acesso de administrador para acessar alguns conteúdos, outras devido a detalhes específicos de implementação. Eles são os seguintes:

• Apenas rastreamentos completos são suportados. Se você quiser que o conector dê suporte a rastreamentos de log de alterações, o acesso à API de administrador é necessário e você precisa habilitar a API de administrador no site do Quip.
• Apenas pastas compartilhadas são rastreadas. Mesmo que usemos o token de acesso pessoal de um usuário administrador, não podemos rastrear dados nas pastas privadas de outros usuários.
• A solução não oferece suporte à especificação de tipos de arquivo para inclusão e exclusão, pois o Quip não armazena a extensão do tipo de arquivo, apenas o nome do arquivo.
• Os eventos em tempo real exigem uma assinatura e acesso à API de administrador.

Conclusão

O conector do Amazon Kendra para Quip permite que as organizações disponibilizem informações valiosas armazenadas em documentos do Quip para seus usuários com segurança usando a pesquisa inteligente desenvolvida pelo Amazon Kendra. O conector também fornece facetas para atributos de repositório do Quip, como autores, tipo de arquivo, URI de origem, datas de criação, arquivos pai e categoria para que os usuários possam refinar interativamente os resultados da pesquisa com base no que estão procurando.

Para obter mais informações sobre como você pode criar, modificar e excluir dados e metadados usando o enriquecimento de documento personalizado à medida que o conteúdo é ingerido do repositório do Quip, consulte Personalizando os metadados do documento durante o processo de ingestão e Enriqueça seu conteúdo e metadados para aprimorar sua experiência de pesquisa com o enriquecimento de documentos personalizados no Amazon Kendra.

---

Sobre os autores

Ashish Lagwankar é arquiteto de soluções corporativas sênior na AWS. Seus principais interesses incluem tecnologias de IA/ML, serverless e de contêiner. Ashish está baseado na área de Boston, MA, e gosta de ler, ao ar livre e passar tempo com sua família.

Vikas Shah é arquiteto de soluções corporativas da Amazon web services. Ele é um entusiasta da tecnologia que gosta de ajudar os clientes a encontrar soluções inovadoras para desafios de negócios complexos. Suas áreas de interesse são ML, IoT, robótica e armazenamento. Em seu tempo livre, Vikas gosta de construir robôs, caminhar e viajar.

• Coinsmart. A melhor troca de Bitcoin e criptografia da Europa.
• Platoblockchain. Inteligência Metaverso Web3. Conhecimento Ampliado. ACESSO LIVRE.
• CryptoHawk. Radar Altcoin. Teste grátis.
• Fonte: https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/