REST API からツールを使用してエージェントを拡張する (プレビュー)

[この記事はプレリリースドキュメントであり、変更されることがあります。]

REST API ( OpenAI API を含む) を使用して、作成したエージェントを外部システムに接続し、エージェント内で使用できるデータにアクセスできます。 Copilot Studio に次の 3 つの機能を提供することで、エージェントを REST API に接続できます。

OpenAPI 仕様で API の機能と使用可能なアクションを定義します
必要な認証の種類の詳細と、ユーザーが API に接続して外部システムにアクセスするための認証の詳細
データを利用するために API を呼び出すタイミングを言語モデルが判断する際に役立つ説明

REST API は、Copilot Studio を使用して、Copilot エージェントとカスタムエージェントに追加できます。

Von Bedeutung

この記事にはプレビュードキュメントMicrosoft Copilot Studio含まれており、変更される可能性があります。

プレビュー機能は運用環境向けではなく、機能が制限されている可能性があります。これらの機能は公式リリースの前に利用できるため、早期にアクセスしてフィードバックを提供できます。

運用対応エージェントを構築する場合は、「Microsoft Copilot Studio 概要を参照してください。

Copilot エージェントを使用すると、コネクタ、API、プロンプト、ナレッジソースなどの複数のデータソースを 1 つのエージェントに結合できます。このエージェントを使用して、Microsoft 365 Copilotなどの Microsoft ブランドのエージェントエクスペリエンスを拡張できます。

カスタムエージェントは、コネクタ、API、プロンプト、ナレッジソースを含むスタンドアロンのエージェントです。カスタムエージェントを Web サイトやその他のチャネルに統合することで、カスタムエージェントを直接使用できます。

注意

REST API ツールは、OpenAPI v2 仕様から作成する必要があります。これは、API 仕様を処理する Power Platform の動向によるものです。 v3 仕様が送信された場合、作成プロセス中に自動的に v2 仕様に変換されます。

前提条件

作成者レベルの資格情報と、Copilot Studio ライセンス。
接続したいREST APIのOpenAPI仕様のコピーです
APIに接続するために必要な認証の種類や認証の詳細に関する知識。

エージェントにREST APIツールを追加しましょう

エージェントにREST APIツールを追加するには、いくつかのステップがあります:

新しいエージェントツールを追加し、REST APIを選択します
API仕様、説明、ソリューションを提供します
認証情報の提供
APIからツールを選択します
レビューと公開

以下のセクションでは、手順を一歩ずつご紹介します。

REST API を追加するプロセスは、カスタムエージェントと Microsoft 365 Copilot のエージェントの両方で同じです。

新しいエージェントツールを追加し、REST APIを選択します

エージェントの概要ページにアクセスしてください。
[ ツール ] セクションで、[ ツールの追加] を選択します。 [ ツール ] タブに移動し、[ツールの追加] を選択することもできます。

[ ツールの追加] ページが表示されます。
[新しいツール>REST API] を選択します。

API仕様、説明、ソリューションを提供します

接続する REST API の OpenAPI 仕様ファイルをアップロードします。仕様ファイルを REST APIのアップロードする 画面にドラッグアンドドロップするか、システムを参照して使用するファイルを見つけることができます。

注意

OpenAPI の仕様は、v2 形式の JSONファイルである必要があります。 v3 仕様が送信された場合、作成プロセス中に自動的に v2 仕様に変換されます。

仕様をアップロードすると、画面が更新され、仕様ファイル名と詳細が表示されます。

次の手順では、ADO チケット管理システムである SunnyADO の具体例で手順を説明します。この例では、ユーザーがエージェントを介してチケットを取得および更新できるようにすることを目的としています。
詳細を確認し、次へを選択します。

API に関する追加情報を入力できる API プラグインの詳細 ページが表示されます。

