財務および操作のビジネスロジックを使用した3つのプラグインを作成する (プレビュー)

[アーティクル]
12/11/2024

この記事はプレリリースであり、変更される可能性があります。

財務と運用アプリ、コパイロットの機能を拡張するために、 Microsoft Copilot Studio これらのプラグインは、アプリケーション内Copilotに追加できます財務と運用アプリ、その他のMicrosoftこれらのプラグインは、カスタムMicrosoftに追加できます。

作成したプラグインは、Microsoft製品全体で使用する財務および操作のビジネスロジックを使用できます。プラグインが作成され、X++ に配置されると、自動的に新しいプラグイン Dataverse に登録されます。これにより、レジストリに関連付けらた大きなオブジェクトでこれらのファイルを使用できます。 Copilotユーザーは自然言語で起動し、財務および運用コードベースのビジネスロジックに基づくコパイロット応答を受け取る必要があります。

これらのプラグインは、頭のない操作です。財務およびオペレーションクライアントでは特定のコンテキストを必要としないのが一方です。 (headlessプラグインとクライアントプラグインの説明、およびそれらを間の違いの説明を参照してくださいプラグインのコンテキスト.)

たとえば、現在のフィールドの財務と運用アプリ顧客残高の計算が行い、入力パラメータと出力パラメータが指定されます。顧客の残高に関する情報は、顧客と顧客の残高のコンテキストの外部にも財務と運用アプリ。また、チームの例やOutlookの電子メールメッセージなど、他の自然言語コンテキストにも意味があります。この記事で説明する機能を使用すると、顧客残高計算をコパイロットプラグインとしてパッケージ化し、コパイロット製品全体でMicrosoftできます。その後、ユーザーはCopilot操作経験から、簡単に自然なCopilotを実行できます。

財務と運用アプリのプラグインには多くのシナリオと機会コパイロット提供します。次の表にいくつか例を示します。

操作タイプ	ユーザープロンプトの例
返品計算値	「顧客Fabrikamの現在の残高は何か。
レポート内のレコードを作成、更新、または財務と運用アプリ	"#タスクでタスクを設定追従するするContosoを次の月曜日の期日に設定する新しいプロジェクトを作成します。
アクションの実行	"後入りを許可する経費精算書を承認する"。

重要

この機能はプレビュー機能です。これには、プレビュー補足利用規約が適用されます。プレビュー機能は、運用上の用途のためのものではなく、機能が制限されている場合があります。これらの機能は、顧客が早期にアクセスしてフィードバックを提供できるよう、公式リリース前に利用できます。プレビューリリースの詳細については、1 つのバージョンのサービス更新に関するよく寄せられる質問を参照してください。

前提条件

財務および操作のビジネスロジックを使用する、

統合開発者環境が必要です。財務および操作のビジネスロジックを使用する、財務と運用アプリの統合管理者エクスペリエンスから統合開発者環境を作成する方法の詳細については、チュートリアル: 財務と運用プロビジョニングアプリをインストールするを参照してください。
この環境、プラットフォームバージョン7.0.7279.80以降で、バージョン10.0.40のプロアクティブ品質更新プログラム1 (PQU-1) が必要です。
次のソリューションは、データベースにインストールする Power Platform 環境。まだインストールしていない場合は、「管理Dynamics 365アプリケーション Dynamics 365ソリューションパッケージをインストールする方法の詳細を参照してください Dataverse。
- 財務およびCopilot用のCopilotパッケージ。このパッケージには次のソリューションが含まれています。
  - 財務と運用アプリの Copilot
  - 財務と運用の Copilot の生成ソリューション
  - 財務と運用の Copilot のアンカーソリューション
- 財務および操作仮想エンティティ
Feature (プレビュー) カスタムAPI生成 機能を有効にする必要必要。

プラグインの精度と操作

Copilotに登録されているプラグインの Dataverse プラグインは、1対多の操作を行えます。プラグインにアクセスできるユーザーには、そのプラグインのすべての操作または機能に対するセキュリティアクセス権が必要です。たとえば財務と運用アプリ、プラグインの操作はセキュリティロールに基づいてプラグインにグループ化されます。この方法により、ロール別に運用に適切なアクセス権が確保されます。

たとえば、次のプラグイン操作を作成します。各操作は、適切なセキュリティロールに関連付けられた特権に割り当てられます。その後、定義された操作を使用して Dataverse プラグインレジストリでプラグインが作成または更新されます。

