Note
GitHub Copilot Extensions は パブリック プレビュー 段階であり、変更される可能性があります。
1. Copilot agents について学習する
Copilot agents には、Copilot Extension のカスタム コードが含まれており、GitHub App と統合して、Copilot Extension 自体を形成します。 詳しくは、「Copilot エージェントについて」を参照してください。
Copilot agent を正常に構築するには、エージェントの通信方法を理解する必要があります。
- サーバー送信イベントを使用する Copilot プラットフォーム。 「Copilot プラットフォームと通信するように Copilot エージェントを構成する」を参照してください。
- GitHub API。 「GitHub と通信するように Copilot エージェントを構成する」を参照してください。
2. 例 Copilot agents と Copilot Extensions SDK を確認する
実際の前の概念を確認し、エージェントの実装について学習するには、次のエージェントとソフトウェア開発キット (SDK) の例を確認してください。これらはすべて、copilot-extensions
組織で利用できます。
- Blackbeard (最適な開始点): Copilot の大規模言語モデル (LLM) API と特別なシステム音声ガイダンスを使用して海賊のように要求に応答する単純なエージェント。
- GitHub Models: GitHub Marketplace に記載されているさまざまな LLM について、Copilot Chat を介して確認し、操作できる、より複雑なエージェント。 GitHub Models エージェントは、関数呼び出しを利用します。
- 関数呼び出し: 関数呼び出しと確認ダイアログを示す Go で記述されたエージェントの例。
- RAG 拡張機能: 取得拡張生成の簡単な実装を示す Go で記述されたエージェントの例。
- プレビュー SDK: 要求の検証、ペイロードの解析、応答の書式設定を自動的に処理することで、Copilot Extensions の開発を効率化する SDK。 この SDK を使用すると、拡張機能ビルダーはコア機能の作成に重点を置き、定型コードに重点を置く必要がなくなりました。
3. Copilot agent を構築する
前の手順の参照資料を使用して、Copilot agent を計画して構築します。 次のオプションのいずれかの実装を選択できます。
- 独自の LLM デプロイの構築と管理を回避するために、エージェントは Copilot LLM デプロイを呼び出すことができます。 「エージェントに Copilot の LLM を使用する」を参照してください。
- ユーザーによる入力をすばやく解釈し、実行するさまざまな定義済みの関数から選択するには、エージェントで関数呼び出しを実装することができます。 詳細については、Azure OpenAI ドキュメントの「Azure OpenAI Service で関数呼び出しを使用する方法」および OpenAI ドキュメントの「関数呼び出し」を参照してください。
4. Copilot agent をデプロイする
Copilot agent を Copilot プラットフォームと GitHub にアクセスできるようにするには、HTTP 要求によって到達可能なサーバーにデプロイする必要があります。 「Configuring your server to host your Copilot extension」を参照してください。
5. GitHub App を作成し、それを Copilot agent と統合する
Copilot Extension を作成するには、GitHub App を作成して構成し、それを Copilot agent と統合する必要があります。 「Copilot 拡張機能用の GitHub アプリの作成」および「Configuring your GitHub App for your Copilot extension」を参照してください。
6. Copilot Extension の可用性を選択する
Copilot Extension の 2 つの可視性レベルのいずれかを選択します。
- パブリック: 拡張機能のインストール ページへのリンクを持つ任意のユーザーまたは組織アカウントでインストールできます。
- プライベート: 拡張機能を作成したユーザーまたは組織アカウントのみでインストールできます。
Copilot Extension を公開している場合は、それを GitHub Marketplace に一覧表示することもできます。
Copilot Extension の可視性を変更し、それを GitHub Marketplace に一覧表示する方法については、「Copilot 拡張機能の可用性の管理」を参照してください。
次のステップ
Copilot Extension の使用方法については、「拡張情報を使用して外部ツールを Copilot Chat と統合する」を参照してください。