説明フィールドは、アップロードした API 仕様の説明に基づいて最初に入力されます。詳細な説明を提供します。エージェントオーケストレーションがその説明を用いて、特定のツールを使用するタイミングを決定するためです。同義語を含む詳細を提供して、エージェントの選択プロセスに役立ててください。

たとえば、最初に提供される説明は、「チケットを管理する簡単なサービス」です。

より適切な説明は、「SunnyADO から既存のチケットを取得、検索、表示するためのシステム」です。これにより、ユーザーはチケットを更新、変更、管理して、より多くのデータを提供してレコードを改善できます。
説明フィールドに改善された説明を入力します。
ソリューション配下のドロップダウンには、現在の環境内で利用可能なすべてのソリューションが一覧表示されます。使用するソリューションを選択します。ソリューションの詳細については、ソリューションの概念を参照してください。

優先するソリューションがある場合、または選択したコネクタがすでにソリューションに含まれている場合は、そのソリューションが自動的に選択されます。

ソリューションを選択するか、空白のままにしておくことができます。ソリューションを空白のままにすると、アクション名と既定の発行元を使用してソリューションが作成されます。アクションをソリューションに保存すると、環境間の移動が簡単になります。

注意

この場合、既定のソリューションまたは CDS の既定のソリューションがオプションとして表示されない場合は、管理を容易にするためにカスタムソリューションを用意することをお勧めします。詳細情報は、既定のソリューションとカスタムソリューションを参照してください。
ソリューションを選択した状態で、次へを選択して続行します。

認証情報の提供

認証ページが表示され、API に使用する認証のタイプを選択できます。

認証方法を選択します。

一覧から認証方法を選択します。 3 種類のオプションがあります。
- なし:APIにアクセスするために認証は不要です。
- APIキー:認証にAPIキーが必要な場合はこのオプションを選択してください。実行時にエージェントがAPIツールを使用したいとすると、ユーザーに認証を促します。ユーザーがAPIキーを提供し、エージェントはそのキーを使ってAPIに接続します。
- 認証2.0:MCPサーバーが認証にOAuth 2.0を使用している場合は、このオプションを選択してください。 OAuth 2.0は、個々のユーザーがアイデンティティプロバイダーを通じてAPIに認証できるようにします。これにより、ユーザーはエージェントに認証情報を共有することなく、アプリケーション(エージェント)に権限を付与できます。
選択した認証方法に必要な項目を入力してください。フィールドは、認証方法によって異なります。
- なし:提供できる情報はありません。
- API キー:
  - パラメータラベル:APIパラメータをユーザーに提示するためのテキストラベルです。
  - パラメータ名:APIキーパラメータの実際の名称で、ヘッダーまたはクエリ文字列のいずれかで使用されます。
  - パラメータの位置:APIのキーをどのように送信するか。 ヘッダーかクエリのいずれかを選択します。
- 認証 2.0:
  - クライアント ID: アプリを登録するときに ID プロバイダーが発行するクライアント識別子。クライアント ID を使用すると、ID プロバイダーは、要求を行っているアプリを認識できます。
  - クライアントシークレット: アプリを登録するときに ID プロバイダーが発行するクライアントシークレット。エージェントはクライアントシークレットをクライアント ID と共に送信して、エージェントが MCP サーバーのアクセストークンを要求する権限があることを証明します。
  - 承認 URL: エージェントがユーザーをリダイレクトしてサインインし、アクセス許可をエージェントに付与する ID プロバイダーエンドポイント (エージェントチャットに表示される同意カード)。ユーザーはここで認証を行い、ID プロバイダーは コールバック URL で 認証コードを使用してエージェントに応答します。
  - トークンURL:エージェントが認証コード(またはリフレッシュトークン)を アクセストークン と リフレッシュトークンに交換するエンドポイントです。アクセストークンを使用すると、エージェントはユーザーの代わりに MCP サーバーを使用できます。更新トークンを使用すると、以前のアクセストークンの有効期限が切れたときに、エージェントは更新エンドポイントから新しいアクセストークンと更新トークンを取得できます。
  - 更新 URL: 更新トークンを使用して新しいアクセストークンを要求するエンドポイント (トークンの有効期限が切れたときにユーザーが再びサインインする必要がないようにするため)。
  - スコープ:(任意):アプリが求めている権限を、スペースで区切ったリストとして表示します。
  - どの組織Microsoft 365エンドポイントにアクセスするか: これにより、ソースへのアクセスは、作成者の組織またはすべての組織のいずれかに制限されます。次のいずれかを選択します。
    - 私の組織だけ
    - 任意の Microsoft 365 組織
  - どのアプリ(クライアント)がエンドポイントを使えるか:GUIDはこのデータにアクセスするために使えるクライアントシステムを定義しています。アプリには、Microsoft 365、Power Automate、その他のオプションが含まれる場合があります。
