View a markdown version of this page

Integração da base de conhecimento do Atlassian Confluence Cloud - Amazon Quick

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integração da base de conhecimento do Atlassian Confluence Cloud

Use a integração da base de conhecimento do Atlassian Confluence Cloud para indexar o conteúdo do Confluence para que os agentes do Amazon Quick possam pesquisar e responder perguntas sobre ele.

Antes de começar

Verifique se você tem o seguinte antes de configurar a integração.

Autenticação

Para integrações de base de conhecimento, o Amazon Quick gerencia a autenticação por meio de um fluxo de pop-up durante a configuração. Execute as etapas a seguir.

  1. Preencha o pop-up de autenticação do Confluence Cloud que aparece.

  2. Conceda permissões para que o Amazon Quick acesse seu conteúdo do Confluence.

  3. Revise e conclua o processo de autenticação.

Configurar a integração da base de conhecimento

  1. No console do Amazon Quick, escolha Integrações.

  2. Escolha Atlassian Confluence Cloud e escolha o botão Adicionar (mais “+”).

  3. Na caixa de diálogo Criar base de conhecimento do Confluence, em Conta conectada, preencha os seguintes campos:

    • Nome — Um nome descritivo para sua integração de acesso a dados.

    • URL do Confluence — O URL do seu site da Atlassian (por exemplo,). your-site.atlassian.net

  4. Escolha Entrar e conclua o fluxo de autenticação do Confluence Cloud na janela pop-up.

  5. Em Criar base de conhecimento, preencha os seguintes campos:

    • Nome — Um nome para sua base de conhecimento.

    • Descrição (opcional) — Notas sobre como a base de conhecimento será usada.

  6. Em Conteúdo, cole URLs os espaços, blogs ou páginas do Confluence que você deseja incluir. Escolha Adicionar após cada URL.

    nota

    URLs que seguem a estrutura https://company.atlassian.net/wiki/spaces/space-key/overview são tratadas como página URLs.

  7. Escolha Criar.

Tipos de conteúdo compatíveis

  • Páginas e postagens de blog do Confluence

  • Conteúdo do Spaces

  • Anexos da página e do blog

Controles de acesso

Importante

O Amazon Quick não sincroniza listas de controle de acesso (ACLs) de fontes de dados. Quando você cria uma base de conhecimento no Amazon Quick, por padrão, somente você pode obter insights da base de conhecimento. Para conteúdo compartilhado, você pode fornecer acesso a diferentes usuários e grupos atualizando as permissões da base de conhecimento.

Gerencie bases de conhecimento

Edite as bases de conhecimento existentes

  1. No console do Amazon Quick, escolha Bases de conhecimento.

  2. Selecione sua base de conhecimento do Confluence Cloud na lista.

  3. Escolha o ícone de três pontos em Ações e escolha Editar base de conhecimento.

  4. Atualize suas configurações conforme necessário e escolha Salvar.

Solução de problemas

Para editar, compartilhar ou excluir sua integração, consulteGerenciando integrações existentes.

Para solução de problemas gerais da base de conhecimento, incluindo problemas de sincronização e documentos ausentes, consulteBases de conhecimento sobre solução de.

Autorização de OAuth aplicativo bloqueada

Sintomas:

  • Mensagem de erro: “O administrador do seu site deve autorizar este aplicativo para o site instance-name .atlassian.net antes que o aplicativo possa acessar sua conta.”

  • Clicar em Aceitar na caixa de diálogo de consentimento não tem efeito.

Causa:

O administrador do site da Atlassian bloqueou os aplicativos instalados pelo usuário OAuth . Quando essa configuração está habilitada, somente o administrador do site ou da organização pode autorizar novos aplicativos de terceiros.

Etapas de resolução:

Use uma das opções a seguir para resolver esse problema.

  • Opção 1 (recomendada): o administrador autoriza o aplicativo diretamente

    1. Um administrador do site da Atlassian navega até o Amazon Quick e inicia uma nova configuração da base de conhecimento com o Confluence Cloud.

    2. Como o administrador tem permissões no nível do site, uma tela de consentimento limpa aparece sem o erro.

    3. O administrador escolhe Aceitar para instalar o aplicativo.

    Depois que o administrador autorizar o aplicativo, todos os outros usuários do site poderão se conectar sem problemas.

  • Opção 2: permitir temporariamente aplicativos instalados pelo usuário — um administrador acessaadmin.atlassian.com, navega até Apps, Atlassian Apps e escolhe o link para aplicativos de terceiros e do Marketplace. Em Configurações, encontre Aplicativos instalados pelo usuário e alterne para permitir aplicativos do usuário. Depois que o usuário autorizar o Amazon Quick, alterne a configuração para bloquear os aplicativos do usuário.

Importante

A autorização do administrador se aplica por site da Atlassian, não por organização. Se sua empresa tiver vários sites (por exemplo, team-a.atlassian.net eteam-b.atlassian.net), cada site exigirá uma autorização separada.

nota

Enquanto os aplicativos instalados pelo usuário estão desbloqueados (Opção 2), qualquer usuário no site pode autorizar qualquer aplicativo. OAuth Reative o bloqueio imediatamente após a conexão do usuário.

O pop-up de autenticação falha

Sintomas:

  • O pop-up de autenticação não aparece ou fecha imediatamente.

  • O pop-up aparece, mas não consegue concluir o OAuth fluxo.

Etapas de resolução:

  1. Verifique se seu navegador permite pop-ups do domínio do console Amazon Quick.

  2. Verifique se sua instância do Confluence Cloud pode ser acessada pela sua rede.

  3. Tente usar um navegador diferente ou limpar o cache do navegador.

Conteúdo ausente na base de conhecimento

Sintomas:

  • A sincronização da base de conhecimento é concluída, mas o conteúdo esperado não é indexado.

  • Os resultados da pesquisa não incluem conteúdo de espaços ou páginas específicos.

  • Somente um documento é indexado em um espaço inteiro.

Etapas de resolução:

  1. Verifique se o usuário do Confluence Cloud que se autenticou tem acesso aos espaços e páginas que você selecionou durante a configuração.

  2. Verifique se os tipos de conteúdo selecionados são compatíveis (páginas, publicações do blog e anexos).

  3. Analise a seleção de conteúdo na configuração da sua base de conhecimento para confirmar se os espaços e páginas corretos estão incluídos.

  4. Verifique o sufixo no Confluence URLs . /overview URLs que terminam com /wiki/spaces/space-key/overview são tratados como um URL de página única, não como um espaço completo. Se você pretendia indexar todo o espaço, use o URL do espaço sem /overview (por exemplo,https://company.atlassian.net/wiki/spaces/space-key).