プラグインをビルドすると、ユーザーはMicrosoft 365 Copilotを介して自然言語を使用して Web サービスと対話できるようになります。 プラグインは、Copilot のスキルを拡張して、ユーザーに代わってタスクを実行します。 彼らは特に得意です:
- リアルタイム情報へのアクセス
- リレーショナル データの取得
- アプリ間でのアクションの実行
重要
- API プラグインは現在、 宣言型エージェント内のアクションとしてのみサポートされています。 Microsoft 365 Copilotでは有効になっていません。 宣言型エージェントに API プラグインを追加する方法を示す例については、「カスタム アクションとして API プラグインをエージェントに追加する」を参照してください。
- この機能は、すべてのMicrosoft 365 Copilotライセンステナントで既定で有効になっています。 管理者は、ユーザーとグループごとにこの機能を無効にし、個々のプラグインの使用を承認する方法と、有効にするプラグインを制御できます。 詳細については、「 統合アプリでのエージェントの管理」を参照してください。
優れたプラグインの品質
プラグインの明確で簡潔な説明は、Copilot がその機能を認識し、適切なユーザー タスクと一致させるために不可欠です。 次の特性を使用してプラグインを設計することで、プラグインが実行時に可能な限り最高のユーザー エクスペリエンスを提供することを確認できます。
サポート検索
ユーザーが実行する最も一般的な検索を予測してサポートします。
ディープ コンテンツを取得する
検索が周囲の段落と一致していることを確認します。 アダプティブ カードの応答に追加情報を提供します。
実行可能な結果を表示する
Web サイトへのディープ リンクやモーダル ダイアログなど、ユーザーがアクションを実行する方法を含めます。
プレビューを提供する
コンテンツ プレビューをユーザーにガイドします。
プラグインのベスト プラクティス
このセクションでは、高品質のプラグインを構築するためのベスト プラクティスについて説明します。
安全で責任ある AI を構築する
- アンチ競合: 短い説明と完全な説明の両方で他のプラグインの名前を使用しないでください。
- 責任ある AI: 不適切または不快なキーワードの使用を避けます。
- プロンプト挿入: テキストがプロンプト挿入に至らないようにします。 また、説明には、プロンプト挿入のコードとして使用できることを示す記号やテキストを含めることはできません。 アプリを再帰的に呼び出すフレーズ、関数、コードは使用しないでください。
複数パラメーターの検索クエリをサポートする
複雑なプロンプトをサポートするには、プラグイン アプリ マニフェストで複数パラメーターのサポートを有効にすることで、検索サポートのスコープを拡張して、3 つ以上の検索クエリ parametersを同時に処理します。
検索パラメーターに適切な説明と明示的な入力型と出力形式があることを確認します。
プラグイン、そのスキル、パラメーターの一般的な説明を避ける
プラグインが何を行い、何をしないかの説明を正確にしてください。 Copilot がプラグインを使用する可能性を高めるために追加情報を追加したくなる一方で、次のような望ましくない結果が生じる可能性があります。
一般的なプラグインの説明を使用すると、ジョブの適切なプラグインが取得されなくなり、頻繁に発生する場合、ユーザーはプラグインを無効にすることがあります。
正しく選択されていない場合、プラグインの実行または応答でエラーが発生する可能性があります。 Copilot は、ユーザーの信頼を損なう可能性がある、高いエラー率を持つプラグインを表示しません。
Copilot が必要な入力を推測できるとは想定しないでください
限られたシナリオでのみ、Copilot はユーザー プロンプトへの入力を推測できます。 ほとんどの場合、プラグイン クエリに必要な入力は、ユーザーのプロンプトで Copilot に明示的に記述する必要があります。 ベスト プラクティスとして、Copilot に対して異なるプロンプトでプラグインをテストし、予想される動作を予測します。
Copilot がプラグインの応答に対する推論の観点から実行できる操作を検証する
Copilot はプラグイン応答の出力を推論するための基本的な機能を提供しますが、結果はシナリオによって異なります。 ベスト プラクティスとして、予想される動作を予測するために後処理を必要とするさまざまなプロンプトでプラグインをテストします。
ユーザー クエリに視覚的にリッチな応答を提供する
構造化され、実用的で視覚的に豊富な アダプティブ カードを使用して、ユーザー入力に応答します。 アダプティブ カードの応答で豊富な情報が提供されていることを確認し、少なくとも 1 つのアクション ボタンと 2 つの追加の情報 (アプリのロゴ、タイトル、サムネイル、および情報のタイトルに加えて) を含めます。 状態、日付、フィールドへの割り当てなど、最も頻繁に検索される属性を指定すると便利です。