Copilot 拡張機能の設定

1.Copilot エージェント について理解する

Copilot エージェント には Copilot Extension 用のカスタム コードが含まれ、GitHub App と統合して Copilot Extension 自体を形成します。 詳しくは、「GitHub Copilot の拡張機能用のエージェントについて」をご覧ください。

Copilot エージェント を正しく構築するには、エージェントが次のものと通信する方法を理解する必要があります。

• サーバー送信イベントを使用する Copilot プラットフォーム。 「Copilot プラットフォームと通信するように Copilot エージェントを構成する」を参照してください。
• GitHub API。 「GitHub と通信するように Copilot エージェントを構成する」を参照してください。

2.Copilot エージェント の例と 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 エージェント を構築する

前の手順の参照資料を使い、Copilot エージェント を計画して構築します。 次のオプションのいずれかの実装を選択できます。

• 独自の LLM デプロイの構築と管理を回避するために、エージェントは Copilot LLM デプロイを呼び出すことができます。 「エージェントに Copilot の LLM を使用する」を参照してください。
• ユーザーによる入力をすばやく解釈し、実行するさまざまな定義済みの関数から選択するには、エージェントで関数呼び出しを実装することができます。 詳細については、Azure OpenAI ドキュメントの「Azure OpenAI Service で関数呼び出しを使用する方法」および OpenAI ドキュメントの「関数呼び出し」を参照してください。

4. Copilot エージェント をデプロイする

Copilot エージェント が Copilot プラットフォームと GitHub にアクセスできるようにするには、HTTP 要求で到達可能なサーバーにそれをデプロイする必要があります。 「Copilot 拡張機能をホストするためのサーバーの構成」を参照してください。

5.GitHub App を作成して Copilot エージェント と統合する

Copilot Extension を作成するには、GitHub App を作成して構成した後、それを Copilot エージェント と統合する必要があります。 「Copilot 拡張機能用の GitHub アプリの作成」と「Copilot 拡張機能用の GitHub アプリの構成」を参照してください。

6.Copilot Extension の可用性を選択する

Copilot Extension の 2 つの可視性レベルのいずれかを選びます。

• パブリック: 拡張機能のインストール ページへのリンクを持つ任意のユーザーまたは組織アカウントでインストールできます。
• プライベート: 拡張機能を作成したユーザーまたは組織アカウントのみでインストールできます。

Copilot Extension を公開する場合は、それが GitHub Marketplace に登録されるようにすることもできます。

Copilot Extension の可視性を変更し、それを GitHub Marketplace に登録する方法については、「Copilot 拡張機能の可用性の管理」をご覧ください。

次のステップ

Copilot Extension の使用方法については、「拡張情報を使用して外部ツールを Copilot Chat と統合する」をご覧ください。