すべてのフィールドに入力したら、次へを選択します。

APIから有効化するツールを選択する「 ツールを設定して設定」 ページが表示されます。

APIからツールを選択します

REST APIからAPI対応のツールを選択してエージェントに追加してください。一般的に、REST APIはAPI仕様で定義されたエンドポイントとHTTPメソッドの組み合わせ(get、put、post、deleteなど)を通じて多様なツールを提供します。場合によっては、エージェントのユーザーが API で一般的に提供される すべてのアクション 実行できないようにしたいことがあります。例えば、API仕様に更新・削除機能が含まれている場合、エージェントのユーザーだけがレコードを作成できるようにしたい場合です。

構成するツールを一覧から選択します。

ツール の設定 ページが表示されます。
選択したツールの名前と説明を設定してください。 API全体と同様に、 ツール名 と ツール説明の提供を求められます。説明は、最初は API 仕様の説明から事前入力されています。名前は一意である必要はありませんが、ツール自体を表す必要があります。説明文も全体のAPI説明と同様に、言語モデルがクエリがこの特定のツールに適合しているかどうかをよりよく識別できるよう、詳細を提供できるべきです。
フィールドに入力したら、次へを選択します。

[ツールのパラメーターの確認] ページが表示されます。

このページは入力値と返される出力値の期待値を示しています。これらの値は変更できませんが、入力と出力の記述は更新できます。このページのすべてのコンテンツは、アップロードされた API の仕様から直接取得されます。
必要に応じて説明を更新してください。説明は、値の使用目的を定義します。説明のいずれかが空白の場合は、先に進む前に完了する必要があります。適切な説明がない場合は、名前を貼り付けることができます。
説明が完了したら、次へを選択します。

1 つ目のツールが構成され、[プラグインツールの選択と構成] ページの [選択したツール] の一覧に表示されます。
今取り入れたいAPIの他のツールも追加してください。エージェントでサポートするツールの追加が完了したら、[ 次へ] を選択します。

[ ツールの確認] ページが表示されます。このページには、構成された REST API ツールの詳細が表示されます。

レビューおよび公開

更新を行う必要がある場合は、戻るを選択し、変更を加えることができます。その以外の場合は、 [次へ] を選択します。

プロセスの完了中にツールが公開されていることを示す画面が表示されます。公開が完了すると、通知されます。
接続を作成 を選択して続けてください。ツール の追加 画面に戻されます。
ツールタイプセレクターで REST API を選択します。 APIから新たに作成されたツールを見ることができます。 APIから追加したツールごとに1つのエントリがあるはずです。
APIから新たに設定した各ツールについては、APIへの接続を作成または選択し、ツールをエージェントに追加する必要があります:
1. ツールを追加画面でツールを選択してください。
2. 接続の中で既存の接続を選択するか、 新しい接続を作成するを選択します。
3. 接続に必要な情報を入力し、ツールへの接続を作成するために 「作成 」を選択してください。
4. ツールをエージェントに追加するには「Add and configure」を選択してください。

REST APIのツールが現在、あなたのエージェントで利用可能になりました。

チップ

ツールをより簡単に見つけるには、検索バーを使用して検索します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-02-10