Skip to main content
Skip to content

ディープ リンクを使用して GitHub Copilot アプリを開く

ディープ リンクを使用してターミナル、チケット、および内部ツールから GitHub Copilot app を起動し、ユーザーが適切なリポジトリ、プル要求、自動化、またはセッションに直接ジャンプできるようにします。

この機能を使用できるユーザーについて

GitHub Copilot appは、すべてのCopilotプランで使用できます。
GitHub Copilot app をダウンロードします。

ディープ リンクを使用すると、コンテキスト切り替えの少ない GitHub Copilot app で作業を開始できます。 たとえば、キックオフ プロンプトを共有したり、マークダウン ファイルにアプリへのリンクを含めたり、ターミナル スクリプトからアプリを起動したり、外部ツールでアプリを開くためのボタンを追加したりできます。

ホストされているランチャーでアプリ リンクをラップするブラウザー リンクから GitHub Copilot app を開くことができます。 ホストされているランチャーは、可能な場合はアプリを開き、ブラウザーがアプリに渡すことができない場合はフォールバック ページを表示します。 サポートされているアプリ リンクの完全な一覧については、「 使用可能なアプリのリンク」を参照してください。

Web ページまたはワークフローからアプリ内の特定のページまたはタスクに直接移動する場合は、ディープ リンクを使用します。 一般的なユース ケースは次のとおりです。

  • 事前に入力されたキックオフ プロンプトでセッションを開始します。
  • チームメイトがすばやく開いて再利用できるように、自動化プロンプトを共有します。
  • 内部ドキュメントまたはマークダウン ファイルに起動ボタンを追加して、一般的なワークフローを開きます。
  • ローカル ワークフローの一部としてターミナル コマンドまたはスクリプトからアプリを起動します。
  • 課題管理システムやチケットシステムなどのサードパーティ製品からアプリを開きます。

ランチャー URL 形式

open クエリ パラメーターでエンコードされた完全なアプリ リンクで、ホストされたランチャー URL を使用します。 ホストされているランチャーは、可能な場合はアプリを開き、ブラウザーがアプリに渡すことができない場合はフォールバック ページを表示します。

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

完全なアプリ リンクをエンコードするには、 encodeURIComponentまたは同等のプログラミング言語を使用します。 アプリ リンクにクエリ パラメーターが含まれている場合は、 openの完全なアプリ リンクをエンコードする前に、これらのクエリ パラメーター値をエンコードします。

たとえば、リポジトリを開くには、アプリのリンクを次に示します。

ghapp://github.com/OWNER/REPO

ランチャー URL でエンコードされ、次のようになります。

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

パブリック リンクでは、公式の ghapp:// スキームを使用する必要があります。 アプリは互換性のために github-app:// リンクと gh:// リンクも受け入れますが、生成および文書化されたリンクでは ghapp://を使用する必要があります。

リポジトリまたは作業項目を開く

GitHub Copilot appでページを開くには、開くページのアプリ リンクを使用してランチャー URL を作成します。

  • リポジトリを開くには、次のアプリ リンクを使用します。

    ghapp://github.com/OWNER/REPO
    

    ランチャー URL でエンコードされ、次のようになります。

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO
    
  • 問題を開くには、次のアプリ リンクを使用します。

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

    ランチャー URL でエンコードされ、次のようになります。

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123
    
  • pull request を開くには、次のアプリ リンクを使用します。

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

    ランチャー 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 でエンコードされ、次のようになります。

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

GitHubには、TASK_ID タスク ID を使用します。 GitHub Copilot エージェント タスクを再開するリンクには、ランタイム セッション ID またはアプリ ローカルのセッション URL を使用しないでください。

セッションを開く

ディープ リンクから新しいセッションを開始するには、 ghapp://session/new クエリ パラメーターを使用して、リポジトリ、ブランチ、プル要求、プロンプト、またはモードを事前入力します。 使用可能なパラメーターについては、「 セッション パラメーター」を参照してください。

たとえば、リポジトリとキックオフ プロンプトを使用して新しい対話型セッションを開始するには、次のアプリ リンクを使用します。

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

ランチャー URL でエンコードされ、次のようになります。

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

リポジトリを選択せずにプロンプトを準備するには、 repo を省略し、 prompt または agentを指定します:

ghapp://session/new?prompt=Investigate%20failing%20tests

ランチャー URL でエンコードされ、次のようになります。

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Fprompt%3DInvestigate%2520failing%2520tests

リンクを承認すると、リポジトリが選択されていない状態で新しいセッション ページが開きます。 指定されたプロンプトは、新しいセッション ページの未送信のプロンプトを置き換えます。 プロンプトを確認して送信するまで、何も送信されません。

セッション パラメーター

ghapp://session/newとghapp://session/new/OWNER/REPOのリンクは、これらのクエリ パラメーターを受け入れます。

パラメーター必須メモ
repoリポジトリがパス内にあるか、リンクがリポジトリ固有のパラメーターなしで prompt または agent を提供しない限り、必須
OWNER/REPO形式のリポジトリ。
prやbranchなど、リポジトリ固有のパラメーターにはリポジトリが必要です。
prいいえ正の値のプルリクエスト番号。
branchと組み合わせることはできません。
branchいいえ新しいセッションのベース ブランチ。
prと組み合わせることはできません。
promptいいえ開始用プロンプト。 URL にシークレットや機密性の高いユーザー コンテンツを含めないでください。
modeいいえ
plan、interactive、またはautopilotのいずれか。
agentいいえカスタム エージェント ID または名前。 リポジトリがない場合にのみサポートされます。

