Powerplatform MCP

🚀 PowerPlatform MCP 提示

PowerPlatformは強力な低コード開発プラットフォームで、ビジネスアプリケーションの構築に使用されます。開発者がこのプラットフォームをより効率的に使用できるように、MCP（Microsoft Cloud Platform）はさまざまなヒント機能を提供しています。

✨ 主な機能

• エンティティ概要：具体的なエンティティに関する詳細情報を提供します。
• クエリテンプレート：データクエリ文の生成と最適化を支援します。
• 関係マップ：異なるエンティティ間の関連性を表示します。
• フィールド詳細：特定のフィールドのデータ型と使用シーンを説明します。

💻 使用例

基本的な使用法

1. エンティティの理解

ユーザーは自然言語で特定のエンティティに関する情報を問い合わせることができます。

ユーザー：PowerPlatform環境のAccountエンティティに関する情報を教えてください。
応答：[内部で ENTITY_OVERVIEW ヒントを使用]
以下はAccountエンティティの概要です：
- これは、顧客や潜在顧客を表すための核心的なビジネスエンティティです。
- 主要な識別子は'accountid'で、主要な表示フィールドは'name'です。
- 重要なフィールドには以下が含まれます：
  * name（アカウント名）
  * emailaddress1（メールアドレス）
  * telephone1（主な電話番号）
  * revenue（年収）
- 42の1対多関係と8の多対多関係があります。

2. クエリの構築

クエリの作成に困った場合、AIに支援を求めることができます。

ユーザー：カリフォルニア州のアクティブなアカウントで年収が100万ドルを超えるものを検索するクエリを作成してください。
応答：[内部で QUERY_TEMPLATE ヒントを使用]
以下は必要なODataクエリです：
accounts?$select=name,revenue,statecode,address1_stateorprovince
&$filter=statecode eq 0 
    and revenue gt 1000000 
    and address1_stateorprovince eq 'California'
&$orderby=revenue desc

このクエリの機能は以下の通りです：
1. 関連するフィールドを選択：name, revenue, statecode, address1_stateorprovince
2. フィルタ条件：
   - 状態コードが0（アクティブを表す）
   - 年収が100万ドルを超える
   - 所在州がカリフォルニア
3. 年収で降順に並べる

3. 関係の理解

エンティティ間の関係を調べる場合、以下のような質問をすることができます。

ユーザー：システム内でAccountとContactはどのように関連付けられていますか？
応答：[内部で RELATIONSHIP_MAP ヒントを使用して2つのエンティティをそれぞれ分析]
以下は主要な関係の概要です：
1. 主要な連絡先（1対多）：
   - account_primary_contact: Account (1) → Contact (N)
     各アカウントには複数の連絡先がありますが、その中の1つがPRIMARYとして指定されます。
2. 顧客関係：
   - contact_customer_accounts: Contact (N) ← Account (1)
     連絡先は顧客アカウントと関連付けることができます。
3. その他の関連：
   - accountleads_association: 潜在顧客の追跡に使用
   - account_connections: 連絡の管理に使用

4. フィールド/属性の調査

特定のフィールドの情報を知りたい場合、以下のように問い合わせることができます。

ユーザー：Accountエンティティのrevenueフィールドのデータ型は何ですか？
応答：[内部で ATTRIBUTE_DETAILS ヒントを使用]
このフィールドの情報は以下の通りです：
- データ型：Money（通貨）
- 形式：通貨形式で表示
- 説明：アカウントの年収を表します。
- 必須項目：はい
- デフォルト値：null

5. デバッグ支援

問題が発生した場合、AIにデバッグ支援を求めることができます。

ユーザー：以下のクエリを使用しているときにエラーが発生しました。分析してください。
accounts?$select=name,revenue&$filter=year(PropertyName=’revenue’) gt 2020

応答：

現在のクエリには以下の問題があります：
1. PropertyNameの構文エラー：正しいフィールド参照は`(PropertyName='revenue')`で、Property Nameをシングルクォートで囲む必要があります。
2. 関数呼び出しが正しくない：`year(PropertyName)`関数の呼び出し方が間違っています。正しい形式は`year(PropertyName)`です。
3. フィールド選択の問題：フィルタ条件を満たすために、より多くの関連フィールドを追加する必要があるかもしれません。

修正後のクエリは以下のようになります：
accounts?$select=name,revenue&$filter=year(PropertyName='revenue') gt 2020

📚 ドキュメント

PowerPlatformのMCPヒント機能を使用することで、開発者はエンティティ分析、クエリ最適化、問題診断をより効率的に行うことができます。これらのヒントは開発時間を節約するだけでなく、コードの質とアプリケーションのパフォーマンスも向上させます。