認定用 Power Platform コネクタと AI 対応コネクタファイルを準備する

[アーティクル]
03/26/2025

このプロセスは、認証された発行者と独立系発行者の両方を対象としています。

カスタムコネクタや AI 対応コネクタの開発終了後は、以下の手順で認定の準備を行い、マイクロソフトに提出するコネクタや AI を活用したコネクタファイルを生成します。

注意

この記事では、Azure Logic Apps、Microsoft Power Automate、Microsoft Power Apps、Microsoft Copilot Studio 用 AI 対応コネクタファイルでカスタムコネクタを認定するための情報を提供します。この記事の手順を実行する前に、コネクタやアクション (プラグイン) の認定を取得するを参照してください。

手順 1: コネクタや AI 対応コネクタを登録する (独立系発行元のみに適用可能)

このセクションは、認証された発行者には適用されません。

カスタムコネクタや AI 対応コネクタでの開発が完了していなくても、認定を申請できます。認定プロセスを開始するには、登録フォームに記入してコネクタや AI 対応コネクタの認定登録をしてください。

マイクロソフトの担当者から 2 営業日以内に電子メールが届き、担当者は次のことを行います:

カスタムコネクタ、コネクタ、AI 対応コネクタを理解します。
開発プロセスについて解説します。
認定プロセスに関するメールが送信されます。

ステップ2: コネクタの提出要件を満たす

認定されたコネクタ間で高水準の品質と一貫性を維持するために、Microsoft には、カスタムコネクタが認定のために遵守する必要がある一連の要件とガイドラインがあります。

コネクタにタイトルを付ける

タイトルは以下の条件を満たしている必要があります。

存在しており、英語で書かれている必要があります。
既存のコネクタまたはプラグインのタイトルと区別できる一意のものでなければなりません。
製品または組織の名前である必要があります。
認定コネクタまたはプラグインの既存の命名パターンに従う必要があります。独立系発行者の場合、コネクタ名は Connector and/or plugin Name (Independent Publisher) というパターンに従ってください。
名前を 30 文字より長くすることはできません。
API、コネクタ という単語、または Power Platform 製品名 (Power Apps など) は使用できません。
キャリッジリターン、改行、空白など、英数字以外の文字で終了することはできません。

例

適切なコネクタまたはプラグインのタイトル: Azure Sentinel*, *Office 365 Outlook
不適切なコネクタまたはプラグインのタイトル: Azure Sentinel's Power Apps Connector、Office 365 Outlook API

コネクタの説明を記述する

この説明には次の要件を満たす必要があります。

存在しており、英語で書かれている必要があります。
文法上の誤りとスペルミスがないようにしてください。
コネクタが提供する主な目的と価値を簡潔に説明する必要があります。
30 字よりも短くしたり、500 字より長くしたりすることはできません。
Power Platform の製品名を含めることはできません (例: Power Apps)。

コネクタのアイコンをデザインする (認証済みの発行者のみ対象)

このセクションは、独立した発行元には適用されません。

