GitHub Apps の概要
GitHub Apps は、 GitHubの機能を拡張するツールです。 GitHub Apps では、未解決の問題、pull request に関するコメント、プロジェクトの管理など、 GitHub に関する操作を行うことができます。 また、GitHubで発生するイベントに基づいて、GitHubの外部で行うこともできます。 たとえば、 GitHub App は、 GitHubで問題が開かれたときに Slack に投稿できます。
検索 GitHub Apps
GitHub Marketplaceでを検出できます。 エンタープライズ アカウントにサード パーティ製アプリケーションをインストールすることはできません。サードパーティのアプリケーションは、企業または企業内の組織が所有している必要があります。
メモ
GitHub Marketplace のアプリは、現在 GHE.com で使用できません。
独自の GitHub Appを構築することもできます。 詳しくは、「GitHub アプリの作成について」をご覧ください。
GitHub Apps の使用
GitHub Appを使用するには、enterprise、ユーザー、または組織アカウントにアプリをインストールする必要があります。 アプリをインストールすると、アカウントのデータの読み取りまたは変更のアクセス許可がアプリに付与されます。 特定のアクセス許可はアプリによって異なり、 GitHub はアプリをインストールする前にアプリが要求したアクセス許可を示します。 組織またはユーザー アカウントにアプリをインストールするときに、アプリがアクセスできるリポジトリも指定します。 エンタープライズ アカウントにインストールされたアプリは、エンタープライズ自体のみを管理でき、組織またはリポジトリのアクセス許可は付与されません。
アプリで追加の構成が必要な場合は、その構成を行うようアプリで指示されます。 詳細については、「 個人向けアカウント用に GitHub Marketplace から GitHub アプリをインストールする、 Organization の GitHub Marketplace から GitHub アプリをインストールする、サードパーティ製 GitHub App のインストール 、 独自のGitHub アプリのインストール」を参照してください。
また、ID を確認したり、アクセスできるリソースを把握したり、ユーザーに代わってアクションを実行したりするために、 GitHub App を承認する必要がある場合もあります。 アプリを承認する必要がある場合は、それを求めるメッセージがアプリで表示されます。 アプリがユーザーに代わって操作する場合、リソースを所有するアカウントにそのアプリがインストールされ、適切なアクセス許可が付与されている限り、そのアプリはユーザーと同じリソースにアクセスできます。 詳しくは、「GitHub アプリの承認」をご覧ください。
場合によっては、 GitHub App は更新されたアクセス許可を要求します。 GitHub は、これが発生すると通知します。 アプリを引き続き機能させるには、更新されたアクセス許可を確認して承認する必要があります。 詳しくは、「GitHub アプリの更新されたアクセス許可の承認」をご覧ください。
GitHub Appをインストールまたは承認する前に、アプリ開発者を信頼していることを確認する必要があります。 アプリを使わなくなった場合は、アプリの一時停止またはアンインストールと、アプリの承認の取り消しの両方または一方を、行う必要があります。 詳細については、「インストールされている GitHub Apps の確認と変更」および「GitHub アプリの承認の確認と取り消し」を参照してください。
エージェント アプリ
メモ
Agent apps are currently in パブリック プレビュー and subject to change.
エージェント アプリ are GitHub Apps that expose agents on GitHub. GitHub partners build エージェント アプリ to bring their tools and services into your development workflow. These エージェント アプリ are agents you can delegate work to alongside Copilot クラウドエージェント and other third-party agents. Copilot クラウドエージェントを利用して、問題、プル要求、エージェント UI からこれらのエージェントをトリガーできます。
エージェント アプリをインストールすると、エージェント機能を有効にするかどうかを確認するメッセージが表示されます。 詳しくは、「エージェント アプリについて」をご覧ください。
企業が所有する組織にアプリがインストールされている場合、管理者はエージェント機能を使用できるようになる前に、"エージェント アプリ" Copilot ポリシーも有効にする必要があります。
GitHub Apps および OAuth apps
GitHub では、 OAuth appsもサポートされます。 GitHub Appsとは異なり、OAuth appをインストールしたり、アクセスできるリポジトリを制御したりすることはありません。
OAuth appsとGitHub Appsの両方で OAuth 2.0 が使用されます。
OAuth apps はユーザーに代わってのみ動作できますが、 GitHub Apps はユーザーの代わりに動作することも、ユーザーとは独立して動作することもできます。
詳細については、「GitHub アプリと OAuth アプリの違い」および「OAuth アプリの承認」を参照してください。