プラグイン (セキュリティロール)	プラグインの操作
コレクションマネージャ	顧客残高の取得争議請求書請求書の書き落とし
コレクションエージェント	顧客残高の取得争議請求書
販売アソシエイト	顧客残高の取得与信限度額の引き上げ在庫の確認
在庫マネージャ	在庫の確認調節モード棚卸在庫再注文

プラグインの操作は、その操作のアクションメニュー項目に対する特権を持つセキュリティロールに基づいて、複数のプラグインに追加できます。

2つの機能を含む、高い機能を持つ、高い機能を持つ財務と運用アプリ

プロジェクト用の財務と運用アプリの開発には、次の3つの主要なコンポーネントがあります。

メソッドは X++ で作成する必要があります。 Copilot Studio は、このメソッドを呼び出します。定義したアプリケーションコードを実行し、関数応答Copilot。 Copilot、ユーザー応答言語に翻訳されます。
プラグインは、関連付けられているカスタムAPI Dataverse 作成する必要があります。この方法で、複数のフィールドに Copilot Studio。
プラグインの操作は、選択した #プロジェクトのアクションとして追加する必要コパイロット。

プラグインのアーキテクチャと実行の詳細については、財務と運用の Copilot のアーキテクチャを参照してください。

X++ のプラグイン操作の定義

X++ では、呼び出され、プラグインをインストールする際に Copilot Studio を実行できるクラスを作成する必要があります。

AIプラグイン

新しいクラスは、何も指定したを使用して、そのクラスを何も変更して、そのクラスを何の年も前のモデルに変更する必要があります。 AIPluginOperationAttribute この属性でカスタマイズされたクラスは、プラグイン登録サービス Dataverse カスタマイズAPIの Dataverse 登録されます。その結果、プラグインの操作のレコードが、機能と AIPlugin で AIPluginOperation 作成されます Dataverse。

データ契約

この方法をデータ契約として定義するには DataContract に変更する必要があります。複雑なデータ型をメソッドの入力パラメータと出力パラメータとして渡すので、パラメータのシリアル化と逆シリアル化は、通信に必要ありません Copilot Studio。 X++ でデータコントラクトを実装する方法の詳細については、X++ でのデータコントラクトの使用を参照してください。

カスタム API

新しいクラスは、a/& Dataverse APIの定義を作成します。このカスタムAPIは、同期プロセス Dataverse で作成され、クラスに関連付けされます。プラグインが呼び出されると Copilot StudioカスタムAPIが呼び出され、クラスのロジックが呼び出されます。

新しいクラスは、クラスクラス ICustomAPI する必要があります。また、新しいクラスをクラスクラスで CustomAPIAttribute があります。この方法で、クラスは、それが呼び出し可能なカスタムAPIを示す属性を取得します Dataverse。

パラメーター

パラメーター	型	Description
カスタムAPI名	文字列	アクションの自然言語名。
CustomAPIDescription	文字列	アクションの実行方法の自然な言語定義。 Copilot Studio は、この定義をプラグインのオーケストレーションに使用して、ユーザーの確認に基づいてプラグインが呼び出される場合を決定します。

要求パラメーター

要求パラメータは、APIのアクションを説明します。アクションのしおりは、Copilotおよび財務およびオペレーションランタイムから値を渡するために使用されます。クラスでは、APIのカスタムAPI CustomAPIRequestParameter を定義するために使用する必要があります。

パラメーター	型	Description
description	文字列	パラメータの自然言語の説明。 Copilot Studio では、この説明を使用して、ユーザーのプロンプトのテキストをパラメータと一致します。
はオプションです。	ブール型	A /パラメータカスタムAPIの要求時に値を定義する必要であるかどうかを示すfalse値。アクションが呼び出される際にこのパラメータがオプションの場合は、このパラメータを。選択していない場合は、ファイル名に設定。

また、変数を取得および設定するには、各パラメータに異なる方法を定義する必要があります。次の例では、要求パラメータの accountNumber 示します。パラメータ名は、データ契約のデータメンバとして定義されます。

[CustomAPIRequestParameter('The customer account number', true),
    DataMember('accountNumber')]
    public CustAccount parmAccountNum(CustAccount _accountNum = accountNum)
    {
        accountNum = _accountNum;
        return accountNum;
    }

応答のプロパティ

カスタムAPI CustomAPIResponseProperty 使用して応答プロパティを定義します。

パラメーター	型	Description
description	文字列	プロパティの自然言語応答説明。

プロパティで変数を取得および設定するには、一連の方法も定義する必要があります。次の例では、アクション balance 応答プロパティの定義を示します。