100 ×100 から 230 × 230 ピクセル (角は丸くない) の範囲で、1:1 サイズのロゴを作成します。
指定したアイコンの背景色と一致する、不透明で白色でない (#ffffff) 背景と、既定でない色 (#007ee5) を使用します。
アイコンが他の認定コネクタアイコンに固有であることを確認します。
ロゴを PNG 形式で <icon>.png として送信します。
一貫した背景で、画像の高さと幅の 70% 未満にロゴのサイズを設定します。
ブランドカラーが有効な 16 進数のカラーであることを確認し、白 (#ffffff) やデフォルト (#007ee5) にしないでください。

操作とパラメータの概要と説明の定義

要約と説明は以下の要件を満たしている必要があります。

存在しており、英語で書かれている必要があります。
文法上の誤りとスペルミスがないようにしてください。
オペレーションとパラメーターの概要は、80 文字以下で、英数字または括弧のみで構成する必要があります。
操作方法やパラメータの説明は、完全な説明文とし、語尾には句読点を付けてください。
Microsoft Power Platform の製品名を含めることはできません (例: "Power Apps")。

正確な操作レスポンスの定義

操作のレスポンスは以下の要件を満たしている必要があります。

想定される応答のみを使用して、正確なスキーマを使用した操作応答を定義します。
正確なスキーマ定義の既定応答を使用しないでください。
Swagger 内のすべての操作に有効な応答スキーマ定義を提供します。
空の応答スキーマは、応答スキーマが動的である特別な場合を除いて許可されていません。これは、動的コンテンツが出力に表示されないことを意味し、作成者は応答を解析するために JSON を使用する必要があります。
空の操作は許可されていません。
必要でない限り、空のプロパティを削除します。

Swagger プロパティを確認する

このプロパティは次の要件を満たす必要があります。

"openapidefinition" が正しくフォーマットされた JSON ファイル内にあることを確認します。
Swagger 定義が OpenAPI 2.0 標準およびコネクタの拡張標準に準拠していることを確認します。

接続パラメーターを確認する

このパラメーターは次の要件を満たす必要があります。

"UIDefinition" の適切な値 (表示名、説明) でプロパティが更新されていることを確認します。

接続パラメーターで基本認証を使用する場合は、JSON が次の例のように正しくフォーマットされていることを確認してください。

{
  "username": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourUsernameLabel",
      "description": "The description of YourUsernameLabel for this api",
      "tooltip": "Provide the YourUsernameLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": true,
        "required": "true"
        }
  }
},
  "password": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourPasswordLabel",
      "description": "The description of YourPasswordLabel for this api",
      "tooltip": "Provide the YourPasswordLabel tooltip text",
      "constraints": {
        "tabIndex": 3,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

接続パラメーターが認証として APIKey を含んでいる場合、JSON が次の例のように正しくフォーマットされていることを確認してください。

{
  "api_key": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourApiKeyParameterLabel",
      "tooltip": "Provide your YourApiKeyParameterLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

接続パラメータに生成 OAuth の認証がある場合は、次の例のように JSON が正しい形式になっていることを確認します。

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "oauth2",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "AuthorizationUrl": {
          "value": "https://contoso.com"
        },
        "TokenUrl": {
          "value": "https://contoso.com"
        },
        "RefreshUrl": {
          "value": "https://contoso.com"
        }
      },
      "clientId": "YourClientID"
    },
    "uiDefinition": null
  }
}

接続パラメーターが OAuth2 ID プロバイダーを含んでいる場合、その ID プロバイダーがサポートされている OAuth2 プロバイダーのリストに含まれていることを確認してください。以下は、GitHub OAuth2 ID プロバイダーの例です:
```
{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "github",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {},
      "clientId": "YourClientId"
    },
    "uiDefinition": null
  }
}
```

接続パラメーターが認証として Microsoft Entra ID を含んでいる場合、JSON が次の例のように正しくフォーマットされていることを確認してください。

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "aad",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "LoginUri": {
          "value": "https://login.microsoftonline.com"
        },
        "TenantId": {
          "value": "common"
        },
        "ResourceUri": {
          "value": "resourceUri"
        },
        "EnableOnbehalfOfLogin": {
          "value": false
        }
      },
      "clientId": "AzureActiveDirectoryClientId"
    },
    "uiDefinition": null
  }
}

質の高い英語の文字列を作成する

コネクタは、Power Automate のローカライズの一環としてローカライズされるため、コネクタを開発する際には、英語の文字列の翻訳品質が鍵となります。ここでは、指定した文字列の値を作成する上で、注目すべき主なポイントを紹介します。

すべての文字列値に誤字脱字がないことを確認するには、スペルチェックプログラムを実行してください。不完全な英語の文字列があった場合、翻訳結果が不完全、または文脈的に正しくないものとなります。
完全な文章であることをご確認ください。文が完全でない場合、低品質の翻訳を生成してしまう可能性があります。
文章の意味が明確になるようにしてください。また、文の意味が曖昧な場合、質の低い翻訳や間違った翻訳が生成される可能性があります。
要約、x-ms-要約、および説明が文法的に正しいことを確認してください。それらをコピー、および貼り付けをしないで下さい。それらが製品内でどのように表示されるかについては、コネクタ文字列のガイダンスをご覧ください。
可能であれば、ランタイムの合成文字列は避けてください。その代わりに、完全な形の文章を使用してください。文字列や文章が連結されていると、翻訳が困難になったり、誤訳の原因になったりします。
略語を使う場合は、必ず大文字にして明確化してください。これにより、誤字脱字と間違われる可能性が低くなります。
CaMel 形式の文字列 (minimizeHighways や MinimizeHighways など) は、通常、翻訳不可能と見なされます。文字列値をローカライズする場合は、CaMel フォーム文字列を修正する必要があります。

手順 3: ソリューションチェッカーを実行してコネクタを検証する

