カスタム エージェントにツールを追加する

Note

本記事では 、標準ハーネスで駆動されるエージェントやエージェントフローで使用される機能について説明します。

ツールはエージェントが外部システムとやり取りするための構成要素です。 ツールはエージェントの行動範囲を拡張し、エージェントはユーザーの要求や自律的なトリガーに応じて様々なアクションを実行できます。 各ツールは、エージェントが実行できる特定の機能を表します。 例えば、エージェントに以下のようなタスクを実行するツールを装備させることができます:

  • Office 365 Outlookコネクターを使ってメールを送信します
  • 現在の気象条件と予報を確認する
  • Dataverse からのデータの読み取りと書き込み
  • Teams へのメッセージの読み取りと投稿

エージェント内のツールやプラグインの機能?

Copilot Studio に追加したツールは、あなたのエージェントのものです。 エージェントがいつ使うか決め、Copilot Studioで管理します。 Microsoft 365 Copilot プラグインは異なります。スキルや MCP サーバー、エージェントなどのツールをパッケージ化し、サポートされた Copilot エクスペリエンスの中で人々がそれらを一緒に見つけ、インストール、管理できるようにします。

質問と事例 エージェントのツール Microsoft 365 Copilotプラグイン
いつ使用しますか? あなたは一つのエージェント体験を設計しており、ツールはその中でしか意味をなさないのです。 ユーザーには、普段利用している Copilot エクスペリエンス内でその機能を直接使用してもらいたいです。
ツールがいつ動くかは誰が決めるのか? エージェントのオーケストレーション、トピック、設定。 各サポート対象エクスペリエンスにおけるCopilot
人々はそれをどこで使いますか? エージェントを公開するチャネル(Teamsなど)。 サポートされている Copilot エクスペリエンス。 各エクスペリエンスは、サポートしているプラグインの部分を使用します。
誰が管理しているのですか? Copilot Studio の Makers。 Power Platformのデータ ポリシーは、maker が追加できるツールを制御します。 Microsoft 365 管理センター の管理者
Example ContosoのITヘルプデスクエージェントは、Teamsでチケットを作成しパスワードをリセットします。 Contosoのカスタマーアカウントプラグインは、顧客ブリーフを作成するスキルと、会社のCRM内のアカウントを検索するMCPサーバーをパッケージ化しています。 セラーズはCopilotに「Fabrikamのためのブリーフを作成」と依頼します。

例:エージェント内のツール(Contoso ITヘルプデスクエージェント)

Contoso ITはCopilot Studioでエージェントを構築し、Teamsに公開します。 エージェントは ServiceNow コネクターを使ってチケットを検索・作成し、マネージャーの承認後にパスワードをリセットするエージェントフロー、そしてチケット履歴を要約するプロンプトを使用します。 エージェントのトピックとオーケストレーションによって各ツールの実行タイミングが決定され、パスワードリセットではユーザーに先に確認を求めます。 ITチームはCopilot Studio内のエージェントを管理し、Power Platformのデータ ポリシーが作成者が使用できるコネクタを制御します。 エージェントのツールは、Contosoが最初から最後まで設計したヘルプデスクの会話の中でしか意味をなさないため、ここに当てはまる。

例:プラグイン(Contosoのカスタマーアカウントプラグイン)

Contoso Sales は、チームのテンプレートから顧客ブリーフを作成するスキル、Contoso の CRM でアカウントを検索する MCP サーバー、そしてオプションでアカウントレビュー用の宣言型エージェントを含むプラグインをパッケージングしています。 Contosoはこのプラグインを組織に公開し、管理者はMicrosoft 365 管理センターで営業チームに提供します。 サポートされているエクスペリエンスでセラーはCopilotに「Fabrikam用のブリーフを作成する」よう依頼できます。CopilotはスキルとCRMツールを使用しており、セラーは別のエージェントを開きません。 初めては、彼らはCRMアカウントを接続します。 プラグインがここに適しているのは、この機能は販売者がすでに使っているCopilotエクスペリエンスに組み込まれており、管理者が一か所で管理できるからです。

プラグインについて詳しくは、「 プラグイン」を参照してください。

エージェントにツールを追加する仕組み

Note

ツールの追加 ペインにあるはずのツールが表示されない場合は、組織のポリシーによって利用できるツールが制限されている可能性があります。 ヘルプが必要な場合は、管理者にお問い合わせください。

