ラボ MSA1 - 最初の SharePoint エージェントを作成する

SharePoint エージェント を構築したい場合は、次の ラボ を実施してください。

• MSA1 - 初めての SharePoint エージェント を構築する
• MSA2 - SharePoint エージェント を共有する

目次

このラボでは、SharePoint Online に保存されているドキュメントを扱う SharePoint エージェントを作成します。作成するエージェントは、架空の会社の従業員が人事部 (HR) の情報、ポリシー、規則を取得できるように支援します。エージェントのナレッジ ベースは、SharePoint Online のドキュメント ライブラリに保存されている一連のドキュメントです。

Exercise 1: サンプル ドキュメントのアップロード

この手順では、SharePoint エージェントがユーザーからのプロンプトに回答する際に使用するサンプル ドキュメントをアップロードします。これには、架空の Word、PowerPoint、PDF ファイルが含まれます。

Step 1: SharePoint サイトの作成

Microsoft 365 Portal などの Microsoft 365 内で、「Apps」メニュー 1️⃣ をクリックし、SharePoint 2️⃣ を選択します。

続いて Create Site 1️⃣ を選択し、Team site 2️⃣ を選択します。

Standard team サイト テンプレートを選択すると、サイトのプレビューが表示されます。Use Template を選択して続行します。

サイト名に「Copilot Dev Camp - HR」などを入力 1️⃣ し、Next 2️⃣ を選択します。名前はテナント内で一意である必要があるため、既に使われている名前は使用しないでください。

次にプライバシー設定と言語を選択し、Create Site を選択します。

サイト プロビジョニングが完了したら、メンバー追加をスキップし、Finish を選択します。数秒後、新しい SharePoint サイトが表示されます。

Step 2: サンプル ドキュメントのアップロード

この リンク を選択して、複数のファイル (Word、PowerPoint、PDF) が入った zip ファイルをダウンロードし、ローカル ファイル システムの任意の場所に解凍します。

先ほど作成した SharePoint サイトに戻り、Documents Web パーツで See all を選択してドキュメント ライブラリ ページを表示します。

次に、コマンド バーの Upload 1️⃣ ボタンを選択し、Files 2️⃣ を選択します。

解凍したフォルダーに移動し、すべてのサンプル ドキュメントを選択 1️⃣ して Open 2️⃣ を選択します。

Exercise 2 : 最初の SharePoint エージェントの作成

この演習では、HR ドキュメントを管理する SharePoint エージェントの初期バージョンを作成します。

Step 1: エージェントの作成

前の演習で作成したドキュメント ライブラリ内のすべてのファイルを選択ボタン 1️⃣ で選択し、コマンド バーの Create an agent 2️⃣ コマンドを選択します。

ファイルまたはフォルダーからの SharePoint エージェントの作成

ライブラリで何も選択せずに Create an agent コマンドを選択すると、エージェントは現在のドキュメント ライブラリ全体を対象とします。ライブラリ内でファイルやサブフォルダーを明示的に選択してから Create an agent を選択すると、エージェントは選択されたコンテンツのみを対象とします。1 つのエージェントで選択できるアイテムは 20 個までです。20 個を超えて選択した場合、"Sources limit exceeded. The maximum number of sources you can add is 20. Remove XX sources to save this copilot." というエラー メッセージが表示され、エージェントを作成できません。

選択したコンテンツの概要を確認し、テスト用にエージェントを開くか、作成されたばかりのエージェントを編集できるダイアログ ウィンドウが表示されます。

SharePoint エージェントを作成するための権限

SharePoint エージェントを作成するには、対象のライブラリまたはサイトで Contribute 権限が必要です。エージェントの裏側では新しい .agent ファイルが作成されるため、ユーザーには適切な権限が必要です。

Step 2: エージェントのテスト

先ほどのダイアログ ウィンドウで Open agent ボタンを選択し、新しい SharePoint エージェントを試してみましょう。フルスクリーン ダイアログが表示され、プロンプトを入力してエージェントと対話できます。

次のプロンプトを入力し、結果を確認してみてください。

• What is the process to hire new employees?
• How can I improve my career?

