Microsoft Copilot Studio
エージェントの検出とトリガーに使用されるMicrosoft Copilot Studio
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| Copilot Studio | Standard | 次を除くすべてのPower Automateリージョン: - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Apps | Standard | 次を除くすべてのPower Appsリージョン: - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Standard | 次を除くすべてのPower Automateリージョン: - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft Copilot Studio |
| URL | https://aka.ms/copilotstudio |
| donglei@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://aka.ms/copilotstudio |
| プライバシー ポリシー | https://www.microsoft.com/en-us/privacy/privacystatement |
| カテゴリ | AI |
一般的な制限
| 名前 | 価値 |
|---|---|
| アカウントあたりの接続数 | 50 |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 300 | 60 秒 |
アクション
| エージェント テスト セットの取得 |
エージェントのテスト セットを取得します。 |
| エージェント テスト セットの詳細を取得する |
特定のメーカー評価テスト セットの詳細を取得します。 |
| エージェント テストの実行の詳細を取得する |
特定のメーカー評価テストの実行の詳細を取得します。 |
| エージェントのテスト実行を取得する |
指定したエージェントのメーカー評価テストの実行を取得します。 |
| エージェントの実行 |
指定したエージェントに処理を求めるメッセージを送信します |
| エージェントの実行と待機 |
指定したエージェントに処理を求めるメッセージを送信し、再開を待機します |
| エージェントの評価 |
特定のテスト セットを使用してエージェントを評価します。 |
エージェント テスト セットの取得
エージェントのテスト セットを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
ドロップダウン リストからエージェントを選択するか、カスタム値 (エージェント ID) を入力します。 |
戻り値
- Body
- TestSetsResponse
エージェント テスト セットの詳細を取得する
特定のメーカー評価テスト セットの詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
ドロップダウン リストからエージェントを選択するか、カスタム値 (エージェント ID) を入力します。 |
|
テスト セット
|
TestSetId | True | string |
ドロップダウン リストからテスト セットを選択するか、カスタム値 (テスト セット ID) を入力します。 |
戻り値
- Body
- TestSet
エージェント テストの実行の詳細を取得する
特定のメーカー評価テストの実行の詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
ドロップダウン リストからエージェントを選択するか、カスタム値 (エージェント ID) を入力します。 |
|
評価の実行
|
EvaluationRunId | True | string |
ドロップダウン リストから評価実行を選択するか、カスタム値 (評価実行 ID) を入力します。 |
戻り値
- Body
- TestRun
エージェントのテスト実行を取得する
指定したエージェントのメーカー評価テストの実行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
ドロップダウン リストからエージェントを選択するか、カスタム値 (エージェント ID) を入力します。 |
戻り値
- Body
- TestRunsResponse
エージェントの実行
指定したエージェントに処理を求めるメッセージを送信します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Agent
|
Copilot | True | string |
Agent |
|
メッセージ
|
message | string |
メッセージ |
|
|
テキスト フィールドの内容の BCP-47 ロケール名。
|
locale | string |
テキスト フィールドの内容の BCP-47 ロケール名。 |
|
|
コンテンツタイプ
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
コンテンツ
|
content | object | ||
|
名前
|
name | string | ||
|
サムネイルURL
|
thumbnailUrl | string | ||
|
会話 ID
|
x-ms-conversation-id | string |
エージェントの実行を再開するために、既存の会話 ID を指定します。 |
|
|
環境 ID
|
environmentId | string |
オプションの環境 ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ConversationId
|
ConversationId | string |
応答に関連付けられている会話 ID |
エージェントの実行と待機
指定したエージェントに処理を求めるメッセージを送信し、再開を待機します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Agent
|
Copilot | True | string |
Agent |
|
メッセージ
|
message | string |
メッセージ |
|
|
テキスト フィールドの内容の BCP-47 ロケール名。
|
locale | string |
テキスト フィールドの内容の BCP-47 ロケール名。 |
|
|
コンテンツタイプ
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
コンテンツ
|
content | object | ||
|
名前
|
name | string | ||
|
サムネイルURL
|
thumbnailUrl | string | ||
|
会話 ID
|
x-ms-conversation-id | string |
エージェントの実行を再開するために、既存の会話 ID を指定します。 |
|
|
環境 ID
|
environmentId | string |
オプションの環境 ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
lastResponse
|
lastResponse | string |
アクティビティ 一覧の最後のテキスト応答 |
|
応答
|
responses | array of string |
アクティビティ リスト内の文字列応答の一覧 |
|
conversationId
|
conversationId | string |
応答に関連付けられている会話 ID |
エージェントの評価
特定のテスト セットを使用してエージェントを評価します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Agent
|
Agent | True | string |
ドロップダウン リストからエージェントを選択するか、カスタム値 (エージェント ID) を入力します。 |
|
テスト セット
|
TestSetId | True | string |
ドロップダウン リストからテスト セットを選択するか、カスタム値 (テスト セット ID) を入力します。 |
|
MCS 接続 ID
|
mcsConnectionId | string |
[ユーザー プロファイル ] を選択します。MCS 接続 ID を入力するか、匿名実行の場合は空のままにします。 |
|
|
評価実行名
|
evaluationRunName | string |
評価実行の名前を入力するか、空のままにします。 |
定義
TestSetsResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of TestSet |
TestSet
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string | |
|
ディスプレイ名
|
displayName | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
説明
|
description | string | |
|
auditInfo
|
auditInfo | AuditInfo | |
|
状態
|
state | string |
AuditInfo
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
createdBy
|
createdBy | string | |
|
createdTimeUTCの
|
createdTimeUtc | date-time | |
|
modifiedBy
|
modifiedBy | string | |
|
modifiedTimeUtc
|
modifiedTimeUtc | date-time |
TestRunsResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of TestRun |
TestRun
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string | |
|
environmentId
|
environmentId | string | |
|
cdsBotId
|
cdsBotId | string | |
|
ownerId
|
ownerId | string | |
|
testSetId
|
testSetId | string | |
|
状態
|
state | string | |
|
startTime
|
startTime | date-time | |
|
endTime
|
endTime | date-time | |
|
名前
|
name | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
msConnectionId
|
msConnectionId | string |