딥 링크를 사용하여 GitHub Copilot 앱 열기

사용자가 올바른 리포지토리, 풀 리퀘스트, 자동화 또는 세션으로 바로 이동할 수 있도록 딥 링크를 사용해 터미널이나 티켓, 내부 도구에서 GitHub Copilot 앱를 실행하세요.

누가 이 기능을 사용할 수 있나요?

GitHub Copilot 앱 는 모든 유료 Copilot 플랜에 사용할 수 있습니다.
Sign up for Copilot

이 기사에서

딥 링크는 더 적은 컨텍스트 전환으로 GitHub Copilot 앱 작업을 시작하는 데 도움이 됩니다. 예를 들어 킥오프 프롬프트를 공유하거나, markdown 파일에 앱에 대한 링크를 포함하거나, 터미널 스크립트에서 앱을 시작하거나, 외부 도구에서 앱을 여는 단추를 추가할 수 있습니다.

브라우저 링크가 앱 링크를 감싸는 호스팅된 런처에서 GitHub Copilot 앱를 열 수 있습니다. 호스트된 시작 관리자가 가능하면 앱을 열고 브라우저가 앱에 전달할 수 없는 경우 대체 페이지를 표시합니다. 지원되는 앱 링크의 전체 목록은 사용 가능한 앱 링크를 참조하세요.

웹 페이지 또는 워크플로에서 앱의 특정 페이지 또는 작업으로 직접 이동하려는 경우 딥 링크를 사용합니다. 일반 사용 사례는 다음과 같습니다.

  • 미리 채워진 킥오프 프롬프트를 사용하여 세션을 시작합니다.
  • 팀원이 신속하게 열고 다시 사용할 수 있도록 자동화 프롬프트를 공유합니다.
  • 내부 문서 또는 markdown 파일에 시작 단추를 추가하여 일반적인 워크플로를 엽니다.
  • 로컬 워크플로의 일부로 터미널 명령 또는 스크립트에서 앱을 시작합니다.
  • 이슈 추적 시스템 또는 티켓 시스템과 같은 타사 제품에서 앱을 엽니다.

시작 관리자 URL 형식

쿼리 매개 변수에 인코딩된 전체 앱 링크와 함께 호스트된 시작 관리자 URL을 open 사용합니다. 호스트된 시작 관리자가 가능하면 앱을 열고 브라우저가 앱에 전달할 수 없는 경우 대체 페이지를 표시합니다.

https://github.com/copilot/app/launch?open=ENCODED_APP_LINK

전체 앱 링크를 인코딩하려면 encodeURIComponent 또는 프로그래밍 언어에서 이에 해당하는 요소를 사용하세요. 앱 링크에 쿼리 매개 변수가 포함된 경우 전체 앱 링크를 open인코딩하기 전에 해당 쿼리 매개 변수 값을 인코딩합니다.

예를 들어 리포지토리를 열려면 앱 링크는 다음과 같습니다.

ghapp://github.com/OWNER/REPO

시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO

공개 링크는 공식 ghapp:// 체계를 사용해야 합니다. 앱은 호환성을 위해 github-app:// 및 gh:// 링크도 허용하지만, 생성되거나 문서에 명시되는 링크에는 ghapp://를 사용해야 합니다.

리포지토리 또는 작업 항목 열기

GitHub Copilot 앱에서 페이지를 열려면 열려는 페이지의 앱 링크를 사용하여 런처 URL을 구성합니다.

  • 리포지토리를 열려면 다음 앱 링크를 사용합니다.

    ghapp://github.com/OWNER/REPO

    시작 관리자 URL에서 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO

  • 문제를 열려면 다음 앱 링크를 사용합니다.

    ghapp://github.com/OWNER/REPO/issues/NUMBER

    시작 관리자 URL에서 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123

  • 끌어오기 요청을 열려면 다음 앱 링크를 사용합니다.

    ghapp://github.com/OWNER/REPO/pull/NUMBER

    시작 관리자 URL에서 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123

  • 에이전트 작업을 다시 시작하려면 다음 앱 링크를 사용합니다.

    ghapp://github.com/OWNER/REPO/tasks/TASK_ID

    시작 관리자 URL에서 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID

TASK_ID에 GitHub 작업 ID를 사용합니다. 에이전트 작업을 다시 GitHubCopilot 시작하는 링크에는 런타임 세션 ID 또는 앱 로컬 세션 URL을 사용하지 마세요.

세션 열기