ソリューションチェッカーは、静的分析を実行して、コネクタが Microsoft の認証に必要な標準に準拠していることを確認するメカニズムです。 Power Automate または Power Apps のソリューションにコネクタを追加し、ソリューションチェッカーでカスタムコネクタを検証するの指示に従い、ソリューションチェッカーを実行します。

このビデオでは、ソリューションチェッカーの実行方法について説明します。

ステップ 4: プラグインの提出要件を満たす

このセクションは、関連するコネクタプラグインも認証に提出する場合に適用されます。

Microsoft Copilot 用 AI プラグインの作成 (プレビュー) のガイドラインに従ってプラグインを作成したことを確認してください。
提出するすべての AI 対応コネクタは、100.10 不適切なコンテンツで強調表示されている標準に準拠している必要があります。
すべての AI 対応コネクタは責任ある AI のガイドラインに従います。
プラグインは、100.10 不適切なコンテンツで概説されている既存の商業マーケットプレイスポリシーに従って、不適切、有害、または攻撃的な人工知能 (AI) 生成コンテンツを生成、包含、またはアクセスを提供してはなりません。

ステップ 5: コネクタやプラグインの成果物を準備する

注意

認定前に、自分のコネクタや AI 対応コネクタが仕様に準拠していること、およびその品質が確保されていることを確認してください。これを怠ると変更を求められるため、認定の遅れが生じます。
ホスト URL の製品版を提供します。ステージング、開発、テストのホスト URL は許可されていません。

一連のファイルを Microsoft へ送信しています。これは、Maker Portal か Microsoft Copilot Studio からのソリューション生成です。ファイルをパッケージ化するには、このセクションの手順に従います。

コネクタとプラグインのパッケージガイド

このセクションの手順では、パッケージ化のさまざまなシナリオについて説明します。カスタムコネクタのみをパッケージ化する場合は、最初のシナリオを使用します。カスタムコネクタと AI 対応コネクタの両方をパッケージ化する場合は、2 番目のシナリオを使用します。 既存の コネクタと AI 対応コネクタをパッケージ化する場合は、最後のシナリオを使用します。

カスタムコネクタをパッケージし、提出して認証する
認定用にコネクタと AI 対応コネクタファイルをパッケージ化する
認定用に既存の認定済みコネクタと AI 対応コネクタをパッケージ化する

カスタムコネクタをパッケージし、提出して認証する

ソリューションへのカスタムコネクタを作成する。
ステップ 1 で作成したコネクタソリューションに対してソリューションチェッカーを実行します。
コネクタソリューションをエクスポートします。
新しく作成したカスタムコネクタを使用してフロー (テスト) を作成するか、ソリューションに既存のフローを追加します。
フローのソリューションをエクスポートします。
手順 3 と 5 のソリューションを使用してパッケージを作成します。
intro.md ファイルを作成します。
最終パッケージを次の形式の zip ファイルとして作成します:

注意

ソリューション外のフォルダーとファイルの名前は参照用であり、要件に応じて選択できます。ただし、ソリューション内のファイルは操作できません。

パッケージをストレージ BLOB にアップロードし、SAS URL を生成します。 SAS URI が少なくとも 15 日間有効であることを確認してください。
パートナーセンターにパッケージを提出してください。

認定用にカスタムコネクタと AI 対応コネクタをパッケージ化する

この記事のカスタムコネクタをパッケージ化して認定を申請するに記載の手順 1 ～ 5 に従います。
Microsoft Copilot Studio ポータルでプラグインを作成し、ソリューションとしてエクスポートします。
以下からパッケージを作成します:
- ソリューションチェッカーの実行 (「カスタムコネクタをパッケージ化して認定用に送信する」に記載の手順 2)。
- フローのソリューションのエクスポート (カスタムコネクタをパッケージ化して認定用に送信するに記載の手順 5)。
- Microsoft Copilot Studio でプラグインを作成し、ソリューションとしてエクスポートする (この手順のステップ 2)。
intro.md ファイルを作成します。
最終パッケージを次の形式の zip ファイルとして作成します。

注意

ソリューション外のフォルダーとファイルの名前は参照用であり、要件に応じて選択できます。ただし、ソリューション内のファイルは操作できません。

パッケージをストレージ BLOB にアップロードし、SAS URL を生成します。 SAS URI が少なくとも 15 日間有効であることを確認してください。
パートナーセンターにパッケージを提出してください。

