01基礎|Agent Builder を開く場所と、使える条件確認済
Agent Builder は、Microsoft Copilot アプリの中でコードを書かずにエージェントを作る機能。ナビゲーションの Agents の下にある[新しいエージェント]から始める。microsoft365.com/chat、office.com/chat、Teams のデスクトップ版と Web 版で使え、モバイル版では使えない。
- Microsoft Copilot アプリを開く(Web なら microsoft365.com/chat)
- ナビゲーション ウィンドウの Agents(エージェント)の下で[新しいエージェント](New agent)を選ぶ
- Teams では Microsoft 365 Copilot タブを選び、ナビゲーションを展開して Create agent を選ぶ
- Microsoft 365 の言語が「説明して作る」方式に対応していない場合は、[構成](Configure)タブで手で作る
モバイル版のアプリとサイトでは作れない。管理者は Agent Builder を組織で使えるかどうかを設定できるので、[新しいエージェント]が見当たらないときは管理者に確認する。Agent Builder は、Power Platform の既定の環境が対応する国・地域(日本を含む)にある場合に使える。
出典の該当箇所
Agent Builder is available on both the Work and Web options on the Microsoft 365 Copilot app toolbar. It's not available on mobile versions of the apps and sites listed, or for Microsoft 365 Copilot locations that aren't listed in this article.
02基礎|作り方は3通り:説明する・手で構成する・テンプレート確認済
[新しいエージェント]では、作りたいものを自然な言葉で説明して Copilot に組み立てさせる方法(推奨)、[構成]タブで手で設定する方法、テンプレートから始める方法を選べる。説明して作ると、名前・説明・指示・知識源・開始プロンプトが自動で入る。
- [新しいエージェント]を選び、チャット欄に目的・使う人・根拠にする資料を書いて送る
- Agent Builder が出す追加の提案(条件や知識源)を読み、採るものだけを返答する
- [構成]タブを開き、自動で入った名前・説明・指示・知識源・開始プロンプトを読む
- 最初から手で設定するときは[スキップして構成](Skip to configure)を、テンプレートを使うときは Start with a template の一覧から選ぶ
社内の出張・経費精算の規程について、社員の質問に答えるエージェントを作りたい。答えは規程の条番号を添えて 3 行以内にまとめる。規程に書いていないことは『規程に記載がない』と答え、経理の窓口を案内する。知識源は経費精算規程を置いた SharePoint のフォルダにする。
説明して作る方式は、Microsoft 365 の言語設定が対応言語のときだけ使える。自動で作られた指示は下書きとして読み、意図と違う箇所を直す。テンプレートには説明・指示・プロンプトがあらかじめ入っているので、知識源は自分で足す。
出典の該当箇所
Use natural language to describe your agent, and Copilot builds it for you (recommended).
03基礎|名前・説明・指示の役割と上限(30・1,000・8,000 文字)確認済
名前は 30 文字、説明は 1,000 文字、指示は 8,000 文字が上限。説明は、Copilot がどの場面でこのエージェントを使うかを判断する材料になり、アプリのカタログにも表示される。指示は、エージェントの仕事と進め方を決める。3 つがそろうと[試してみる]が使える。
- 名前:用途が分かり、ほかと区別できる名前を 30 文字以内で付ける
- 説明:何をするエージェントかを短く正確に書く(1,000 文字以内)
- 指示:担当する仕事と、その進め方・答え方を書く(8,000 文字以内)
- 3 つを入れたら[試してみる](Try it)で動きを確かめる
説明を 1 文に縮めて。使う場面(出張・経費精算の質問)と、使わない場面(給与や人事の質問)が読んで分かるようにして。
指示が上限を超えそうでも、SharePoint の文書などに指示を置いて上限を回避しない。知識源の中の命令文は、作り手が書いた信頼できる指示として扱われず、実行時に遮られることがある。名前・説明・指示に有害な内容があると判定されると、作成や更新ができない。
出典の該当箇所
The description helps the Large Language Model (LLM) identify and use your agent for a specific task or situation. Make it as short, precise, and simple as possible.
04基礎|知識源の種類と、追加できる数の上限確認済
知識源には、公開 Web サイト(4 件まで)、SharePoint のファイル・フォルダ・サイト(100 件まで)、OneDrive のファイル(50 件まで)、Teams のチャット(5 件まで)、端末からアップロードするファイル(20 件まで)、管理者が有効にした Copilot コネクタを指定できる。
- [構成]の[ナレッジ](Knowledge)で、検索・URL の入力・参照・アップロードのどれかで追加する
- SharePoint はサイトのパスを含み、クエリ パラメーターの無い URL を入れる。OneDrive は共有リンクを入れる
- SharePoint のリストは 1 件だけ指定できる。サイトを指定してもリストは含まれないので、リスト自体の URL を入れる
- 新しく置いたファイルは、横の Preparing(準備中)の表示が消えるまで回答に使われない
Teams のチャットと会議、メール、組織内の人の情報は、Microsoft 365 Copilot のライセンスを持つ利用者だけが使える。SharePoint と OneDrive の知識源も、使う人に有効な Copilot ライセンスが無いと失敗すると記載されている(従量課金の場合の扱いは管理者に確認する)。[構成]の欄の説明には「知識源は最大 20」とも書かれており、数え方は画面で確かめる。
出典の該当箇所
You can add: Up to four public website URLs. Up to 100 SharePoint files, folders, or sites. Up to 50 OneDrive files. Up to five Teams chat URLs.
05基礎|機能と開始プロンプトを決め、[試してみる]で確かめて作成する確認済
機能は、計算・データ分析・グラフを作るコード インタープリターと、画像生成の 2 つで、どちらも既定でオン。開始プロンプトは、代表的な使い方を利用者に示す例文で、名前と説明を付ける。[試してみる]で確かめて[作成]を選ぶ。作成直後は自分だけが使える。
- [構成]の Capabilities で、Create documents, charts, and code(コード インタープリター)と[画像の作成](Create images)のオン・オフを決める
- 開始プロンプト(Starter Prompts)に、よく来る質問を名前と説明を付けて入れる
- [試してみる]で開始プロンプトを押し、答えと引用元を確かめる
- [作成](Create)を選ぶ。できたエージェントは非公開で、共有するまで自分だけが使える
名前:日当と宿泊費の上限を調べる/説明:出張先と日数から、規程の該当条と上限額を示します/プロンプト:来週、大阪へ 2 泊 3 日で出張します。日当と宿泊費の上限を、規程の条番号を付けて教えて。
画像生成は[試してみる]の画面では動かない。[試してみる]では、プロンプトの共有、フィードバック、他のエージェントの @メンションも使えない。コード インタープリターが作ったファイルは、その会話の間だけダウンロードできる。
出典の該当箇所
Starter prompts help other users understand commonly supported scenarios by your agent. Each starter prompt comes with a name and description.
06深掘り1|効く指示は「目的・全体の決まり・手順・出力の形」で組む確認済
指示の骨組みは、目的、全体の決まり(口調・制約)、担当する作業。必要に応じて、手順、例外時の扱い、答えの例、社内用語の定義を足す。順序のある作業は手順ごとに、ねらい・行う操作・次へ進む条件を書き、口調・詳しさ・出力の形を明示する。
- 目的を 1〜2 文で書く(誰の、どんな質問に、何を根拠に答えるか)
- 全体の決まりを書く:口調、答えの長さ、出力の形(箇条書き・表)
- 順序が要る作業だけを番号付きの手順にし、各手順にねらい・操作・次へ進む条件を書く
- 使う知識源や機能を名前で指定する(例:経費精算規程のフォルダを参照する)
- 社内用語・略語の定義と、答えの例を複数入れる
- 最後に、答える前の自己点検を 1 行加える(例:すべての答えに条番号が付いているか確かめる)
# 目的 社員からの出張・経費精算の質問に、経費精算規程だけを根拠に答える。 # 答え方 - 丁寧で簡潔に、3 行以内で答える。 - 根拠の条番号を毎回添える。 # 手順 1. 質問から出張先・日数・費目を読み取る。足りなければ 1 つだけ質問する。 2. 経費精算規程のフォルダから該当条を探す。 3. 上限額と条番号を示す。規程に記載が無ければ「規程に記載がない」と答え、経理の窓口を案内する。 # 用語 - 日当:出張中に定額で支給する手当。 # 最終確認 答える前に、条番号が付いているかを確かめる。
8,000 文字の上限を超えるからといって、指示を SharePoint の文書に置かない。Microsoft 365 Copilot のモデルは定期的に新しいものへ切り替わり、同じ指示でも振る舞いが変わることがある。正確さが要る用途は、切り替えのあとに試し直す。
出典の該当箇所
If you don't specify tone and level of detail, the language model might infer these attributes, which can lead to inconsistent behavior across models.
07深掘り1|知識源は「答えに要る範囲」まで絞る確認済
知識源は広く足すより、答えに要るフォルダ・ファイル・チャットに絞る。Microsoft は、Teams の知識を特定のチャットや会議に絞ると、答えの正確さと関連性が上がると説明している。SharePoint の URL を指定すると、その下の階層も検索の対象になる。
- 答えさせたい質問を先に書き出し、根拠になる文書の置き場所を特定する
- サイト全体ではなく、該当するフォルダやファイルの URL を指定する(その URL の下の階層も対象になる)
- Teams は[My Teams のチャットと会議]ではなく、Chats タブで特定のチャット(5 件まで)を、Meetings タブで特定の会議を選ぶ
- Excel のデータは 1 つのシートにまとめ、ファイルの中身は簡潔に保つ
- 使わなくなったファイルは元の場所で削除や名前の変更をする(エージェントにも反映される)
知識源を、経理部サイトの「経費精算規程」フォルダだけにして。ほかのサイト、メール、Teams のチャットは使わないで。
[My Teams のチャットと会議]を選ぶと、会議の文字起こしと予定表全体が検索の対象になる。メールは範囲を絞れず、メールボックス全体が対象になる。会議の絞り込みは、別の Microsoft Learn のページに Agent Builder では近日提供とも書かれているので、Meetings タブがあるかを画面で確かめる。SharePoint のファイル ピッカーには、アクセスできるコミュニケーション サイトがすべて表示されるとは限らない。
出典の該当箇所
Scoping knowledge to specific chats improves the accuracy and relevancy of agents' responses.
08深掘り1|開始プロンプトを試験の問いにして、[試してみる]で確かめる確認済
開始プロンプトは、利用者への例示であると同時に動作確認の問いにもなる。Microsoft は、開始プロンプトが期待どおり動くか、指示どおりに振る舞うか、開始プロンプト以外の質問も適切に扱えるかを確かめ、エージェントなしの Copilot の答えと比べるよう勧めている。
- 代表的な質問を開始プロンプトに入れる(最低数の決まりは無い)
- [試してみる]で開始プロンプトを 1 つずつ実行し、答えと引用元の文書を確かめる
- 範囲外の質問(例:給与の計算方法)も試し、規程に無いと答えるかを確かめる
- 同じ質問をエージェントなしの Copilot にも聞き、エージェントの答えが上回っているかを比べる
- 直すことは自然な言葉で伝えるか[構成]で直し、[新しいチャット](New chat)で最初から試し直す
来月、福岡へ日帰りで出張します。交通費の精算に必要な書類と提出期限を、規程の条番号を付けて教えて。
[試してみる]は公開後と同じく指示どおりに動くが、画像生成、プロンプトの共有、フィードバック、他のエージェントの @メンションは使えない。新しく置いたファイルは、準備が終わるまで答えに使われない。
出典の該当箇所
Confirm that user prompts outside of the conversation starters are handled appropriately.
09深掘り1|共有は「使うだけ」と「編集もできる」を分けて渡す確認済
共有の権限は 2 段階。[編集可能](Can edit)は所有者で、編集・共有・管理ができ、所有者どうしの権限は同じ。[チャット可能](Can chat)は使うだけ。グループは所有者にできず、チャットのみになる。組織全体への共有はスイッチで切り替える。
- 作成後に[共有](Share)を選び、名前・グループ・メールで相手を追加する
- 保守を担う人だけを[編集可能]にし、担当者の不在に備えて個人を複数、所有者に入れる
- 使うだけの人やグループは[チャット可能]にする
- チャット リンク(使う人向け)と編集リンク(所有者向け)を使い分けて知らせる
- 全社に使わせるときは Org-wide sharing for chat access をオンにする(Agent Store に表示される)
管理者が共有の範囲を制限していることがある。制限がある組織では、全社で使えるようにする前に管理者の承認と展開が要る。配布グループと共有すると失敗することがある。
出典の該当箇所
You can't add a group as an owner. When you add a group, it can only be a chat user (Can chat). To grant owner rights, add individual users.
10深掘り1|共有する前に、相手が知識源を開けるかを確かめる確認済
エージェントは使う人の権限と秘密度ラベルに従い、その人が開けない知識源の内容を答えに使わない。共有時に自動で共有できるのは、エージェントに個別に追加した SharePoint のファイルとフォルダだけで、サイト全体の権限は付かない。アップロードしたファイルの内容は、エージェントを使える全員に届く。
- 共有相手を一覧にし、知識源のフォルダとファイルを開けるかを確かめる
- 共有のときに、自動で共有する SharePoint のフォルダとファイルを選ぶ(自分に共有を変更する権限が要る)
- サイト単位の権限は、サイトの管理者に付与を頼む
- メールを知識源にしたエージェントでは、共有相手には自分のメールが使われない前提で作る
- アップロードしたファイルに、利用者全員に見せてよい内容だけが入っているかを確かめる
SharePoint のファイルとフォルダの自動共有は、特定のセキュリティ グループとの共有でだけ働き、組織の全員と共有するときは働かない。その場合はファイルとフォルダの権限を手で更新する。ファイルの共有に失敗しても、エージェント自体は共有される。その場合、ファイルを開けない人にはそのファイルに基づく答えが出ない。利用者の Copilot ライセンスの種類がエージェントの機能に合わないと、使うときにエラーになることがある。
出典の該当箇所
Only the files and folders you specifically add to the agent can be shared automatically. Full access to SharePoint sites isn't automatically available to people you share your agent with.
11深掘り2|知識の絞り込みの限界:一般知識は止めきれない確認済
Only use specified sources をオンにすると指定した知識源を優先するが、モデルの一般知識は完全には止められない。メールは範囲を絞れない。アップロードしたファイルには情報バリアが効かない。SharePoint のリストは 20,000 行または 50 MB を超えると切り詰められる。
- [構成]で Only use specified sources をオンにし、見つからないときに見つからないと答えるかを試す
- 一般知識で答えてほしくない質問を試験の問いに入れ、答えの出どころを確かめる
- 制限付き SharePoint 検索(Restricted SharePoint Search)が有効な組織では、SharePoint を知識源にできないことを確かめる
- 一般知識をもっと厳しく遮る必要があるなら、Copilot Studio での作成を検討する
管理者が Web 検索を無効にしていても、[ナレッジ]の Web content のスイッチは消えないが、Web は使われない。Search all websites をオンにすると、Web 上のどの情報も答えに入り得る。Agent Builder で作ったエージェントは Teams のチャットでは使えず、顧客管理キー(Customer Managed Keys)にも対応していない。
出典の該当箇所
This setting prioritizes rather than fully blocks general AI knowledge—Agent Builder can't fully block it—so for stricter control, see the note that follows.
12深掘り2|答えは決まった問いの組で評価し、Monitor で使われ方を追う確認済
評価用の問いの組(開始プロンプト、範囲外の質問、知識源に答えが無い質問)を決め、指示や知識源を変えるたびに同じ組で試す。公開後は Monitor タブで、利用の状況、知識源ごとの使われ方、利用者の評価とコメントを確かめる。
- 問いの組を 3 種類そろえる:開始プロンプト、範囲外の質問、知識源に答えが無い質問
- 問いごとに、期待する答えと根拠の文書を書き留めておく
- 変更のたびに同じ組で試し、エージェントなしの Copilot の答えとも比べる
- Monitor タブで期間(Last 7 days など)を選び、Total sessions と Knowledge のグラフで、想定した知識源が使われているかを見る
- 低い評価のコメントを読み、答えの形への不満なら指示を、根拠の不足なら知識源を直す
Monitor タブを見られるのは所有者(編集可能)だけ。評価とコメントは、組織の管理者がエージェントのフィードバック共有を有効にしていないと表示されない。モデルが切り替わると振る舞いが変わるので、評価は定期的にやり直す。
出典の該当箇所
The Knowledge chart shows trends in the knowledge sources used by the agent. Each source appears separately in the chart legend so you can compare its use over time. Use this information to assess whether the agent is using the knowledge sources you expect.
13深掘り2|更新は[Update]で出すまで届かない。変更の記録と持ち主を決める確認済
変更は自動で保存されるが、[Update]を選ぶまで利用者には見えず、反映に数分かかることがある。組織カタログの版は共有している版と別に管理され、再提出して管理者が承認するまで変わらない。版の管理や以前の版への戻しは、Copilot Studio に移すと使える機能として説明されている。
- 変更の前に、今の指示・知識源・開始プロンプトを文書に控え、変更の日付と理由を書き添える
- 所有者が編集し、[試してみる]で評価用の問いの組を試す
- [Update]を選んで公開する。利用者に届くまで数分かかることがある
- SharePoint のファイル・フォルダを知識源にした共有エージェントは、更新後に同じ相手へ共有し直す
- 組織カタログに載せている場合は、再提出して管理者の承認を受ける
削除は元に戻せず、ほかの所有者や共有相手も使えなくなる。作成者が組織を離れるとエージェントは所有者不在になるので、個人の所有者を複数入れておく。管理者側の所有者の付け替え・ブロック・削除の手順は「AI エージェントの運用」のページにある。
出典の該当箇所
Changes made to agents are saved automatically. However, your changes aren't visible to users until you make them available.
14深掘り2|管理者の設定が作り手に効くところを知る確認済
Microsoft 365 管理センターでは、Agent Builder を使えるか、エージェントを共有できる人(全員・特定の人・なし)、エージェントを使える人、評価を作り手に渡すかを設定する。共有の制御は Agent Builder のエージェントにだけ効く。組織カタログへの掲載は管理者の審査を経る。
- 組織の共有の設定(All users/Specific users/No users)を管理者に確かめる
- 全社に広げたいときは、共有ではなく組織カタログへの提出(Submit to your org catalog)を使う
- 提出の前に、短い説明(80 文字まで)、作成者のサイト、プライバシーに関する声明、利用規約の URL を用意する
- 個人の Teams の会議・チャット・メールを知識源に使うなら、短い説明にそのことを書く
- 監査ログ・活動レポート・DLP・保持ポリシーが通常どおり適用される前提で、扱う文書を選ぶ
管理者が共有の設定を変えても、既存の共有は自動では取り消されない。新しい方針に合わない共有設定のままだと、エージェントを更新できなくなる(Can no longer update agent)。
出典の該当箇所
Sharing control only applies to agents built with Microsoft Copilot Agent Builder.
15深掘り2|うまく動かないときは、症状から原因を切り分ける確認済
症状と原因の組み合わせを押さえる。「Sorry, I wasn't able to respond.」は利用者に Copilot ライセンスが無いとき、Couldn't share はファイルの共有権限の不足、Can no longer update agent は管理者の共有方針との不一致で起きる。解決しないときは、エージェント ID などを添えて問い合わせる。
- 知識源に基づく答えが出ない:ファイルが Preparing のままでないか、利用者がそのファイルを開けるか、ファイル名に null 文字が無いかを確かめる
- Couldn't share:一覧に出たファイルの共有権限を SharePoint で直す
- Can no longer update agent:共有設定を方針に合う選択肢に変えてから更新する
- サポートされない秘密度ラベルのエラー:アップロードしたファイルの盾のアイコンを見て、赤いエラーのファイルを外す
- 問い合わせ:Help の Get support からエージェント ID・テナント ID・環境 ID・セッション ID を控え、説明タブの問題なら /debug の出力も添える
パスワード保護、二重キー暗号化、ユーザー定義の権限を持つラベルのファイルは、アップロードしても知識源にならないか、作成が失敗する。エラーの表示が出ない場合もある。
出典の該当箇所
This error occurs when your agent's current sharing settings are no longer compliant with new admin policies.
16深掘り2|Copilot Studio に移る判断と、コピーで引き継がれないもの確認済
部門全体・全社・社外に向けるとき、複数手順のワークフローや独自の連携が要るとき、展開と管理を細かく制御したいときは Copilot Studio を選ぶ。Copy to Copilot Studio でコピーすると、名前・説明・指示・開始プロンプト・SharePoint と Web の知識源は引き継がれる。
- 移る理由を確かめる:対象者の広さ、ワークフロー、外部との連携、版の管理とロールバック
- Agent Builder の More options メニューから Copy to Copilot Studio を選び、保存先の環境を選ぶ
- 引き継がれない設定を入れ直す:Copilot コネクタ、アップロードしたファイル、Teams とメールの知識源、コード インタープリター
- Copilot Studio で試してから公開し、元のエージェントを消すかを決めて、共有相手に移行を知らせる
画像生成と、絞り込みを設定した Copilot コネクタは、Copilot Studio では使えない。コピーには Copilot Studio か Microsoft 365 Copilot のライセンスと、Dataverse の利用権が要る。コピーの後に元のエージェントを直しても、コピーには反映されない。
出典の該当箇所
Choose Copilot Studio if you need an agent for a broader audience (such as your whole department, organization, or external customers) or if the agent requires advanced capabilities like multi-step workflows or custom integrations, or you need more control over deployment and management.