딥 링크 ghapp://session/new 에서 새 세션을 시작하려면 쿼리 매개 변수와 함께 리포지토리, 분기, 끌어오기 요청, 프롬프트 또는 모드를 미리 채웁니다. 사용 가능한 매개 변수는 세션 매개 변수를 참조하세요.

예를 들어 리포지토리 및 킥오프 프롬프트를 사용하여 새 대화형 세션을 시작하려면 다음 앱 링크를 사용합니다.

ghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests

시작 관리자 URL에서 인코딩됩니다. 이 URL은 다음과 같습니다.

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Frepo%3DOWNER%252FREPO%26mode%3Dinteractive%26prompt%3DInvestigate%2520failing%2520tests

세션 매개 변수

ghapp://session/new 및 ghapp://session/new/OWNER/REPO 링크는 다음 쿼리 매개변수를 허용합니다.

매개 변수필수Notes
repo
ghapp://session/new에는 필수이며 ghapp://session/new/OWNER/REPO에는 선택 사항입니다형식의 OWNER/REPO 리포지토리입니다.
prNo양수 끌어오기 요청 번호입니다. 와 함께 branch사용할 수 없습니다.
branchNo새 세션의 기본 브랜치 와 함께 pr사용할 수 없습니다.
promptNo킥오프 프롬프트. URL에 비밀 또는 중요한 사용자 콘텐츠를 포함하지 마세요.
modeNo
plan, interactive, 또는 autopilot 중 하나.

개방형 자동화

자동화를 열거나 딥 링크에서 새 자동화 초안을 만들려면 자동화 앱 링크를 사용합니다. 새 자동화 초안을 만들 때 사용할 수 있는 매개 변수는 Automation 매개 변수를 참조하세요.

  • Automations 페이지를 열려면 다음 앱 링크를 사용합니다.

    ghapp://automations

    시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations

  • 새 자동화 초안을 열려면 다음 앱 링크를 사용합니다.

    ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issues

    시작 관리자 URL에서 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2Fnew%3Fname%3DDaily%2520triage%26trigger%3Ddaily%26time%3D09%253A00%26prompt%3DSummarize%2520new%2520issues

  • 기존 자동화를 열려면 다음 앱 링크를 사용합니다.

    ghapp://automations/AUTOMATION_ID

    시작 관리자 URL에서 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID

  • 클라우드 자동화를 열려면 인코딩하기 전에 앱 링크에 추가 mode=cloud 합니다.

    ghapp://automations/AUTOMATION_ID?mode=cloud

    시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID%3Fmode%3Dcloud

자동화 매개변수

ghapp://automations/new 링크를 클릭하면 새 자동화 대화 상자가 열립니다. 사용자가 대화 상자를 검토하고 앱에서 확인할 때까지 자동화를 만들지 않습니다. URL에 포함된 프롬프트에 비밀 또는 중요한 사용자 콘텐츠를 포함하지 마세요.

매개 변수적용 대상Notes
nameghapp://automations/new자동화 이름.
promptghapp://automations/new자동화 프롬프트입니다. URL에 비밀 또는 중요한 사용자 콘텐츠를 포함하지 마세요.
triggerghapp://automations/new
manual, hourly, daily, 또는 weekly 중 하나. 유효하지 않은 값은 무시됩니다.
interval 는 별칭으로도 허용됩니다.
timeghapp://automations/new
HH:mm 현지 24시간제 형식의 시간입니다.
daily 및 weekly 트리거에 대해 허용됩니다. 매일 트리거는 모든 항목이 같은 분을 공유하는 경우 쉼표로 구분되거나 반복되는 시간도 허용합니다. 예를 들면 다음과 같습니다 time=08:00,13:00. 유효하지 않은 값은 무시됩니다.
dayghapp://automations/new주간 요일: 0-6(0 = 일요일) 또는 요일 이름 유효하지 않은 값은 무시됩니다.
schedule_day 는 별칭으로도 허용되며, 매주 트리거는 쉼표로 구분되거나 반복되는 값(예: schedule_day=1,3,5.)을 허용합니다.
mode
ghapp://automations/AUTOMATION_ID 및 ghapp://automations/AUTOMATION_ID/RUN_ID클라우드 자동화에 사용합니다 cloud . 생략하거나 로컬 자동화에 사용합니다 local .

플러그 인 흐름 열기

딥 링크에서 플러그 인 설치 또는 마켓플레이스 흐름을 열려면 플러그 인 앱 링크를 사용합니다. 사용 가능한 매개 변수는 플러그 인 매개 변수를 참조하세요.