既存の認定済みコネクタと AI 対応コネクタを認定用にパッケージ化します

Power Automate でソリューションを作成し、すでに認定されているコネクタを追加します。
この記事のカスタムコネクタをパッケージ化して認定を申請するに記載の手順 2 ～ 4 に従います。
Copilot Studio でプラグインを作成し、ソリューションとしてエクスポートします。
プラグインをソリューションとしてエクスポートします。
以下からパッケージを作成します:
- コネクタソリューションでソリューションチェッカーを実行します (この記事のカスタムコネクタをパッケージ化して認証に提出するに記載のステップ 2)。
- Copilot Studio でプラグインを作成し、ソリューションとしてエクスポートする (この手順のステップ 3)。
- Copilot Studio でプラグインを作成し、ソリューションとしてエクスポートする (この手順のステップ 4)。
intro.md ファイルを作成します。
最終パッケージを次の形式の zip ファイルとして作成します。

注意

ソリューション外のフォルダーとファイルの名前は参照用であり、要件に応じて選択できます。ただし、ソリューション内のファイルは操作できません。

パッケージをストレージ BLOB にアップロードし、SAS URL を生成します。 SAS URI が少なくとも 15 日間有効であることを確認してください。
パートナーセンターにパッケージを提出してください。

認証済みの発行元と独立系発行元の両方が、アーティファクトで openapidefinition.json をダウンロードします。このファイルで IconBrandColor を設定する必要があります。

確認済みの発行元:: openapidefinition ファイルで iconBrandColor を自分のブランドカラーに設定します。
独立系発行元:: iconBrandColor を openapidefinition ファイルで "#da3b01" に設定します。

intro.md アーティファクトを作成する

intro.md ファイルは、独立発行者と検証済み発行者の両方に必要です。コネクタの機能を文書化するには、intro.md ファイルを作成する必要があります。含めるドキュメントの例については、Readme.md の例を参照してください。 intro.md ファイルの記述方法については、GitHub リポジトリの他の intro.md ファイル (Readme.md ファイルとしても知られています) を参照してください。

独立系発行元であり、コネクタが OAuth を使用している場合は、資格情報を取得する方法の説明が含まれていることを確認してください。

チップ

既知の問題と制限 は、ユーザーを最新の状態に保つために維持するのに最適なセクションです。

ステップ 6: パッケージの構造を検証する

パッケージ検証スクリプトは、パッケージ構造を検証し、認定のために受け入れ可能な形式でパッケージを生成するのに役立ちます。このリンク: ConnectorPackageValidator.ps1 を使用してパッケージ検証スクリプトをダウンロードします。

スクリプトを実行するには、次の手順に従います。

管理モードで、Windows PowerShell を開きます。
cd / と入力して、ドライブの場所を変更します。

次の例は C:\を使用します。
パッケージバリデータースクリプトをダウンロードしたパスに移動します。

たとえば、パスが C:\Users\user01\Downloads の場合は、cd .\Users\user01\Downloads\ と入力します。
次のコマンドを入力して、実行ポリシーを無制限に設定します。

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

このコマンドを使用すると、PowerShell を制限なく実行できます。
Y を入力して入力を確定します。これははいを意味します。
次の手順で ConnectorPackageValidator.ps1 を実行します。
1. コネクタパッケージを含む zip ファイルパスを入力します。
2. AI プラグインを有効にするかどうかを指定します。
次の例に示すように、最初の引数は、パッケージを含む有効な zip ファイルパスです。 2 番目の引数は yes/y AI プラグインが有効であることを示すか、no/n が無効であることを示します。

パッケージ構造が正しければ、次の成功メッセージが表示されます。

パッケージ構造に問題がある場合、スクリプトはパッケージ構造の欠陥を検出して強調表示することで、問題の詳細を提供します。

ステップ 7: 認証のためにコネクタまたはプラグインを提出する

提出プロセスでは、コネクタまたはプラグインを Microsoft Power Platform コネクタリポジトリにオープンソース化します。

(独立系発行者の場合) パッケージをマイクロソフトに提出して認定を受けるには、独立系発行者の認定プロセスに記載の手順に従ってください。
(認証済み発行者の場合) パートナーセンターへの認定のためにマイクロソフトにパッケージを提出するには、認証済み発行者の認定プロセスに記載の指示に従ってください。

確認済みの発行元で、カスタムコードを使用している場合は、script.csx ファイルを送信する必要があります。