[CustomAPIResponseProperty('The current customer account balance'),
    DataMember('balance')]
    public AmountCur parmBalance(AmountCur _balance = balance)
    {
        balance = _balance;
        return balance;
    }

操作の定義

新しい run を使用して ICustomAPI を呼び出す際に実行されるコードを定義します。このコードは、何が何を実行して何を実行して何を行うのか、を定義するビジネスロジックです。このメソッドでは、操作が完了応答返されるプロパティの値 Copilot Studio 設定します。

プラグインのセキュリティの定義

各プラグイン操作は、Copilotから操作を実行するためのユーザーアクセス権を付与するセキュリティロールに割り当てる必要Copilot。レコード財務と運用アプリと AIPlugin AIPluginOperation レコード Dataverseを同期化すると、操作が割り当てられているセキュリティロールに基づいてレコードがグループ化されます。操作が生成されます ( Dataverse セキュリティロールに割り当てられている場合はオンになります)。

各クラスについて、次追従する説明します。

開発 Visual Studioで、アクションメニュー項目を作成します。クラスの名前に似た名前を付してください。
新しいアクションメニュー項目に対して次のプロパティを設定します。
- # 値ObjectType またはクラス設定。
- クラスのにを設定します。
メニュー項目をセキュリティロール特権に追加します。

メモ

クラスのメニュー項目は、セキュリティロールに割り当てる必要があります。それ以外の場合は、カスタムAPI、AIプラグイン、およびAIプラグインの操作レコードが1つで作成 Dataverse。

新しいクラスをインスタンスに配置した環境、新しいクラスを呼び出す前に拡張機能キャッシュがフラッシュされるのを確認する必要があります。これは、完了同期の一部として、またはユーザーグループで SysFlushAOD クラスを実行することで環境。この操作は、使用しているURLにクラスリンクを追加環境できます。

https://<environment>.operations.dynamics.com/?cmp=usmf&mi=SysClassRunner&cls=SysFlushAOD

Copilotのプラグインの生成

X++ で定義し、財務およびオペレーション環境に配置した操作を実行した後、カスタムAPIを生成しAIプラグイン必要 Dataverse。このAIプラグインは、レジストリに Dataverse 対して追加された後、アクションとして大グループに追加できます。プラグインは、X++ で定義されたコードを実行するカスタムAPIを呼び出す構成です。

カスタムAPIとカスタムAPIを生成AIプラグイン手順追従する説明します。