エージェントはツールを2つの方法で使えます:

  • 生成オーケストレーション(自動):生成オーケストレーションはデフォルトでオンになっています。 エージェントは、依頼ごとに最適なツール、トピック、または知識源を選びます。

    例:ユーザーが「My laptop does not connect to VPN」と入力すると、エージェントが ServiceNow ツールを選択してチケットを開きます。

  • トピックから(明示的に):トピック内のノードからツールを呼び出します。 生成オーケストレーション(クラシックモード)をオフにすると、エージェントはトピックを通じてのみ応答しますが、トピックは引き続きツールを呼び出すことができます。

以下の種類のツールを追加できます:

ツールの種類 それが何をするか
事前構築済みコネクタ Power Platformコネクタを介して、数千のMicrosoft サービスおよびMicrosoft以外のサービスのいずれかに接続します。
カスタム コネクタ 定義したPower Platformコネクタを介して、独自のサービスに接続します。 エージェントがそれを使用するには、コネクタが組織全体で表示可能で共有されている必要があります。
エージェント フロー 1つ以上のアクションで構成されるフローを実行します。
Prompt 1ターンモデルプロンプトを実行します。 あなたが提供した知識を活用し、データを分析するためのコードを生成できます。
REST API REST API から選択したエンドポイントとメソッドを呼び出します。
モデル コンテキスト プロトコル (MCP) MCPサーバーに接続し、そのツールやリソースを使用します。
コンピューターの使用 ウェブサイトやデスクトップアプリをユーザーインターフェースを通じて操作し、ボタンの選択、メニューの選択、テキスト入力を行います。

エージェントにツールのような動作を与える他の2つのオプションがあります:

Azure Bot Serviceスキルを使うと、Azure Bot Serviceボットの関連ツールセットがエージェントに利用可能になります。 クライアントツールはイベントアクティビティをクライアントアプリに送信し、クライアントアプリはアクションを実行して応答を返します。

Note

標準ハーネスを利用するエージェントのスキルはAzure Bot Serviceスキルです。 これらは、GitHub Copilot ハーネスでサポートされるエージェントに追加できるエージェント スキルとは異なります。

エージェント レベルで新しいツールを作成して追加する

エージェントにツールを追加すると、エージェントはそのツールをあらゆる会話で自動的に使用できます。

  1. Copilot Studioで「エージェント」を選択し、次に自分のエージェントを選択します。

  2. エージェントの ツール ページにアクセスします。

  3. [ ツールの追加] を選択します。

  4. ツールの種類を選択します。 REST API やカスタムコネクタを含むすべてのタイプを表示するには、「すべてを見る」を選択します。

    Note

    組織が特定の種類のツールをブロックしている場合、その種類のツールを選択することはできません。 詳細については、「 組織のポリシーによってブロックされたツール」を参照してください。

  5. ツールを設定します。 手順は種類によって異なります。 例えば、プロンプトツールの場合、プロンプトの指示を書き、モデルを選択し、 +コンテンツを追加して入力パラメータを追加します。 プロンプトアシスタントからサポートを受けるか、プロンプトテンプレートから始めることができます。

  6. [ 保存]を選択し、[ 追加および構成]を選択します。

    ツールの設定ページが開き、ツールはエージェントの ツール ページに表示されます。

    エージェントに追加する新しいツールの種類の選択画面のスクリーンショット。

    Note

    もし組織がデータポリシーのためにツールをブロックした場合、そのツールを選択することはできません。 組織 のポリシーによってブロックされたツールについて詳しくはこちらをご覧ください。

  7. 選択したツールの種類に固有の構成手順を実行します。 例えば、 プロンプトを選択した場合、以下の手順を実行します。

    • プロンプト命令を定義します
    • モデルを選択する
    • 入力パラメータを指定する( +Add contentを選択して)

    また、「 プロンプトアシスタン ト」欄に入力することでも助けを得ることができます。

    別の方法として、あらかじめ定義されたテンプレートを使用するには、prompt template を選択してプロンプトを作成します。

  8. [保存] を選択して新しいツールを作成します。

  9. [追加と構成] を選択します。 ツールがあなたのエージェントに追加されました。 ツールの構成ページが表示されます。 こちらでツール設定を確認し、変更できます。