コネクタに OAuthがある場合は、パートナーセンターでクライアント ID とシークレットを指定します。また、アプリを更新するには、コネクタ送信要求から APIname を取得します。

提出の一環として、マイクロソフトはコネクタまたはプラグインを認証します。 Swagger エラーのトラブルシューティングが必要な場合は、Swagger 検証エラーの修正を参照してください。

送信前の確認事項

コネクタを提出してマイクロソフトの認定を受けるに進む前に、以下を確認します:

コネクタやプラグインが、ステップ 2: コネクタの申請要件を満たすおよびステップ 4: プラグインの申請要件を満たすで設定されたすべての標準を満たしています。
概要、解説、可視性情報の操作が欠落していない。
カスタムコネクタをテストして、操作が期待どおりに機能することを確認 (操作ごとに少なくとも 10 回の呼び出しが成功すること)。
カスタムコネクタウィザードのテストセクションに、ランタイムエラーやスキーマ検証エラーが表示されない。

認証に関する問い合わせは

オフィスアワーミーティングに参加するために、Microsoft Teams が必要です。アクセスが必要な場合は、Microsoft Teams でオプションを確認してください。

UTC (協定世界時) の毎週火曜日の午後 3 時 30 分から午後 4 時 30 分までに開催される、オフィスアワーミーティングに参加しましょう。

チップ

YouTube ビデオ、ブログまたはその他のコネクタを作成して、コネクタまたはプラグインの使用を開始する方法のサンプルまたはスクリーンショットを共有します。
intro.md ファイルにこのリンクを含め、ドキュメントに追加できるようにします。
追加ツールチップユーザーの成功を支援するために、Swaggerファイルに追加します。

次の方法で共有

認定用 Power Platform コネクタと AI 対応コネクタファイルを準備する

手順 1: コネクタや AI 対応コネクタを登録する (独立系発行元のみに適用可能)

ステップ2: コネクタの提出要件を満たす

コネクタにタイトルを付ける

コネクタの説明を記述する

コネクタのアイコンをデザインする (認証済みの発行者のみ対象)

操作とパラメータの概要と説明の定義

正確な操作レスポンスの定義

Swagger プロパティを確認する

接続パラメーターを確認する

質の高い英語の文字列を作成する

手順 3: ソリューションチェッカーを実行してコネクタを検証する

ステップ 4: プラグインの提出要件を満たす

ステップ 5: コネクタやプラグインの成果物を準備する

コネクタとプラグインのパッケージガイド

カスタムコネクタをパッケージし、提出して認証する

認定用にカスタムコネクタと AI 対応コネクタをパッケージ化する

既存の認定済みコネクタと AI 対応コネクタを認定用にパッケージ化します

intro.md アーティファクトを作成する

ステップ 6: パッケージの構造を検証する

ステップ 7: 認証のためにコネクタまたはプラグインを提出する

送信前の確認事項

認証に関する問い合わせは

次のステップ

その他のリソース

次の方法で共有

認定用 Power Platform コネクタと AI 対応コネクタ ファイルを準備する

手順 1: コネクタや AI 対応コネクタを登録する (独立系発行元のみに適用可能)

ステップ2: コネクタの提出要件を満たす

コネクタにタイトルを付ける

コネクタの説明を記述する

コネクタのアイコンをデザインする (認証済みの発行者のみ対象)

操作とパラメータの概要と説明の定義

正確な操作レスポンスの定義

Swagger プロパティを確認する

接続パラメーターを確認する

質の高い英語の文字列を作成する

手順 3: ソリューション チェッカーを実行してコネクタを検証する

ステップ 4: プラグインの提出要件を満たす

ステップ 5: コネクタやプラグインの成果物を準備する

コネクタとプラグインのパッケージガイド

カスタム コネクタをパッケージし、提出して認証する

認定用にカスタム コネクタと AI 対応コネクタをパッケージ化する

既存の認定済みコネクタと AI 対応コネクタを認定用にパッケージ化します

intro.md アーティファクトを作成する

ステップ 6: パッケージの構造を検証する

ステップ 7: 認証のためにコネクタまたはプラグインを提出する

送信前の確認事項

認証に関する問い合わせは

次のステップ

その他のリソース

認定用 Power Platform コネクタと AI 対応コネクタファイルを準備する

手順 3: ソリューションチェッカーを実行してコネクタを検証する

カスタムコネクタをパッケージし、提出して認証する

認定用にカスタムコネクタと AI 対応コネクタをパッケージ化する