View a markdown version of this page

Atlassian Confluence Cloud 지식 기반 통합 - Amazon Quick
시작하기 전 준비 사항Authentication지식 기반 통합 설정지원되는 콘텐츠 유형액세스 제어지식 기반 관리문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Atlassian Confluence Cloud 지식 기반 통합

Amazon Quick 에이전트가 이에 대한 질문을 검색하고 답변할 수 있도록 Atlassian Confluence Cloud 지식 기반 통합을 사용하여 Confluence 콘텐츠를 인덱싱합니다.

시작하기 전 준비 사항

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

Authentication

지식 기반 통합의 경우 Amazon Quick은 설정 중에 팝업 흐름을 통해 인증을 처리합니다. 다음 단계를 완료합니다.

  1. 표시되는 Confluence 클라우드 인증 팝업을 완료합니다.

  2. Amazon Quick이 Confluence 콘텐츠에 액세스할 수 있는 권한을 부여합니다.

  3. 인증 프로세스를 검토하고 완료합니다.

지식 기반 통합 설정

  1. Amazon Quick 콘솔에서 통합을 선택합니다.

  2. Atlassian Confluence Cloud를 선택하고 추가(‘+’ 추가) 버튼을 선택합니다.

  3. Confluence 지식 기반 생성 대화 상자의 연결된 계정에서 다음 필드를 작성합니다.

    • 이름 - 데이터 액세스 통합을 설명하는 이름입니다.

    • Confluence URL - Atlassian 사이트의 URL입니다(예: your-site.atlassian.net).

  4. 로그인을 선택하고 팝업 창에서 Confluence 클라우드 인증 흐름을 완료합니다.

  5. 지식 기반 생성에서 다음 필드를 작성합니다.

    • 이름 - 지식 기반의 이름입니다.

    • 설명(선택 사항) - 지식 기반 사용 방법에 대한 참고 사항입니다.

  6. 콘텐츠에서 포함하려는 Confluence 스페이스, 블로그 또는 페이지의 URLs을 붙여넣습니다. 각 URL 뒤에 추가를 선택합니다.

    참고

    구조를 따르는 URLshttps://company.atlassian.net/wiki/spaces/space-key/overview은 페이지 URLs로 처리됩니다.

  7. 생성(Create)을 선택합니다.

지원되는 콘텐츠 유형

  • Confluence 페이지 및 블로그 게시물

  • 스페이스 콘텐츠

  • 페이지 및 블로그 첨부 파일

액세스 제어

중요

Amazon Quick은 데이터 소스의 액세스 제어 목록(ACLs 동기화하지 않습니다. Amazon Quick에서 지식 기반을 생성할 때 기본적으로 지식 기반에서 인사이트만 얻을 수 있습니다. 공유 콘텐츠의 경우 지식 기반 권한을 업데이트하여 다양한 사용자 및 그룹에 대한 액세스를 제공할 수 있습니다.

지식 기반 관리

기존 지식 기반 편집

  1. Amazon Quick 콘솔에서 지식 기반을 선택합니다.

  2. 목록에서 Confluence 클라우드 지식 기반을 선택합니다.

  3. 작업에서 점 3개 아이콘을 선택한 다음 지식 기반 편집을 선택합니다.

  4. 필요에 따라 구성 설정을 업데이트하고 저장을 선택합니다.

문제 해결

통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

동기화 문제 및 누락된 문서를 포함한 일반적인 지식 기반 문제 해결은 섹션을 참조하세요지식 기반 문제 해결.

차단된 OAuth 앱 권한 부여

증상:

  • 오류 메시지: “앱이 계정에 액세스하려면 사이트 관리자가 사이트 instance-name.atlassian.net 대해이 앱을 승인해야 합니다.”

  • 동의 대화 상자에서 수락을 클릭해도 아무런 효과가 없습니다.

원인:

Atlassian 사이트 관리자가 사용자 설치 OAuth 앱을 차단했습니다. 이 설정을 활성화하면 사이트 또는 조직 관리자만 새 타사 앱을 승인할 수 있습니다.

해결 단계:

다음 옵션 중 하나를 사용하여이 문제를 해결합니다.

  • 옵션 1(권장): 관리자가 앱을 직접 승인합니다.

    1. Atlassian 사이트 관리자가 Amazon Quick으로 이동하여 Confluence Cloud로 새 지식 기반 설정을 시작합니다.

    2. 관리자에게 사이트 수준 권한이 있으므로 오류 없이 클린 동의 화면이 나타납니다.

    3. 관리자가 수락을 선택하여 앱을 설치합니다.

    관리자가 앱을 승인하면 사이트의 다른 모든 사용자가 문제 없이 연결할 수 있습니다.

  • 옵션 2: 사용자 설치 앱 임시 허용 - 관리자가 로 이동하여 앱, Atlassian 앱으로 admin.atlassian.com이동한 다음 타사 및 Marketplace 앱의 링크를 선택합니다. 설정에서 사용자 설치 앱을 찾아 사용자 앱을 허용하도록 전환합니다. 사용자가 Amazon Quick에 권한을 부여한 후 설정을 다시 전환하여 사용자 앱을 차단합니다.

중요

관리자 권한 부여는 조직이 아닌 Atlassian 사이트별로 적용됩니다. 회사에 여러 사이트(예: team-a.atlassian.net 및 team-b.atlassian.net)가 있는 경우 각 사이트에는 별도의 권한이 필요합니다.

참고

사용자 설치 앱이 차단 해제되어 있는 동안(옵션 2), 사이트의 모든 사용자는 모든 OAuth 앱을 승인할 수 있습니다. 사용자가 연결한 후 즉시 블록을 다시 활성화합니다.

인증 팝업 실패

증상:

  • 인증 팝업이 표시되지 않거나 즉시 닫힙니다.

  • 팝업이 표시되지만 OAuth 흐름을 완료하지 못합니다.

해결 단계:

  1. 브라우저가 Amazon Quick 콘솔 도메인의 팝업을 허용하는지 확인합니다.

  2. 네트워크에서 Confluence 클라우드 인스턴스에 액세스할 수 있는지 확인합니다.

  3. 다른 브라우저를 사용하거나 브라우저 캐시를 지우십시오.

지식 기반에 누락된 콘텐츠

증상:

  • 지식 기반 동기화는 완료되지만 예상 콘텐츠는 인덱싱되지 않습니다.

  • 검색 결과에는 특정 공백 또는 페이지의 콘텐츠가 포함되지 않습니다.

  • 전체 스페이스에 대해 하나의 문서만 인덱싱됩니다.

해결 단계:

  1. 인증한 Confluence 클라우드 사용자가 설정 중에 선택한 스페이스와 페이지에 액세스할 수 있는지 확인합니다.

  2. 선택한 콘텐츠 유형(페이지, 블로그 게시물 및 첨부 파일)이 지원되는지 확인합니다.

  3. 지식 기반 구성의 콘텐츠 선택을 검토하여 올바른 공백과 페이지가 포함되어 있는지 확인합니다.

  4. Confluence URLs에서 /overview 접미사를 확인합니다. 로 끝나는 URLs/wiki/spaces/space-key/overview은 전체 스페이스가 아닌 단일 페이지 URL로 처리됩니다. 전체 스페이스를 인덱싱하려는 경우를 사용하지 않고 스페이스 URL을 사용합니다/overview(예: https://company.atlassian.net/wiki/spaces/space-key).