# Copilot 클라우드 에이전트를 Linear에 통합

Linear의 Copilot 통합을 사용하여 컨텍스트를 제공하고, 에이전트 실행 방법을 사용자 지정하고, 선형 작업 영역 내에서 끌어오기 요청을 엽니다.

> \[!NOTE]
> GitHub Copilot 는 AI를 사용합니다. 실수가 있는지 확인합니다. [애플리케이션 카드: GitHub Copilot 에이전트](/ko/copilot/responsible-use/agents)을(를) 참조하세요.

Copilot 선형의 통합을 사용하면 선형 작업 영역을 벗어나지 않고도 호출 Copilot cloud agent 할 수 있습니다. Linear 이슈 내에서 이슈 설명과 댓글의 컨텍스트를 바탕으로 cloud agent 세션을 시작하고, 에이전트가 사용할 모델, 사용자 지정 에이전트 또는 브랜치를 설정하고, 세션 진행을 조정하고, 풀 리퀘스트를 열 수 있습니다.

추가 Copilot 통합에 대한 자세한 내용은 [Copilot 통합 정보](/ko/copilot/concepts/tools/about-copilot-integrations)을 참조하세요.

> \[!NOTE]
> 선형 문제에 @GitHub 를 언급하거나 할당 Copilot 할 때 에이전트는 전체 문제 설명 및 주석을 요청에 대한 컨텍스트로 캡처합니다. 이렇게 하면 에이전트가 문제를 이해하고 문제의 모든 정보를 기반으로 적절한 솔루션을 구현할 수 있습니다. 이 컨텍스트는 끌어오기 요청에 저장됩니다.

## 사전 요구 사항

* 유료 GitHub 플랜을 통해 Copilot에 액세스할 수 있는 Copilot 계정이 있어야 합니다.
* 선형 계정이 있어야 하며 팀의 구성원이어야 합니다.

## Linear에 Copilot 앱 설치

> \[!NOTE]
>
> * Linear에서 Copilot 앱을 설치하려면, 해당 앱을 설치하려는 조직 또는 엔터프라이즈의 소유자여야 합니다. 또한 Linear에서 작업 영역 관리자여야 합니다.
> * 조직이 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud를 사용하는 엔터프라이즈에 속해 있는 경우, `SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-linear`에서 엔터프라이즈에서 사용할 수 있는 앱 목록의 통합을 설치하세요. SUBDOMAIN을 엔터프라이즈의 하위 도메인 GHE.com으로 대체합니다.

앱은 Copilot 조직에서 한 번만 설치하면 됩니다. 앱이 설치되면 조직의 모든 구성원이 자신의 Copilot 계정을 앱에 연결하고 사용을 시작할 수 있습니다.