プロジェクトの作成

ghapp://project/new をクリックした後、**** を使用して新しい永続的なProjectを作成します。 このリンクでは、既存のプロジェクトは開きません。

ghapp://project/new?name=Release&repo=OWNER%2FREPO

ランチャー URL でエンコードされ、次のようになります。

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fproject%2Fnew%3Fname%3DRelease%26repo%3DOWNER%252FREPO

すべてのパラメーターは省略可能です。

パラメーターメモ
nameProject名(最大 40 文字)。
color
neutral、green、blue、violet、pink、red、orange、yellow のいずれかです。
iconLucide アイコン名 ( Rocket や BookOpenなど)。
repo
OWNER/REPO形式でProjectの複製と設定を行うリポジトリ。 複数のリポジトリに対してこのパラメーターを繰り返します。
promptリポジトリがなくても、承認後に実行されるキックオフ プロンプト。 URL にシークレットや機密性の高いユーザー コンテンツを含めないでください。

プロンプトなしで、Project は提供されたすべてのリポジトリをセットアップします。 プロンプトまたはリポジトリがないと、リポジトリのセットアップを提供します。

モデルを選択する

ghapp://?select_model=MODEL_IDを使用してアプリで新しいセッション ページを開き、確認後に有効なモデルを選択します。 MODEL_IDをモデルの ID に置き換えるか、アプリの設定に応じてautoを使用してCopilot Fusionまたは自動を選択します。

ghapp://?select_model=auto

ランチャー URL でエンコードされ、次のようになります。

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

これにより、モデルの選択のみが変更されます。 未送信の新しいセッションドラフトと現在の自動作業レベルが保持され、セッションの作成やプロンプトの送信は行われません。 モデル選択リンクは、クラウド セッションではなく、ローカル セッションまたはワークツリー セッションで機能します。 要求されたモデルがポリシーで使用できないか無効になっている場合、アプリは別のモデルを選択する代わりにエラーを表示します。

オートメーションを開く

オートメーションを開くか、ディープ リンクから新しいオートメーション ドラフトを作成するには、Automation アプリのリンクを使用します。 新しいオートメーション ドラフトを作成するときに使用できるパラメーターについては、「 Automation パラメーター」を参照してください。

  • Automations ページを開くには、次のアプリ リンクを使用します。

    ghapp://automations
    

    ランチャー 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 でエンコードされ、次のようになります。

    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 でエンコードされ、次のようになります。

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID
    
  • クラウドオートメーションを開くには、エンコードする前に mode=cloud をアプリリンクに追加します。

    ghapp://automations/AUTOMATION_ID?mode=cloud
    

    ランチャー URL でエンコードされ、次のようになります。

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

オートメーション パラメーター

ghapp://automations/new リンクで、新しいオートメーション ダイアログが開きます。 ユーザーがダイアログを確認してアプリで確認するまで、自動化は作成されません。 URL に埋め込まれたプロンプトにシークレットや機密性の高いユーザー コンテンツを含めないでください。

パラメーター適用対象メモ
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 でエンコードされ、次のようになります。

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

プラグイン パラメーター

プラグインのリンクにより、フォームが事前に入力されたカスタマイズページが開きます。 ユーザーがアプリで確認するまで、プラグインをインストールしたり、マーケットプレースを追加したりすることはありません。

Linkパラメーター必須メモ
ghapp://plugins/installsourceはい
PLUGIN@MARKETPLACE形式のプラグイン ソース。 値を URL エンコードします (例: source=my-plugin%40acme)。
ghapp://plugins/marketplace/addsourceはい
OWNER/REPOまたは Git URL としての Marketplace ソース。 値を URL エンコードします (例: source=acme%2Fplugins)。

次のアプリ リンクは、ホストされているランチャーにラップできます。 クエリ文字列とハッシュは、アプリがリンクを開いたときに保持されます。

アプリ リンクの図形開くメモ
ghapp://新規
[新規] ビューを開き、新しいセッションを開始します。
ghapp://?select_model=MODEL_ID新しいセッション ページでのモデルの選択要求されたモデルを選択する前に確認を表示します。
「モデルの選択」を参照してください。
ghapp://project/new新しいプロジェクト永続的なプロジェクトを作成する前に確認を表示します。
「プロジェクトの作成」を参照してください。
ghapp://chatsチャットチャットを開きます。
ghapp://mywork自分の作業[マイ ワーク] で問題と pull request を開きます。
ghapp://github.com/OWNER/REPOリポジトリの設定リポジトリを開くか複製します。
ghapp://github.com/OWNER/REPO/issues/NUMBERIssueリポジトリが既にアプリに接続されている場合に、アプリでIssueを開きます。
ghapp://github.com/OWNER/REPO/pull/NUMBERPull request(プルリクエスト)リポジトリが既にアプリに接続されている場合に、アプリでプル要求を開きます。 省略可能な末尾のパス セグメントは保持されます。
ghapp://github.com/OWNER/REPO/tasks/TASK_IDエージェント タスク
GitHub Copilot エージェント タスクを再開します。 アプリ ローカル セッション ID ではなく、 GitHub タスク ID を使用します。
ghapp://automationsAutomationsオートメーションを開きます。
ghapp://automations/new新しい自動化の下書きサポートされているクエリ パラメーターが事前に入力された新しいオートメーション ダイアログを開きます。
オートメーション パラメーターを参照してください。
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 フォームが事前入力された カスタマイズ を開きます。
プラグインパラメーターを参照してください。