예를 들어 미리 채워진 원본으로 플러그 인 설치 양식을 열려면 다음 앱 링크를 사용합니다.

ghapp://plugins/install?source=my-plugin%40acme

시작 관리자 URL에 인코딩됩니다. 이 URL은 다음과 같습니다.

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme

플러그 인 매개 변수

플러그인 링크를 클릭하면 미리 입력된 양식이 있는 설정 > 플러그인이 열립니다. 사용자가 앱에서 확인할 때까지 플러그 인을 설치하거나 마켓플레이스를 추가하지 않습니다.

Link매개 변수필수Notes
ghapp://plugins/installsourceYes플러그 인 소스 형식입니다 PLUGIN@MARKETPLACE . 예를 들어 source=my-plugin%40acme값을 URL로 인코딩합니다.
ghapp://plugins/marketplace/addsourceYesMarketplace 소스를 OWNER/REPO 또는 Git URL로 예를 들어 source=acme%2Fplugins값을 URL로 인코딩합니다.

다음 앱 링크는 호스트된 시작 관리자에 래핑할 수 있습니다. 쿼리 문자열 및 해시는 앱이 링크를 열 때 유지됩니다.

앱 링크 셰이프열기Notes
ghapp://집앱 홈 경로를 엽니다.
ghapp://chats채팅채팅을 엽니다.
ghapp://mywork내 업무My work에서 이슈 및 끌어오기 요청을 엽니다.
ghapp://github.com/OWNER/REPO리포지토리 설정리포지토리를 열거나 복제합니다.
ghapp://github.com/OWNER/REPO/issues/NUMBERIssue리포지토리가 프로젝트로 이미 추가된 경우 내 작업에서 문제를 엽니다.
ghapp://github.com/OWNER/REPO/pull/NUMBER끌어오기 요청리포지토리가 프로젝트로 이미 추가된 경우 내 작업에서 끌어오기 요청을 엽니다. 선택적 후행 경로 세그먼트는 유지됩니다.
ghapp://github.com/OWNER/REPO/tasks/TASK_ID에이전트 작업
GitHub
Copilot 에이전트 작업을 재개합니다.
GitHub 앱-로컬 세션 ID가 아닌 작업 ID를 사용합니다.
ghapp://automationsAutomations자동화를 엽니다.
ghapp://automations/new새 자동화 초안지원되는 쿼리 매개 변수가 미리 채워진 새 자동화 대화 상자를 엽니다.
Automation 매개 변수를 참조하세요.
ghapp://automations/AUTOMATION_IDAutomation기본적으로 로컬 자동화를 엽니다. 클라우드 자동화를 위해 ?mode=cloud를 추가합니다.
ghapp://automations/AUTOMATION_ID/RUN_ID자동화 실행기본적으로 로컬 자동화 실행을 엽니다. 클라우드 자동화 실행용 ?mode=cloud를 추가합니다.
ghapp://recent최근 작업 영역최근 작업 영역을 엽니다.
ghapp://sessions/SESSION_ID앱 세션앱 로컬 작업 영역 또는 세션을 엽니다. 이 도형을 사용하여 GitHub Copilot 에이전트 작업을 재개하지 마세요.
ghapp://clone/OWNER/REPO리포지토리 설정리포지토리 설정을 복제하거나 열기 전에 확인을 표시합니다.
ghapp://repo/OWNER/REPO리포지토리 설정리포지토리 설정을 복제하거나 열기 전에 확인을 표시합니다.
ghapp://session/new새 세션세션을 만들기 전에 확인을 표시합니다. 쿼리 매개 변수를 사용하여 리포지토리, 끌어오기 요청, 분기, 프롬프트 또는 세션 모드를 제공합니다.
세션 매개 변수를 참조하세요.
ghapp://session/new/OWNER/REPO리포지토리에 대한 새 세션리포지토리에 대한 세션을 만들기 전에 확인을 표시합니다.
세션 매개 변수를 참조하세요.
ghapp://plugins/install플러그 인 설치 양식확인을 표시한 다음 설치 양식이 미리 채워진 설정 > 플러그 인을 엽니다.
플러그 인 매개 변수를 참조하세요.
ghapp://plugins/marketplace/add플러그 인 마켓플레이스 양식확인을 표시한 다음, Marketplace 양식이 미리 채워진 설정 > 플러그 인을 엽니다.
플러그 인 매개 변수를 참조하세요.