개요

Gemini Enterprise용 Jira Cloud 커넥터를 사용하면 Jira Cloud 데이터에 액세스하여 프로젝트, 문제, 사용자 정보와 상호작용할 수 있습니다.

지원되는 Jira Cloud 버전

Jira Cloud 커넥터는 Jira Cloud REST API 버전 2를 지원합니다.

지원되는 작업

Jira Cloud 커넥터가 사용 설정되면 최종 사용자는 Gemini Enterprise에서 자연어 명령어를 사용하여 다음 작업을 실행할 수 있습니다.

작업 설명
댓글 만들기 지정된 Jira 문제에 새 댓글을 만들어 의견, 업데이트 또는 메모를 추가합니다.
댓글 업데이트 기존 댓글의 텍스트를 수정합니다.
문제 만들기 Jira Cloud 프로젝트에 새 문제를 만듭니다. 이를 만들려면 요약, 프로젝트 ID, 문제 유형 ID를 제공해야 합니다.
업데이트 문제 Jira Cloud의 기존 문제를 업데이트합니다. 문제를 식별하기 위해 문제 ID를 제공해야 하며 요약, 설명, 담당자와 같은 다양한 필드를 수정할 수 있습니다.

이 외에도 추가 읽기 전용 작업을 사용할 수 있습니다.

필수 범위

Gemini Enterprise가 Jira Cloud 데이터 스토어를 사용하여 검색 및 작업을 실행하도록 하려면 다음 범위가 필요합니다.

연결 모드 범위 목적
제휴 검색 및 작업 read:jira-user, read:jira-work 검색 결과와 사용자 세부정보를 실시간으로 가져와 표시하는 데 필요합니다.
write:jira-work 어시스턴트가 작업 항목을 수정할 수 있도록 허용합니다 (예: 문제 필드 업데이트).
write:comment:jira 어시스턴트가 검색 인터페이스에서 직접 새 댓글이나 답글을 게시할 수 있습니다.
write:issue:jira 새 문제를 만들거나 기존 문제를 대대적으로 수정하는 데 필요합니다.
제휴 검색만 해당 read:jira-user, read:jira-work 문제, 프로젝트, 사용자 프로필을 검색하고 보는 데 필요합니다.
데이터 수집 및 작업 read:jira-work, read:user:jira, read:group:jira, read:avatar:jira 전체 규모 데이터 수집 및 사용자/그룹 메타데이터 동기화에 필요합니다.
read:issue-security-level:jira, read:issue-security-scheme:jira 액세스 제어에 중요합니다. 수집된 데이터가 Jira의 보안 경계를 준수하도록 합니다.
read:audit-log:jira 변경사항을 추적하고 증분 동기화를 실행하여 수집된 데이터를 최신 상태로 유지하는 데 사용됩니다.
write:jira-work 수집된 환경 내에서 작업 항목에 쓰기 작업을 실행하는 데 필요합니다.
write:comment:jira 어시스턴트를 사용하여 문제에 댓글을 추가하는 데 필요합니다.
write:issue:jira 문제를 만들거나 수정할 수 있습니다.
데이터 수집 read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Jira 콘텐츠와 사용자 관계를 크롤링하고 색인을 생성하는 데 필요합니다.
read:issue-security-level:jira, read:issue-security-scheme:jira 승인된 사용자만 수집된 데이터를 검색할 수 있도록 권한을 매핑해야 합니다.
read:audit-log:jira 동기화 엔진이 업데이트되거나 삭제된 항목을 식별하는 데 필요합니다.

이러한 범위를 구성하는 방법에 대한 자세한 내용은 최소 애플리케이션 범위 구성을 참고하세요.

데이터 수집 비율 제한

Jira Cloud 커넥터는 데이터 수집을 위해 초당 12개의 쿼리 (QPS)의 기본 비율 제한을 지원합니다. 이러한 비율 제한은 Jira Cloud 커넥터의 데이터 수집에만 적용됩니다.

제한사항

이 섹션에서는 Jira Cloud 커넥터 사용에 영향을 줄 수 있는 알려진 문제와 제한사항을 설명합니다.

  • 기존 Jira Cloud 데이터 저장소에 VPC 서비스 제어 경계를 적용하는 것은 지원되지 않습니다. VPC 서비스 제어를 적용하려면 데이터 스토어를 삭제하고 다시 만들어야 합니다. VPC 서비스 제어 및 VPC 서비스 제어를 사용 설정한 후 작업을 사용하는 방법에 대한 자세한 내용은 VPC 서비스 제어로 앱 보호를 참고하세요.

  • Jira Cloud 데이터 스토어는 전역, 미국, EU 위치에서만 지원됩니다.

  • 새 애플리케이션을 만들거나 기존 애플리케이션에 데이터 스토어를 추가할 때는 단일 커넥터 유형에 속하는 작업이 있는 데이터 스토어를 추가하는 것이 좋습니다. 예를 들어 작업이 사용 설정된 두 개의 Jira Cloud 데이터 스토어를 동일한 애플리케이션과 연결하지 마세요.

다음은 Jira Cloud 수집 커넥터의 제한사항입니다.

  • 비정형 데이터의 경우 미디어 유형마다 제한사항이 다릅니다. 자세한 내용은 커스텀 데이터 소스용 데이터 준비를 참조하세요.

  • 정형 데이터의 경우 각 문서의 크기가 500KB를 초과해서는 안 됩니다.

  • 비어 있지 않은 특정 역할이 있는 애플리케이션 역할에는 Browse project 또는 보안 수준 권한을 부여할 수 없습니다.

  • 사용자 커스텀 필드 또는 그룹 커스텀 필드로 결정되는 문서 권한은 지원되지 않습니다.

  • Jira Cloud에서는 작업 로그 수준에 대한 제한을 허용하지 않습니다.

  • Jira Cloud는 2,000페이지를 초과하는 PDF 첨부파일을 색인 생성하지 않습니다.

  • 비공개 댓글에 추가된 첨부파일은 댓글의 액세스 제한(ACL)을 상속하지 않습니다.

  • Jira Cloud의 문제에 대한 이전 댓글 20개만 가져옵니다.

  • 스프린트 테이블은 수집할 수 없습니다.

  • Jira Cloud와의 통합에는 기존 사용자 관리 모델이 지원되지 않습니다. 중앙 집중식 사용자 관리 모델만 지원됩니다. 자세한 내용은 Atlassian 조직 통합 가이드를 참조하세요.

  • Jira 항목(예: 문제)을 쿼리할 때 댓글 및 첨부파일과 같은 관련 데이터는 자동으로 포함되지 않습니다. 이는 별도의 항목으로 저장되고 색인이 생성되기 때문입니다. 첨부파일의 콘텐츠를 기반으로 검색하여 상위 문제를 찾는 것은 지원되지 않습니다.

다음 단계