提案された回答は、エージェントのナレッジ ベースとして選択したドキュメントの内容を要約したものになります。プロンプトを処理するエンジンは Microsoft 365 Copilot であり、AI によって生成されたコンテンツであることを示す明確な 注意事項 1️⃣ が表示されています。回答の下部には、回答の生成に使用されたドキュメントへの参照 2️⃣ が示されます。また、エージェントは関連トピックを深掘りするためのフォローアップ プロンプト 3️⃣ も提案します。

エージェントのダイアログを閉じると、ライブラリに New agent.agent という新しいファイルがあることに気付くはずです。これが新しい SharePoint エージェント定義を表すファイルです。SharePoint Online の標準的なファイル名変更機能を使用してファイル名を変更すると、エージェント名およびエージェント ダイアログのタイトルもそれに応じて変更されます。例として、HR agent に名前を変更してみましょう。

Exercise 3 : エージェントの微調整

この演習では、HR agent の追加設定や指示の調整など、エージェントを微調整する方法を学びます。

Step 1: アイコンとタイトルの更新

ドキュメント ライブラリで HR agent.agent ファイルを選択し、... をクリックして SharePoint Online の ECB メニューを開き、Edit コマンドを選択します。あるいは、ライブラリのコマンド バーにある Edit コマンドを選択してもかまいません。

新しいダイアログ ウィンドウが表示され、次の設定を管理できます。

• Overview: 名前、アイコン、目的/説明
• Sources: ナレッジ ベースとして使用するデータ ソース (サイト、ライブラリ、ファイル) の設定
• Behavior: ウェルカム メッセージ、スターター プロンプト、エージェントの指示

ダイアログでは、エージェントのプレビューがリアルタイムで更新され、その場で変更内容をテストすることもできます。

編集ダイアログの最初のタブ Overview で、こちらの画像ファイル を使ってエージェントのアイコンを更新します。また、Purpose を次のテキストに更新してください。

This is an agent supporting users to find information, policies, and rules based on the HR department knowledge base

Add advanced customization in Copilot Studio ボタンもありますが、これは将来提供される予定の機能で、現時点では利用できません。

次に、ダイアログ ウィンドウの Sources タブを選択し、エージェントのナレッジ ベースを構成します。執筆時点では、構成できるデータ ソースは SharePoint Online のサイト、ドキュメント ライブラリ、ドキュメントのみです。将来的には Microsoft Copilot Studio を使用して追加のナレッジ ソースを構成できるようになる予定です。現時点で SharePoint エージェントがサポートするデータ ソースは SharePoint Online のみです。

Add a SharePoint site 1️⃣ セクションでは、追加のサイト コレクションをエージェントのデータ ソースとして追加できます。タイトルでサイトを検索するか、追加したいサイトの URL を入力します。
既存のサイトを削除する場合は Remove 2️⃣ コマンドを選択します。エージェントを作成した元のサイトを削除すると、最初に構成したすべてのドキュメントが完全に削除されるので注意してください。
最後に、ドキュメント ライブラリ、フォルダー、ファイルを Add document libraries, folders or files 3️⃣ で追加できますが、データ ソース アイテムの合計が 20 個を超えないようにしてください。

Step 2: 指示の更新

構成ダイアログの Behavior タブでは、エージェントの Welcome messaging 1️⃣ を設定できます。
さらに、ユーザーが会話を開始するときに表示される最大 3 つの Starter prompts 2️⃣ を設定できます。

最も重要なのは、Agent instruction 3️⃣ フィールドで、エージェントのトーン、動作、制限、規則などを詳細に設定できる点です。基本的には、ここでエージェントの システムプロンプト を構成します。このフィールドを詳細に記述するほど、エージェントから得られる結果は向上します。
デフォルトでは、あらかじめ設定されている指示は非常に一般的で汎用的です。デフォルト値は次のとおりです。

Provide accurate information about the content in the selected files and reply in a formal tone.

高品質なエージェントを作成するには、エージェントの実際の目的に応じた具体的な指示を提供する必要があります。例えば HR エージェントの場合、以下のような指示を設定できます。