新しいツールはエージェントの ツール ページに表示されます。

組織のポリシーによってブロックされているツール

管理者はガバナンスポリシーを使用して、Copilot Studio で利用可能なツールやコネクタを制限できます。 データポリシーがツールをブロックすると、「 ツールの追加 」ペインでそのツールは利用できない状態に見えます。 どのポリシーがそれをブロックしているかを確認するには、ツールの横にある情報アイコンを選択します。 アクセスが制限されているツールが必要な場合は、管理者に問い合わせてください。

管理者は、Microsoft 365 管理センター でプラグイン(スキルや MCP サーバーを含む)を管理します。 Power Platform のデータポリシーは、メーカーが Copilot Studio に追加できるツールを引き続き制御しています。

詳細については、 エージェントのデータ ポリシーの構成に関するページを参照してください。

ツール構成の表示と変更

ツールの設定を表示または変更するには、エージェントの ツール ページにアクセスし、ツールを選択してください。 設定ページには「詳細」「入力」「コンプリーション」の3つのセクションがあります。

MCPサーバーには異なる設定ページがあります。 入力と完了の代わりに、MCPサーバーが提供するものを一覧表示するツールセクションとリソースセクションがあります。 詳細については、「 エージェントを既存のMCPサーバーに接続する」を参照してください。

Details

Setting 知っておくべきこと
Name エージェントのツール一覧に表示されます。 ツールが何をするのかを示す名前を使いましょう。
Description 生成オーケストレーションは、説明を用いてツールをいつ使用するかを決定します。 ツールが何をするのか、いつ使うのかを説明してください。
エージェントがツールを使用するタイミングを動的に決定できるようにする 選択すると、エージェントはこのツールを自動的に選択できます。 選択解除されている場合、エージェントはトピックでそのツールが必要な場合にのみツールを使用します。 生成オーケストレーションがオンのときにデフォルトで選択されます。
実行前にエンドユーザーに確認してください ツールを実行する前にユーザーに確認を求める。 デフォルトでは「いいえ」に設定されています。
Authentication ユーザーの認証情報(エンドユーザー、デフォルト)またはメーカーの認証情報(メーカー提供)でツールを実行します。
認証の説明 Optional. ユーザーに、何にサインインを求められているかを伝えます。

例:Contoso ITはパスワードリセットの流れを「マネージャーの承認後にユーザーのパスワードをリセットします」と説明しています。 ユーザーがロックされたりパスワードのリセットを求めたときに使用してください。」また、「実行前にエンドユーザーに尋ねる」 も 「はい」 に設定します。

入力

入力とは、ツールに必要な値のことです。 各入力はテーブル内の行として表示されます。

デフォルトでは、入力方法 は AI で動的に入力に設定されています。 エージェントは会話の各値、例えばユーザーのメッセージを探し出そうとします。 値が見つからない場合はユーザーに尋ねます。

入力の収集方法を制御するには、[ カスタマイズ]を選択します。 次を設定できます:

  • 表示名 と 説明:入力がユーザーにどのように表示されるか。
  • 次のものとして識別: ユーザーの回答を、たとえばテキストやあらかじめ定義されたエンティティとして解釈する方法。
  • 再試行ロジック: エージェントが答えを認識しなかった場合にもう一度聞くべきかどうか。
  • 入力検証: エンティティ タイプの既定のチェックを超える追加のチェックを行います。

ユーザーへの確認をスキップするには「Fill using」を「カスタム値」に設定し、その後、値を入力するか、変数を選択するか、Power Fx の数式を記述します。

Note

コネクタ操作をリフレッシュした後、必要な入力をすべて入力するまで出力タイプが未解決のままになることがあります。 値を入力し、トピックを保存してから、再度出力変数を確認してください。

Completion

ツール実行後に何が起こるかを選択します。 実行後で、以下のいずれかのオプションを選択してください。

  • 応答しない (デフォルト):エージェントはツールの出力を自身のレスポンスに含めます。
  • 生成AIで応答を書く: AIはツールの出力に基づいて応答を書きます。
  • 特定の応答を送信:応答テンプレートを作成し、出力変数を挿入します。 Power Fxでフォーマットできます。
  • アダプティブカードを送信:ボタンやアクションを含むインタラクティブなカードを送信します。