1. [선형 페이지로Copilot](https://github.com/apps/github-copilot-for-linear?ref_product=copilot\&ref_type=engagement\&ref_style=text) 이동하여 **구성**을 클릭합니다.
2. 화면의 프롬프트에 따라 사용하려는 조직 또는 엔터프라이즈에서 앱을 구성하고 권한을 부여합니다.

## 선형에서 Copilot 앱 사용

Linear에서 Copilot 앱을 처음 사용할 때는 GitHub 계정에 연결해야 합니다.
Copilot cloud agent에서 사용할 리포지토리도 지정해야 합니다. 지정된 리포지토리에 **대한 쓰기** 권한이 있는 사용자만 해당 리포지토리에서 작동하도록 트리거 Copilot cloud agent 할 수 있습니다. 리포지토리에 대한 **write** 액세스 권한이 없는 이슈 기여자도 끌어오기 요청을 만들 때 문맥으로 사용되는 이슈 대화에 의견을 제공하여 Copilot가 이슈를 안내하도록 도울 수 있습니다.

1. Linear에서 Copilot cloud agent를 사용하려는 문제를 만듭니다.
2. **할당** 드롭다운을 클릭한 다음 **GitHub Copilot** 선택합니다.
3. 사용할 리포 Copilot cloud agent 지토리를 아직 지정하지 않은 경우 지금 이 작업을 수행하라는 메시지가 표시됩니다. 여기서 이 Copilot cloud agent 문제와 관련된 끌어오기 요청이 열립니다.
4. 앱을 처음 사용하는 경우 계정에 로그인하고 앱 GitHub 에 권한을 부여하라는 메시지가 표시됩니다. 프롬프트에 따라 권한 부여를 완료합니다.
5. Linear 이슈의 "링크" 섹션에 Copilot cloud agent가 생성한 연결된 "\[WIP]" 풀 리퀘스트가 표시됩니다. 링크를 클릭하여 GitHub에서 풀 리퀘스트를 확인하십시오.
6. Copilot cloud agent 끌어오기 요청 작업이 완료되면 선형 문제의 "활동" 섹션에 알림이 추가됩니다.

## Copilot cloud agent 선형으로 사용자 지정

Linear의 에이전트 지침을 사용하면 이슈별로 또는 전체 워크스페이스에서 Linear에서 Copilot cloud agent가 작동하는 방식을 맞춤설정할 수 있습니다. 기본 리포지토리, 기본 설정 모델 또는 분기 규칙과 같은 되풀이 기본 설정은 [선형 에이전트 지침](#using-linear-agent-guidance)에 따라 한 번 설정하는 것이 가장 좋습니다.

### 선형 에이전트 지침 사용

Linear의 에이전트 지침은 워크스페이스 또는 팀 수준에서 설정하는 프롬프트입니다. Linear는 Copilot cloud agent를 실행할 때마다 이 지침을 자동으로 전달합니다.

에이전트 지침의 일반적인 용도는 다음과 같습니다.

* 끌어오기 요청을 열 기본 리포지토리를 지정합니다.
* 기본 설정 모델을 지정합니다.
* 사용할 사용자 지정 에이전트 지정
* 브랜치 명명 규칙 또는 기본 베이스 브랜치 정의

Linear의 에이전트 안내에 대한 자세한 내용은 Linear 문서의 [에이전트 안내](https://linear.app/docs/agents-in-linear#guiding-agents)를 참조하세요.

### 모델 선택

Copilot cloud agent를 Linear 이슈에서 트리거하면 이슈 설명에서 모델을 지정하여 Copilot에서 사용할 모델을 선택할 수 있습니다. 자세한 내용은 [GitHub Copilot 클라우드 에이전트에 대한 AI 모델 변경](/ko/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)을(를) 참조하세요.

작업 영역 또는 팀의 모든 실행에 대한 기본 모델을 설정하려면 에이전트 지침에 추가합니다.
[선형 에이전트 사용 지침을 참조하세요](#using-linear-agent-guidance).

### 사용자 지정 에이전트 사용

Copilot cloud agent가 Linear에서 풀 리퀘스트를 열 때 GitHub 리포지토리의 사용자 지정 에이전트를 사용하도록 하려면, 이슈 설명에 사용할 에이전트를 지정하면 됩니다. 자세한 내용은 [에 대한 사용자 지정 에이전트 만들기 Copilot cloud agent](/ko/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)을(를) 참조하세요.

작업 영역 또는 팀에서 항상 동일한 사용자 지정 에이전트를 사용하려면 에이전트 지침에 지정합니다.
[선형 에이전트 사용 지침을 참조하세요](#using-linear-agent-guidance).

### 기본 분기 및 작업 분기 설정

선형 문제에서 끌어오기 요청을 열면 Copilot cloud agent 다음을 선택할 수 있습니다.

* 끌어오기 요청 대상이 되는 **기본 분기** 입니다.
* **작업 분기** 이름은 Copilot cloud agent 커밋에 사용합니다.

모든 실행에 동일한 기본 분기 또는 분기 명명 규칙을 적용하려면 에이전트 지침에 추가합니다.
[선형 에이전트 사용 지침을 참조하세요](#using-linear-agent-guidance).

### 세션 진행

선형 문제에서 트리거 Copilot cloud agent 한 후 에이전트를 계속 지시할 수 있습니다. 이렇게 하려면 추가 지침과 함께 Linear 이슈의 댓글에 `@GitHub Copilot`를 언급하거나 에이전트 채팅 패널에 추가 지침을 입력하세요.

## 추가 읽기

* [GitHub Copilot 클라우드 에이전트 정보](/ko/copilot/concepts/agents/cloud-agent/about-cloud-agent)
* [GitHub Copilot 클라우드 에이전트에 대한 액세스 관리](/ko/copilot/concepts/agents/cloud-agent/access-management)