# System Role
You are the HR agent. Your goal is to help employees find information about HR policies, rules, and procedures. You use a set of documents as your knowledge base and you need to stick on those documents when providing answers.

# Main Instructions

## Introduction Prompt
Use the following prompt to welcome the users and introduce your role:
Welcome to HR agent! I'm here to help you work with HR policies, rules, and procedures. Feel free to ask any question about all of what is HR related in our company.

## Responding to the user
Always use a professional but friendly tone. Always list multiple items in tables. Use emojis to make the communication more effective and clear. Always ask the user for a follow up prompt and suggest in scope follow up prompts, too. 

# General rules
Never write personal or sensitive data while generating the answers.
Do not allow the user to ask you questions about other employees' personal and sensitive data.

# Error Handling
In case of any error or issue, inform the user with the following prompt:
I'm sorry, something wrong happened. Please, try again soon.

上記の指示は例示目的であり、完全ではなく、万能なテンプレートを目指すものではありません。指示では MD ドキュメント構造を利用して、テキスト内のさまざまなセクションを強調しています。

指示は最大 8,000 文字まで記述できますので、できる限り詳細に記載することをおすすめします。こちら の Declarative Agent Instruction Lab - Improve your agent instructions (Beginner friendly) ラボでは、エージェント向けのプロフェッショナルなプロンプト指示を書く方法を詳しく学べます。また、Write effective instructions for declarative agents の記事も参照してください。

Step 3: エージェントのテスト

エージェントのアイコン、目的、指示を更新したら Save and close ボタンを選択します。ダイアログを閉じ、再度エージェントと対話します。

例として、次のプロンプトを入力します。

Hello!

How can I improve my career? Provide me a list of suggested actions.

「Hello!」メッセージに対し、エージェントが指示で設定したウェルカム メッセージで応答することが確認できます。また、指示に従い、絵文字を使用したり、リストをテーブルで表示したりと、より正確な回答が得られます。

Exercise 4 : サイトの既定エージェントとしての設定

エージェントでできるもう 1 つの操作は、サイトの既定エージェントとして昇格させることです。現在、すべての SharePoint Online サイトには既定でエージェントが用意されています。スイート バーで Copilot コマンドを選択すると、この既成エージェントが表示されます。

SharePoint Online サイトの既成エージェントを起動すると、右側にサイド パネルが表示され、プロンプトを入力してエージェントと対話できます。エージェントにはあらかじめ定義された動作と汎用的な指示が設定されています。

しかし、既成エージェントではなく独自のカスタム エージェントを使用したい場合もあります。この演習では、その方法を学びます。

Step 1: エージェントの承認と昇格

サイトのホーム ページに移動し、Copilot コマンドを選択してサイド パネルを起動します。

Copilot パネルを開くと、デフォルトで既成エージェントが表示されますが、エージェント名の横にあるドロップダウンを選択すると、作成済みの他のエージェントを選択できます。

次に、カスタム エージェントを既定エージェントに設定する手順を見ていきます。エージェントを作成したドキュメント ライブラリに戻り、エージェントを開きます。エージェント ダイアログの右上にある ... 1️⃣ を選択し、Set as approved 2️⃣ コマンドを選択します。

エージェントを承認するには、サイト所有者である必要があり、明示的な承認/確認も求められます。承認されたエージェントは Site Assets ライブラリ内の Copilots というサブフォルダーに移動されるためです。

承認プロセスが完了すると、確認ダイアログが表示され、.agent ファイルは現在のドキュメント ライブラリから消えます。

これで、エージェントは Approved for this site の一覧に表示されます。

エージェントをアクティブにし、エージェント名の横にある ... 1️⃣ を選択して、コンテキスト メニューから Set as site default 2️⃣ コマンドを選択し、エージェントをサイトの既定エージェントとして構成します。設定を確認すると、昇格プロセスが完了したことを示すダイアログが表示されます。これで、サイトのスイート バーで Copilot アイコンを選択したときに、カスタム エージェントが最初に表示され既定エージェントとなります。

こちらから ラボ MSA2 を開始し、SharePoint エージェントを Microsoft Teams で共有しましょう。