新しいX++ 財務と運用アプリ配置したクライアント用環境クライアントを開きます。
[同期 Dataverse ユーザーAPI ページ (システム管理>Setup>同期 Dataverse ユーザーAPI) を開きます。選択した操作でメニューナビゲーションを使用できない環境、選択したURLにメニューパラメータを追加して mi=CustomApiTable に移動環境できます。次に例を示します:

https://<environment>.operations.dynamics.com/?cmp=USMF&mi=CustomApiTable
リストページで、クラスがプログラムの一覧に含グリッド。このセクショングリッド、次の基準を満たすすべてのクラスが含まれます。
- これは、新しい ICustomApi 実装します。
- このフィールドには [CustomApi] 属性が含まれます。
- このメニューには、関税/役割に割り当てられるセキュリティ特権に含まれるアクションメニュー項目があります。
選択を選択同期アクション。

同期プロセスでは、一覧表示されているクラスはすべて Dataverse と同期され、それらを Dynamics 365 ERP仮想エンティティ します。クラスが作成され、 Custom API リスト内のソリューションに、関連付けられている要求パラメータおよびプロパティと共にソリューションに追加応答できます。

同じサービスグループを含む各 [AIPluginOperationAttribute] に対して、同じソリューションでレコードAIプラグインレコードが作成されます。レコード AIPlugin 、データベースで構成された各セキュリティロールに対して作成財務と運用アプリ。このレコードには、割り当てられたクラスに [AIPluginOperationAttribute] 属性が含まれます。関連付けられている AIPluginOperaton はプラグインにリンクされます。

#プロジェクトにアクションを追加コパイロット

プラグインのレジストリに一覧表示されている各操作について、レジストリに接続されている任意のコパイロットにアクションを追加 Copilot Studio。たとえば、アクションをCopilotまたはカスタム財務と運用アプリに追加できます。

メモ

現在、Microsoftなど、一部のMicrosoftにプラグインを追加Copilot追加 Microsoft 365。

これらの手順を実行して、アプリケーション内の財務と運用アプリで使用する、またはカスタムコパイロットに、追従するを追加します。

次 Copilot Studio、プラグインコパイロット追加する場所のコパイロットを開きます。
アクション ページで 、選択 を追加します。
[検索 ] フィールド 、ユーザーの作業の名前AIプラグインします。選択を開く。
追従するウィザードの手順を選択します。選択APIの接続と出力を変更します。
完了を選択します。

コパイロットにアクションを追加する方法の詳細については、「<コパイロット/& (カスタム Copilot Studio (プレビュー)でアクションを使用する」を参照。

アクションを呼び出コパイロットコパイロットを構成します。

新しいコパイロット追加したコパイロットで、コパイロットオーケストレーションの一部としてアクションを呼び出す必要がある場合に、そのアクションを呼び出す必要コパイロットがあります。コパイロットで、ユーザーの入力したメッセージを操作または一連のアクションに対応付けることができます。コパイロットを有効にして、コパイロットオーケストレーションにアクションを含めるには次の2コパイロットがあります。

コパイロットで、アクションをトピックするアクションを作成します。
コパイロットを有効にして、コパイロットアクションにコパイロット調整します。

#トピックでプロジェクトを作成コパイロット

コパイロットで既定のデザインモードが使用される場合、コパイロットは、ユーザーのプロンプトに最も近いトピック語句を含むトリガーをトリガしてユーザーに応答します。次に、対話のコンテキストトピック説明に入力されます。コパイロットがモードされていないことを確認するには、選択 大分類 オプション)、#で、コパイロットの応答方法 機能をコパイロット 設定の中で選択します タブを指定します。

コパイロットでコマンドモードが有効になっている場合は、#トピックに追加されたアクションを呼び出す別のアクションコパイロット。

[</&コパイロット。 Copilot Studio
その後の、" tab" 選択 "選択"空白" トピック>を追加。
アクションの トリガー で、アクショントリガーする必要があるユーザープロンプトのタイプを提供するために、語句トリガー編集します。
アクションの プラグインアクション にフィールドトピックを追加します。
1. 選択 ノード (+)を追加。
2. 選択 分類するアクション>Plugin (プレビュー)、。
3. 選択のアクションを選択します。
4. 変更したトピック保存し、変更を #レポートに発行コパイロット。

詳細については、「アクションアクションを呼び出す」をトピック。

生成的な何かのトピックとアクションにコパイロットを調整する

コパイロットで生成モードを有効にした場合 Copilot Studio 生成する

コパイロットで生成モードが有効になっている場合は、アクションを呼び出す別のトピック作成する必要はありません。生成モードの詳細については、「 ORchestrateコパイロットのトピックおよび生成可能なプレビューを含むアクション」を参照してください。

重要

生成モードは現在現在有効プレビュー。財務および運用のビジネスロジックを使用する、高いレベルのアクションを含むカスタムのコマンドに対してこのモードをテストすることもできます。 Copilotで現在サポートされていない生成モード財務と運用アプリ。ただし、機能ベンチマークと品質ベンチマークが検証Copilot、将来のリリース財務と運用アプリの場合は、既定で #財務と運用アプリでサポートおよび有効にする必要があります。

次の方法で共有

財務および操作のビジネスロジックを使用した3つのプラグインを作成する (プレビュー)

前提条件

プラグインの精度と操作

2つの機能を含む、高い機能を持つ、高い機能を持つ財務と運用アプリ

X++ のプラグイン操作の定義

AIプラグイン

データ契約

カスタム API

パラメーター

要求パラメーター

応答のプロパティ

操作の定義

プラグインのセキュリティの定義

Copilotのプラグインの生成

#プロジェクトにアクションを追加コパイロット

アクションを呼び出コパイロットコパイロットを構成します。

#トピックでプロジェクトを作成コパイロット

生成的な何かのトピックとアクションにコパイロットを調整する

フィードバック

その他のリソース

次の方法で共有

財務および操作のビジネス ロジックを使用した3つのプラグインを作成する (プレビュー)

前提条件

プラグインの精度と操作

2つの機能を含む、高い機能を持つ、高い機能を持つ財務と運用アプリ

X++ のプラグイン操作の定義

AIプラグイン

データ契約

カスタム API

パラメーター

要求パラメーター

応答のプロパティ

操作の定義

プラグインのセキュリティの定義

Copilotのプラグインの生成

#プロジェクトにアクションを追加コパイロット

アクションを呼び出コパイロット コパイロットを構成します。

#トピックでプロジェクトを作成コパイロット

生成的な何かのトピックとアクションにコパイロットを調整する

フィードバック

その他のリソース

財務および操作のビジネスロジックを使用した3つのプラグインを作成する (プレビュー)

アクションを呼び出コパイロットコパイロットを構成します。