エージェント SDK (プレビュー)
Bot Framework/Microsoft Agents SDK アクティビティ ペイロードをユーザー指定のエージェント エンドポイントに転送します。 エージェント エンドポイント URL は、入力パラメーターとして呼び出しごとに指定されます。 接続の作成時に認証が選択されます。認証なし、静的 API キー、または OAuth (client_credentials) Microsoft Entra ID。 OAuth が選択されている場合、ベアラー トークンの対象ユーザー (接続で構成されたリソース URL) は、ターゲット エージェントが期待する対象ユーザーと一致する必要があります。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | Regions |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate（パワーオートメート） | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 名前 | Microsoft |
| URL | https://support.microsoft.com |
| コネクタ メタデータ | |
|---|---|
| パブリッシャー | Microsoft |
| Web サイト | https://www.microsoft.com |
| プライバシー ポリシー | https://privacy.microsoft.com/ |
| カテゴリ | 生産性 |
エージェント SDK コネクタは、Bot Framework/Microsoft Agents SDK アクティビティ ペイロードをユーザー指定のエージェント エンドポイントに転送します。 エージェント エンドポイント URL は、入力パラメーターとして呼び出しごとに指定されます。OAuth トークンは、接続で構成されたユーザー指定のMicrosoft Entra IDアプリケーション資格情報からプラットフォームによって作成され、すべての送信要求にベアラー トークンとして挿入されます。 ベアラー トークンの対象ユーザー (接続で構成されたリソース URL) は、ターゲット エージェントが期待する対象ユーザーと一致する必要があります。
前提条件
- デプロイされた Microsoft Agents SDK/Bot Framework エージェントは、HTTPS 経由で到達可能です。
- エージェントをホストしているテナントに登録されているMicrosoft Entra ID アプリケーション。ターゲット エージェントを呼び出す
client_credentials許可とアクセス許可で構成されます。 - エージェントの予想されるトークン対象ユーザー (通常はエージェントの Microsoft アプリ ID(
api://<appId>など)。
資格情報を取得する
API 要求を認証するには、次のものが必要です。
- Microsoft Entra ID アプリケーションのテナント ID。
- Microsoft Entra ID アプリケーションのクライアント ID (アプリケーション ID)。
- そのアプリケーションの クライアント シークレット 。
- ターゲット エージェントで予想される対象ユーザーと一致する リソース URL (Bot Framework スキル認証パターン)。
接続を作成するときに、これらの値を指定します。 対象ユーザーが異なる場合は、エージェントごとに 1 つの接続を作成します。
既知の問題と制限事項
-
agentEndpoint入力は、完全な HTTPS URL (たとえば、https://my-agent.azurewebsites.net) である必要があります。 コネクタは/api/messagesを追加し、アクティビティ ペイロードを転送します。 - コネクタはアクティビティ ペイロード as-is を転送し、
deliveryMode設定しません。 エージェントは、受信アクティビティで指定されたserviceUrlに POSTing 応答アクティビティを返すことによって非同期 (通常の配信) に応答します (呼び出し元は、たとえば、Microsoft Copilot Studio、SAS キーのコールバックserviceUrlを提供します)。 - このコネクタはプレビュー段階です。 可用性と機能は変更される可能性があります。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| API キー | ターゲット エージェントがカスタム HTTP ヘッダーで想定する静的 API キーを使用して認証します。 ヘッダー名 (x-api-key など) とその値の両方を指定します。 | すべてのリージョン | 共有不可 |
| Microsoft Entra ID (クライアント資格情報) | client_credentials フローを使用したMicrosoft Entra ID アプリケーションからの Mint OAuth ベアラー トークン。 ベアラー トークンの対象ユーザー (リソース URL) は、ターゲット エージェントが期待する対象ユーザーと一致する必要があります。 | すべてのリージョン | 共有不可 |
| 認証なし | 認証ヘッダーなしでターゲット エージェント エンドポイントを呼び出します。 匿名呼び出しを明示的に受け入れるエージェントでのみ使用します。 | すべてのリージョン | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
API キー
認証 ID: apiKey
適用対象: すべてのリージョン
ターゲット エージェントがカスタム HTTP ヘッダーで想定する静的 API キーを使用して認証します。 ヘッダー名 (x-api-key など) とその値の両方を指定します。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | Required |
|---|---|---|---|
| API キー ヘッダー名 | 文字列 | ターゲット エージェントが API キーを受け取る HTTP ヘッダーの名前 (例: x-api-key または Ocp-Apim-Subscription-Key)。 | True |
| API キーの値 | Securestring | ターゲット エージェント エンドポイントに対するすべての要求で送信される静的 API キー値。 | True |
Microsoft Entra ID (クライアント資格情報)
認証 ID: oauthClientCredentials
適用対象: すべてのリージョン
client_credentials フローを使用したMicrosoft Entra ID アプリケーションからの Mint OAuth ベアラー トークン。 ベアラー トークンの対象ユーザー (リソース URL) は、ターゲット エージェントが期待する対象ユーザーと一致する必要があります。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | Required |
|---|---|---|---|
| Tenant | 文字列 | Microsoft Entra ID アプリケーションのテナント ID | True |
| クライアント ID | 文字列 | Microsoft Entra ID アプリケーションのクライアント (またはアプリケーション) ID。 | True |
| クライアント シークレット | Securestring | Microsoft Entra ID アプリケーションのクライアント シークレット。 | True |
| リソースの URL | 文字列 | OAuth トークンの対象ユーザー。 通常、ターゲット エージェントのMicrosoftアプリ ID (たとえば、api://<appId> アプリ ID GUID)。 | True |
認証なし
認証 ID: 匿名
適用対象: すべてのリージョン
認証ヘッダーなしでターゲット エージェント エンドポイントを呼び出します。 匿名呼び出しを明示的に受け入れるエージェントでのみ使用します。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、キャンバス アプリの Connectors の概要 - Power Apps |Microsoft Docs
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
アクション
| エージェントにアクティビティを送信する |
アクティビティ プロトコル ペイロードを {agentEndpoint}/api/messages のエージェント エンドポイントに転送します。 接続で Microsoft Entra ID OAuth を使用する場合、トークン対象ユーザー (接続上のリソース URL) は、ターゲット エージェント (Bot Framework スキル認証パターン) で想定される対象ユーザーと同じである必要があります。対象ユーザーが異なる場合は、エージェントごとに 1 つの接続を作成します。 コネクタは、アクティビティ ペイロード as-is を転送し、'deliveryMode' を設定しません。エージェントは、受信アクティビティで指定された 'serviceUrl' に応答アクティビティを POSTing することで、非同期 (通常の配信) に応答します。 |
エージェントにアクティビティを送信する
アクティビティ プロトコル ペイロードを {agentEndpoint}/api/messages のエージェント エンドポイントに転送します。 接続で Microsoft Entra ID OAuth を使用する場合、トークン対象ユーザー (接続上のリソース URL) は、ターゲット エージェント (Bot Framework スキル認証パターン) で想定される対象ユーザーと同じである必要があります。対象ユーザーが異なる場合は、エージェントごとに 1 つの接続を作成します。 コネクタは、アクティビティ ペイロード as-is を転送し、'deliveryMode' を設定しません。エージェントは、受信アクティビティで指定された 'serviceUrl' に応答アクティビティを POSTing することで、非同期 (通常の配信) に応答します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エージェント エンドポイント URL
|
agentEndpoint | True | string |
ターゲット Microsoft Agents SDK/Bot Framework エンドポイントのベース URL (たとえば、https://my-agent.azurewebsites.net)。 コネクタは /api/messages を追加します。 |
|
|
object |
返品
- response
- object
定義
オブジェクト
’オブジェクト’ という種類です。