また、エージェントやその他のツールで使用できる出力変数を選択できます。

ツールの選択と入力コレクション

エージェントは以下に基づいてツールを使用するかどうかを判断します:

  • ツール名と説明。
  • これまでの会話。
  • ユーザーが求めているもの。
  • ツールが持つ入力と出力。
  • 会話の中ですでに使ったツール。

Note

レスポンスがリンクやカード内容などのツール出力を正確に再現する必要がある場合は、「変数挿入付き 特定レスポンスを送信 」または 「アダプティブカードを送る」を使用してください。 ツールがすでにユーザーに見えるメッセージを送信したときのみ「 応答しない 」を使用してください。 生成AIで回答を書くと、ツールの出力を言い換えることもできますが、リンクやカードの内容を正確に保持できない場合があります。

エージェントや他のツールに利用可能な出力変数を設定しましょう。

エージェントはツールの説明文を使って欠けている入力を収集する質問を書くため、それぞれに質問ノードを追加する必要はありません。

デフォルトでは、ツールは結果をエージェントに返し、エージェントが応答を書きます。 代わりにツールがユーザーに直接応答するようにすることもできます。

Tip

エージェントがAI生成の質問をするときは、会話の一部がAIが書いたことをユーザーに伝えましょう。 たとえば、会話開始 システム トピックにメッセージを追加します。

トピック内から既存のツールを呼び出す

会話の特定のポイントでツールを実行したいときにトピックを使用してください。

  1. Copilot Studioで、エージェントのトピックページにアクセスします。

  2. トピックを作成し、名前を付けます。例えば「 チケットを作成」などです。

  3. 「チケットを開く」「問題を報告する」「ITヘルプが必要です」などのトリガーフレーズを追加してください。

  4. [ ノードの追加 ](+)を選択し、[ ツールの追加 ]を選択します。

  5. ツールを選択します。 ツールは「基本ツール」、「コネクタ」、「ツール」タブにグループ化されています。

  6. 保存 を選択します。

MCP コネクタ情報

MCPコネクタについては、MCPコネクタが提供するツールやリソースの名前や説明を確認できます。 ツールやリソースの情報は表に表示され、各ツールごとに1行ずつ表示されます。

ツールの認証に関する考慮事項

プロンプトやDataverseを呼び出すツールなど、一部のツールには認証が必要です。 エージェントはユーザーのコンテキストでツールを実行しますが、ツールは認証がオンになっていないと実行されません。 以下のいずれかの方法を選択してください:

  • エンドユーザーの認証情報: ユーザーは自分が閲覧を許可されたデータのみを閲覧できる。
  • メイカー提供の認証情報:ツールはあなたの認証情報を使用します。 共有リソースや、ユーザーごとのアクセス権が不要な場合にこの方法を使用してください。

ツールをテストする

生成オーケストレーションを利用することで、エージェントはツールがリクエストに合うと判断したときにそのツールを使用します。 テストするには、ツールが対応すべき質問をしてください。 次の例では、Contoso IT が「アカウントからロックアウトされました」と入力し、エージェントが確認を求めているか確認してからパスワードリセットのフローを実行します。 また、トピックからツールを呼び出してツールをテストすることもできます。

エージェントでツールをオンまたはオフにする

新しいツールはデフォルトでオンになっています。 ツールをオフにするとエージェントはそのツールの使用を停止しますが、接続は維持され、後で再度オンにできます。

  1. エージェントの ツール ページにアクセスし、ツールを選択してください。

  2. 構成ページの上部で、[有効] トグルを使用します。

  3. 保存 を選択します。

エージェントからツールを削除する

  1. エージェントの ツール ページにアクセスしてください。

  2. ツールにマウス ポインターを合わせ、3つのドット (...) を選択します。

  3. 削除 を選択し、確認のためにもう一度 削除 を選択します。

Tip

ツールはエージェントのツールページからのみ削除でき、メインの Copilot Studio ツールページからは削除できません。

エージェントにおけるツールの制限

  • 生成オーケストレーションを用いることで、エージェントは最大128種類のツールを持つことができます。 最良の結果を得るには、25〜30を使いましょう。
  • マルチエージェントオーケストレーションでは、各子エージェントがそれぞれ128種類のツールを持つことができます。