次の方法で共有


コネクタおよび AI 対応コネクター ファイルの認証準備

Microsoft Copilot Studio および Microsoft Power Platform カスタム コネクタ、または AI 対応コネクタ ファイルの開発が完了したら、認証の準備をする必要があります。 検証済みまたは独立系の発行者として、次の手順に従って認定の準備を行い、Microsoft に申請するコネクタまたは AI 対応コネクタ ファイルを生成します。

注意

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

ステップ 1: コネクタの申請要件を満たす

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

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

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

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

  • 適切なコネクタやアクション タイトル: Azure Sentinel*, *Office 365 Outlook
  • 不適切なコネクタやアクション タイトル: Azure Sentinel's Power Apps ConnectorOffice 365 Outlook API

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

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

  • 説明が Marketplace ガイドライン に準拠していることを確認します。
  • 存在しており、英語で書かれている必要があります。
  • 文法上の誤りとスペルミスがないようにしてください。
  • コネクタが提供する主な目的と価値を簡潔に説明する必要があります。
  • 30 文字より長く、500 文字より短くする必要があります。
  • Copilot Studio や Power Platform など他の製品名を含むことはできません (例: Power Apps)。

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

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

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

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

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

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

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

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

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

Swagger プロパティを確認する

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

  • openapidefinition.json が正しくフォーマットされた 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-要約、および説明が文法的に正しいことを確認してください。 要約をコピーおよび貼り付けないで下さい。 それらが製品内でどのように表示されるかについては、コネクタ文字列のガイダンス をご覧ください。

  • 可能であれば、ランタイムの合成文字列は避けてください。 その代わりに、完全な形の文章を使用してください。 文字列や文章が連結されていると、翻訳が困難になったり、誤訳の原因になったりします。

  • 略語はわかりやすくするため必ず大文字にしてください。 大文字にすると、誤字脱字と間違われる可能性が低くなります。

  • 文字列値をローカライズする場合は、CAlMel フォーム文字列を修正します。 CaMel 形式の文字列 (例: minimizeHighwaysMinimizeHighways) は、通常、翻訳不可能と見なされます。

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

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

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

ステップ 3: コネクタ アクションの送信要件を満たす

認定を受けるために関連するコネクタ アクションも提出する場合は、次の記事のすべてのガイドラインに従ってください。

ステップ 4: コネクタ、AI 対応コネクタ、アーティファクトを準備する

注意

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

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

コネクタと AI 対応のパッケージ ガイド

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

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

  1. ソリューションでカスタム コネクタを作成します

  2. ステップ 1 で作成したコネクタ ソリューションに対してソリューション チェッカーを実行します。

  3. コネクタ ソリューションをエクスポートします。

  4. 新しく作成したカスタム コネクタを使用してテスト フローを作成するか、ソリューションに既存のフローを追加します

  5. フローのソリューションをエクスポートします。

  6. 手順 3 と 5 のソリューションを使用してパッケージを作成します。

  7. intro.md ファイルを作成します

  8. 最終的なパッケージを次の形式の zip ファイルとして作成します。

    認証されたコネクタの zip ファイル内のフォルダとファイルのスクリーンショット。

注意

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

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

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

  1. この記事のカスタム コネクタをパッケージ化して認定を申請するに記載の手順 1 ~ 5 に従います。

  2. Microsoft Copilot Studio ポータルでプラグインを作成し、ソリューションとしてエクスポートします

  3. 以下からパッケージを作成します:

  4. intro.md ファイルを作成します

  5. 最終パッケージを次の形式の zip ファイルとして作成します。

    認証されるコネクタとプラグインの zip ファイル内のフォルダとファイルのスクリーンショット。

注意

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

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

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

  1. Power Automate でソリューションを作成し、既に認定されているコネクタを追加します。

  2. この記事のカスタム コネクタをパッケージ化して認定を申請するに記載の手順 2 ~ 4 に従います。

  3. Microsoft 365 Copilot や Copilot エージェントをコネクタ アクションで拡張します

  4. プラグインをソリューションとしてエクスポートします。

  5. 以下からパッケージを作成します:

  6. intro.md ファイルを作成します

  7. 最終パッケージを次の形式の zip ファイルとして作成します。

    既存の認証されたコネクタとプラグインの zip ファイル内のフォルダとファイルのスクリーンショット。

注意

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

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

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

  • 確認済みの発行元:: openapidefinition ファイルで iconBrandColor を自分のブランドカラーに設定します。
  • 独立系発行元:: iconBrandColor を openapidefinition ファイルで "#da3b01" に設定します。
    鮮やかなオレンジ (da3b01) アイコンのスクリーンショット。

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

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

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

チップ

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

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

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

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

  1. 管理モードで、Windows PowerShell を開きます。

    管理者モードの Windows PowerShell のスクリーンショット。

  2. cd / と入力して、ドライブの場所を変更します。

    次の例は C:\を使用します。

    ドライブを変更する構文のスクリーンショット。

  3. パッケージバリデータースクリプトをダウンロードしたパスに移動します。

    たとえば、パスが C:\Users\user01\Downloads の場合は、cd .\Users\user01\Downloads\ と入力します。

    パスを変更する構文のスクリーンショット。

  4. 次のコマンドを入力して、実行ポリシーを無制限に設定します。

    Set-ExecutionPolicy -ExecutionPolicy Unrestricted

    実行ポリシーを設定する syntax のスクリーンショット。

    このコマンドを使用すると、PowerShell を制限なく実行できます。

  5. Y を入力して入力を確定します。これは はい を意味します。

  6. 次の手順で ConnectorPackageValidator.ps1 を実行します。

    1. コネクタ パッケージを含む zip ファイル パスを入力します。
    2. AI アクションを有効にするかどうかを指定します。

    次の例に示すように、最初の引数は、パッケージを含む有効な zip ファイル パスです。 2 番目の引数は、yes/y で AI アクションが有効であることを示し、no/n で無効であることを示します。

    ConnectorPackageValidator.ps1 を実行する構文を示します。

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

    成功メッセージ「Validation successful: The package structure is correct」が強調表示されます。

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

    問題の詳細メッセージ「検証に失敗しました: 無効なパッケージ構造。詳細については、以前のメッセージを確認してください。」を強調表示します。

ステップ 6: 認定用にコネクタや AI 対応コネクタを提出する

申請プロセス中に、コネクタや AI 対応コネクタを Microsoft Power Platform コネクタ リポジトリ にオープンソース化します。

  1. (独立系発行者の場合) パッケージをマイクロソフトに提出して認定を受けるには、独立系発行者の認定プロセス に記載の手順に従ってください。

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

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

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

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

送信前の確認事項

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

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

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

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

チップ

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

次のステップ