{"meta":{"title":"딥 링크를 사용하여 GitHub Copilot 앱 열기","intro":"사용자가 올바른 리포지토리, 풀 리퀘스트, 자동화 또는 세션으로 바로 이동할 수 있도록 딥 링크를 사용해 터미널이나 티켓, 내부 도구에서 GitHub Copilot app를 실행하세요.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/github-copilot-app","title":"GitHub Copilot app"},{"href":"/ko/copilot/how-tos/github-copilot-app/open-with-deep-links","title":"딥 링크로 열기"}],"documentType":"article"},"body":"# 딥 링크를 사용하여 GitHub Copilot 앱 열기\n\n사용자가 올바른 리포지토리, 풀 리퀘스트, 자동화 또는 세션으로 바로 이동할 수 있도록 딥 링크를 사용해 터미널이나 티켓, 내부 도구에서 GitHub Copilot app를 실행하세요.\n\n딥 링크는 더 적은 컨텍스트 전환으로 GitHub Copilot app 작업을 시작하는 데 도움이 됩니다. 예를 들어 킥오프 프롬프트를 공유하거나, markdown 파일에 앱에 대한 링크를 포함하거나, 터미널 스크립트에서 앱을 시작하거나, 외부 도구에서 앱을 여는 단추를 추가할 수 있습니다.\n\n브라우저 링크가 앱 링크를 감싸는 호스팅된 런처에서 GitHub Copilot app를 열 수 있습니다. 호스트된 시작 관리자가 가능하면 앱을 열고 브라우저가 앱에 전달할 수 없는 경우 대체 페이지를 표시합니다. 지원되는 앱 링크의 전체 목록은 [사용 가능한 앱 링크를 참조하세요](#available-app-links).\n\n## 딥 링크를 사용하는 이유\n\n웹 페이지 또는 워크플로에서 앱의 특정 페이지 또는 작업으로 직접 이동하려는 경우 딥 링크를 사용합니다. 일반 사용 사례는 다음과 같습니다.\n\n* 미리 채워진 킥오프 프롬프트를 사용하여 세션을 시작합니다.\n* 팀원이 신속하게 열고 다시 사용할 수 있도록 자동화 프롬프트를 공유합니다.\n* 내부 문서 또는 markdown 파일에 시작 단추를 추가하여 일반적인 워크플로를 엽니다.\n* 로컬 워크플로의 일부로 터미널 명령 또는 스크립트에서 앱을 시작합니다.\n* 이슈 추적 시스템 또는 티켓 시스템과 같은 제3자 제품에서 앱을 엽니다.\n\n## 시작 관리자 URL 형식\n\n쿼리 매개 변수에 인코딩된 전체 앱 링크와 함께 호스트된 시작 관리자 URL을 `open` 사용합니다. 호스트된 시작 관리자가 가능하면 앱을 열고 브라우저가 앱에 전달할 수 없는 경우 대체 페이지를 표시합니다.\n\n```text\nhttps://github.com/copilot/app/launch?open=ENCODED_APP_LINK\n```\n\n전체 앱 링크를 인코딩하려면 `encodeURIComponent` 또는 프로그래밍 언어에서 이에 해당하는 요소를 사용하세요. 앱 링크에 쿼리 매개 변수가 포함된 경우 전체 앱 링크를 `open`인코딩하기 전에 해당 쿼리 매개 변수 값을 인코딩합니다.\n\n예를 들어 리포지토리를 열려면 앱 링크는 다음과 같습니다.\n\n```text\nghapp://github.com/OWNER/REPO\n```\n\n시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n```\n\n공개 링크는 공식 `ghapp://` 체계를 사용해야 합니다. 앱은 호환성을 위해 `github-app://` 및 `gh://` 링크도 허용하지만, 생성되거나 문서에 명시되는 링크에는 `ghapp://`를 사용해야 합니다.\n\n## 리포지토리 또는 작업 항목 열기\n\nGitHub Copilot app에서 페이지를 열려면 열려는 페이지의 앱 링크를 사용하여 런처 URL을 구성합니다.\n\n* 리포지토리를 열려면 다음 앱 링크를 사용합니다.\n\n   ```text\n   ghapp://github.com/OWNER/REPO\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n   ```\n\n* 문제를 열려면 다음 앱 링크를 사용합니다.\n\n   ```text\n   ghapp://github.com/OWNER/REPO/issues/NUMBER\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123\n   ```\n\n* 끌어오기 요청을 열려면 다음 앱 링크를 사용합니다.\n\n   ```text\n   ghapp://github.com/OWNER/REPO/pull/NUMBER\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123\n   ```\n\n* 에이전트 작업을 다시 시작하려면 다음 앱 링크를 사용합니다.\n\n   ```text\n   ghapp://github.com/OWNER/REPO/tasks/TASK_ID\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID\n   ```\n\n   \nGitHub에 `TASK_ID` 작업 ID를 사용합니다. 에이전트 작업을 다시 GitHubCopilot 시작하는 링크에는 런타임 세션 ID 또는 앱 로컬 세션 URL을 사용하지 마세요.\n\n## 세션 열기\n\n딥 링크 `ghapp://session/new` 에서 새 세션을 시작하려면 쿼리 매개 변수와 함께 리포지토리, 분기, 끌어오기 요청, 프롬프트 또는 모드를 미리 채웁니다. 사용 가능한 매개 변수는 [세션 매개 변수를 참조하세요](#session-parameters).\n\n예를 들어 리포지토리 및 킥오프 프롬프트를 사용하여 새 대화형 세션을 시작하려면 다음 앱 링크를 사용합니다.\n\n```text\nghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests\n```\n\n시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Frepo%3DOWNER%252FREPO%26mode%3Dinteractive%26prompt%3DInvestigate%2520failing%2520tests\n```\n\n### 세션 매개 변수\n\n`ghapp://session/new` 및 `ghapp://session/new/OWNER/REPO` 링크는 다음 쿼리 매개변수를 허용합니다.\n\n| 매개 변수 | 필수 | Notes |\n| --- | --- | --- |\n| `repo` | \n`ghapp://session/new`에는 필수이며 `ghapp://session/new/OWNER/REPO`에는 선택 사항입니다 | 형식의 `OWNER/REPO` 리포지토리입니다. |\n| `pr` | No | 양수 끌어오기 요청 번호. 와 함께 `branch`사용할 수 없습니다. |\n| `branch` | No | 새 세션의 기본 브랜치 와 함께 `pr`사용할 수 없습니다. |\n| `prompt` | No | 킥오프 프롬프트. URL에 비밀 또는 중요한 사용자 콘텐츠를 포함하지 마세요. |\n| `mode` | No | \n`plan`, `interactive`, 또는 `autopilot` 중 하나. |\n\n## 개방형 자동화\n\n자동화를 열거나 딥 링크에서 새 자동화 초안을 만들려면 자동화 앱 링크를 사용합니다. 새 자동화 초안을 만들 때 사용할 수 있는 매개 변수는 [Automation 매개 변수](#automation-parameters)를 참조하세요.\n\n* Automations 페이지를 열려면 다음 앱 링크를 사용합니다.\n\n   ```text\n   ghapp://automations\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations\n   ```\n\n* 새 자동화 초안을 열려면 다음 앱 링크를 사용합니다.\n\n   ```text\n   ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issues\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2Fnew%3Fname%3DDaily%2520triage%26trigger%3Ddaily%26time%3D09%253A00%26prompt%3DSummarize%2520new%2520issues\n   ```\n\n* 기존 자동화를 열려면 다음 앱 링크를 사용합니다.\n\n   ```text\n   ghapp://automations/AUTOMATION_ID\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID\n   ```\n\n* 클라우드 자동화를 열려면 인코딩하기 전에 앱 링크에 추가 `mode=cloud` 합니다.\n\n   ```text\n   ghapp://automations/AUTOMATION_ID?mode=cloud\n   ```\n\n   시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID%3Fmode%3Dcloud\n   ```\n\n### 자동화 매개변수\n\n`ghapp://automations/new` 링크를 클릭하면 새 자동화 대화 상자가 열립니다. 사용자가 대화 상자를 검토하고 앱에서 확인할 때까지 자동화를 만들지 않습니다. URL에 포함된 프롬프트에 비밀 또는 중요한 사용자 콘텐츠를 포함하지 마세요.\n\n| 매개 변수 | 적용 대상 | Notes |\n| --- | --- | --- |\n| `name` | `ghapp://automations/new` | 자동화 이름. |\n| `prompt` | `ghapp://automations/new` | 자동화 프롬프트입니다. URL에 비밀 또는 중요한 사용자 콘텐츠를 포함하지 마세요. |\n| `trigger` | `ghapp://automations/new` | \n`manual`, `hourly`, `daily`, 또는 `weekly` 중 하나. 유효하지 않은 값은 무시됩니다. \n`interval` 는 별칭으로도 허용됩니다. |\n| `time` | `ghapp://automations/new` | \n`HH:mm` 현지 24시간제 형식의 시간입니다. \n`daily` 및 `weekly` 트리거에 대해 허용됩니다. 일별 트리거는 모든 항목이 같은 분을 공유하는 경우 쉼표로 구분되거나 반복되는 시간도 허용합니다. 예시: `time=08:00,13:00`. 유효하지 않은 값은 무시됩니다. |\n| `day` | `ghapp://automations/new` | 주간 요일: `0`-`6`(`0` = 일요일) 또는 요일 이름 유효하지 않은 값은 무시됩니다. \n`schedule_day` 는 별칭으로도 허용되며, 매주 트리거는 쉼표로 구분되거나 반복되는 값(예: `schedule_day=1,3,5`.)을 허용합니다. |\n| `mode` | \n`ghapp://automations/AUTOMATION_ID` 및 `ghapp://automations/AUTOMATION_ID/RUN_ID` | 클라우드 자동화에 사용합니다 `cloud` . 생략하거나 로컬 자동화에 사용합니다 `local` . |\n\n## 플러그 인 흐름 열기\n\n딥 링크에서 플러그 인 설치 또는 마켓플레이스 흐름을 열려면 플러그 인 앱 링크를 사용합니다. 사용 가능한 매개 변수는 [플러그 인 매개 변수를 참조하세요](#plugin-parameters).\n\n예를 들어 미리 채워진 원본으로 플러그 인 설치 양식을 열려면 다음 앱 링크를 사용합니다.\n\n```text\nghapp://plugins/install?source=my-plugin%40acme\n```\n\n시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme\n```\n\n### 플러그 인 매개 변수\n\n플러그 인 링크는 양식이 미리 채워진 **사용자 지정**에서 **플러그 인** 보기를 엽니다. 사용자가 앱에서 확인할 때까지 플러그 인을 설치하거나 마켓플레이스를 추가하지 않습니다.\n\n| Link | 매개 변수 | 필수 | Notes |\n| --- | --- | --- | --- |\n| `ghapp://plugins/install` | `source` | Yes | 플러그 인 소스 형식입니다 `PLUGIN@MARKETPLACE` . 예를 들어 `source=my-plugin%40acme`값을 URL로 인코딩합니다. |\n| `ghapp://plugins/marketplace/add` | `source` | Yes | Marketplace 소스를 `OWNER/REPO` 또는 Git URL로 예를 들어 `source=acme%2Fplugins`값을 URL로 인코딩합니다. |\n\n## 사용 가능한 앱 링크\n\n다음 앱 링크는 호스트된 시작 관리자에 래핑할 수 있습니다. 쿼리 문자열 및 해시는 앱이 링크를 열 때 유지됩니다.\n\n| 앱 링크 셰이프 | 열기 | Notes |\n| --- | --- | --- |\n| `ghapp://` | 집 | 앱 홈 경로를 엽니다. |\n| `ghapp://chats` | 채팅 | 채팅을 엽니다. |\n| `ghapp://mywork` | 내 업무 | My work에서 이슈 및 끌어오기 요청을 엽니다. |\n| `ghapp://github.com/OWNER/REPO` | 리포지토리 설정 | 리포지토리를 열거나 복제합니다. |\n| `ghapp://github.com/OWNER/REPO/issues/NUMBER` | Issue | 리포지토리가 프로젝트로 이미 추가된 경우 내 작업에서 문제를 엽니다. |\n| `ghapp://github.com/OWNER/REPO/pull/NUMBER` | 끌어오기 요청 | 리포지토리가 프로젝트로 이미 추가된 경우 내 작업에서 끌어오기 요청을 엽니다. 선택적 후행 경로 세그먼트는 유지됩니다. |\n| `ghapp://github.com/OWNER/REPO/tasks/TASK_ID` | 에이전트 작업 | \nGitHub\nCopilot 에이전트 작업을 재개합니다. \nGitHub 앱-로컬 세션 ID가 아닌 작업 ID를 사용합니다. |\n| `ghapp://automations` | Automations | 자동화를 엽니다. |\n| `ghapp://automations/new` | 새 자동화 초안 | 지원되는 쿼리 매개 변수가 미리 채워진 새 자동화 대화 상자를 엽니다. \n[Automation 매개 변수를 참조하세요](#automation-parameters). |\n| `ghapp://automations/AUTOMATION_ID` | Automation | 기본적으로 로컬 자동화를 엽니다. 클라우드 자동화를 위해 `?mode=cloud`를 추가합니다. |\n| `ghapp://automations/AUTOMATION_ID/RUN_ID` | 자동화 실행 | 기본적으로 로컬 자동화 실행을 엽니다. 클라우드 자동화 실행용 `?mode=cloud`를 추가합니다. |\n| `ghapp://recent` | 최근 작업 영역 | 최근 작업 영역을 엽니다. |\n| `ghapp://sessions/SESSION_ID` | 앱 세션 | 앱 로컬 작업 영역 또는 세션을 엽니다. 이 도형을 사용하여 GitHub Copilot 에이전트 작업을 재개하지 마세요. |\n| `ghapp://clone/OWNER/REPO` | 리포지토리 설정 | 리포지토리 설정을 복제하거나 열기 전에 확인을 표시합니다. |\n| `ghapp://repo/OWNER/REPO` | 리포지토리 설정 | 리포지토리 설정을 복제하거나 열기 전에 확인을 표시합니다. |\n| `ghapp://session/new` | 새 세션 | 세션을 만들기 전에 확인을 표시합니다. 쿼리 매개 변수를 사용하여 리포지토리, 끌어오기 요청, 분기, 프롬프트 또는 세션 모드를 제공합니다. \n[세션 매개 변수를 참조하세요](#session-parameters). |\n| `ghapp://session/new/OWNER/REPO` | 리포지토리에 대한 새 세션 | 리포지토리에 대한 세션을 만들기 전에 확인을 표시합니다. \n[세션 매개 변수를 참조하세요](#session-parameters). |\n| `ghapp://plugins/install` | 플러그 인 설치 양식 | 확인을 표시한 다음 설치 양식이 미리 채워진 **사용자 지정** 탭에서 **플러그 인** 보기를 엽니다. \n[플러그 인 매개 변수를 참조하세요](#plugin-parameters). |\n| `ghapp://plugins/marketplace/add` | 플러그 인 마켓플레이스 양식 | 확인을 표시한 다음, 마켓플레이스 양식이 미리 채워진 **사용자 지정** 탭에서 **플러그 인** 보기를 엽니다. \n[플러그 인 매개 변수를 참조하세요](#plugin-parameters). |"}