次の方法で共有

AIClassify、AIExtract、AIReply、AISentiment、AISummarize、AITranslate

  • [アーティクル]

適用対象: キャンバス アプリ

プロパティ

Dataverse にはすぐに使用できるさまざまな AI 関数があり、事前に構成されており、データの収集、構築、トレーニングは必要ありません。 これらの事前構築された AI 関数をアプリやワークフローで使用して、機能の向上やプロセスの合理化を行うことができます。 AI 機能はキャンバス アプリ、AI Builder、およびローコード プラグインで動作するため、ソリューションに簡単に統合できます。

  • AIClassify は、提供されたカテゴリの1つにテキストを分類します。 たとえば、次のカテゴリのリストは、顧客から提出された問題を分類するために使用できます。

    • 問題
    • 請求先
    • 方法
    • ライセンス

  • AIExtract は、登録番号、電話番号、人名などの指定されたエンティティを抽出します。

    注意

    AIExtract 関数はまだ開発中であるため、正しく動作しない場合があります。 この注意は使用できる状態になったら削除されます。

  • AIReply は、提供されたメッセージに対する返信を作成します。 たとえば、関数は、製品に関する顧客のレビューに対する返信の下書きを作成します。

  • AISentiment は、提供されたテキストの感情を検出します。 たとえば、この関すは、顧客レビューのセンチメントが肯定的、否定的、または中立的のいずれかを検出します。

  • AISummarize は、指定したテキストを要約します。 たとえば、この関数はメールのメッセージまたはドキュメントのテキストを要約します。

  • AITranslate は別の言語のテキストを翻訳します。 たとえば、この関数は顧客のメールや製品レビューを翻訳します。 ソース言語を指定する必要はなく、自動的に検出されます。

    ソース言語とターゲット言語でサポートされている言語の詳細については、翻訳者の言語サポート - 翻訳を参照し、自動言語検出列でサポートされる言語のリストを確認してください。

次のビデオで、AI 関数の使用方法の詳細をご確認ください。

前提条件

前提条件の詳細については、「 事前構築済みプロンプトの要件とライセンス」を参照してください。

キャンバス アプリでの使用

これらの関数はキャンバス アプリから呼び出すことができます。 ただし、他の Power Fx ホストで説明されるよりも少し複雑です。

  1. 環境データ ソースを追加する必要があります。
  2. AI 関数は、環境名前空間の関数です。 このドキュメントで AISummarize( ... ) の呼び出しについて説明している箇所では、Environment.AISummarize( ... ) などを使用する必要があります。
  3. 関数への引数は、レコード内の名前付き列である必要があり、唯一の引数として渡されます。 列の名前は構文セクションで指定され、パラメータの名前と一致します。
  4. これらの関数からの戻り値は、常に 1 つの列を含むレコードです。 列の名前は構文セクションにリストされます。
  5. これらの関数は、動作関数で、キャンバス データ フローでは使用できません (たとえば、テキスト コントロールの Text プロパティの入力)。 Set 関数を使用して結果をグローバル変数に配置し、その値をアプリ内の他の場所で使用します。

次に例を示します。

  1. Power Apps Studio で編集するたためにキャンバス アプリを開きます。
  2. データ ウィンドウから、データの追加を選択し、環境データ ソースを追加します。
  3. 挿入ウィンドウからボタン コントロールを追加します。
  4. 数式バーで OnSelect プロパティを選択し、次の数式を入力します。 
    Set( Summary, Environment.AISummarize( {Text: "2, 4, 6, 8, 10, 12, 14, 16"} ).SummarizedText )
  5. 挿入ウィンドウからテキスト コントロールを追加します。
  6. 数式バーで Text プロパティを選択し、次の数式を入力します。 
    Summary
  7. テキスト ボックスに、AI が生成した次のような要約が表示されます。 
    The given text is a sequence of even numbers from 2 to 16, increasing by 2 each time.

注意

現在、他の Power Fx ホストがキャンバスに使用しているのと同じ関数シグネチャを追加する過程にあります。 新しい署名は現在のメカニズムを拡張するものであり、置き換えるものではありません。現在のメカニズムを使用しているアプリは変更せずに引き続き動作します。

構文

AIClassify( テキスト、 カテゴリ )

  • テキスト - 必須。 テキスト文。 分類するテキスト。
  • カテゴリ - 必須。 テキスト カテゴリの単一の列。
  • キャンバス アプリの場合、戻り値は Classification 列にあります。

AIExtract( テキスト、 エンティティ )

  • テキスト - 必須。 テキスト文。 データの抽出元のテキスト。
  • エンティティ - 必須。 抽出するエンティティ。 抽出するエンティティの名前。
  • キャンバス アプリの場合、戻り値は ExtractedData 列にあり、指定されたエンティティに一致する 0 行以上のデータのテーブルです。

AIReply( テキスト )

  • テキスト - 必須。 テキスト文。 応答するテキスト。
  • キャンバス アプリの場合、戻り値は PreparedResponse 列にあります。

AISentiment( テキスト )

  • テキスト - 必須。 センチメントの分析対象テキスト。
  • キャンバス アプリの場合、戻り値は AnalyzedSentiment 列にあり、「Positive」、「Neutral」、または「Negative」です。

AI要約( テキスト )

  • テキスト - 必須。 要約するテキスト。
  • キャンバス アプリの場合、戻り値は SummarizedText 列にあります。

AITranslate(テキスト, ターゲット言語)

  • テキスト - 必須。 翻訳するテキスト。
  • TargetLanguage - 翻訳先の言語タグ (フランス語の場合は「fr」など)。 詳細については、言語関数を参照してください。
  • キャンバス アプリの場合、戻り値は TranslatedText 列にあります。

使用例

設定するには、次の例を参照してください。

  1. ツリー ビューで、App オブジェクトを選択し、Formulas プロパティに次の内容を追加します。 
    Subject = "Washington is a state that offers a variety of food experiences for locals and visitors alike. 
Whether you are looking for fresh seafood, farm-to-table produce, ethnic specialties, or gourmet treats, 
you will find something to satisfy your taste buds in Washington. Washington is famous for its seafood, 
especially salmon, oysters, crab, and clams. The state has a long coastline and numerous rivers and lakes 
that provide abundant and high-quality seafood.";
  2. ボタン コントロールを作成します。
  3. テキスト コントロールを作成し、その Text プロパティを設定します。 
    Result

AIClassify

  1. キャンバス アプリで、ボタン コントロールの OnSelect プロパティを設定します。 
    Set( Result, Environment.AIClassify( {Text:Subject, Categories: ["Housing", "Food"]} ).Classification )
    他のすべての製品に、この数式を使用します。 
    Set( Result, AIClassify( Subject, ["Housing", "Food"] ) )
  2. ボタンを押します。 テキスト コントロールは結果を表示します。 
    Food

AIExtract

  1. キャンバス アプリで、ボタン コントロールの OnSelect プロパティを設定します。 
    Set( Result, Environment.AIExtract( {Text:Subject, Entity: "State"} ).ExtractedText )
    他のすべての製品に、この数式を使用します。 
    Set( Result, AIExtract( Subject, "State" ) )
  2. ボタンを押します。 テキスト コントロールは結果を表示します。

AIReply

  1. キャンバス アプリで、ボタン コントロールの OnSelect プロパティを設定します。 
    Set( Result, Environment.AIReply( {Text:Subject} ).PreparedResponse )
    他のすべての製品に、この数式を使用します。 
    Set( Result, AIReply( Subject ) )
  2. ボタンを押します。 テキスト コントロールは次のような結果を表示します。 
    Washington state is indeed a culinary delight, offering a diverse range of food experiences
for both residents and tourists. From fresh seafood to farm-to-table produce, ethnic specialties
to gourmet treats, there is something to please every palate in Washington. The state is
particularly renowned for its seafood, with salmon, oysters, crab, and clams being local favorites.
This is due to Washington's extensive coastline and numerous rivers and lakes, which provide an
abundance of high-quality seafood. If you have any specific questions or need recommendations
for dining in Washington, feel free to ask!

AISummarize

  1. キャンバス アプリで、ボタン コントロールの OnSelect プロパティを設定します。 
    Set( Result, Environment.AISummarize( {Text:Subject} ).SummarizedText )
    他のすべての製品に、この数式を使用します。 
    Set( Result, AISummarize( Subject ) )
  2. ボタンを押します。 テキスト コントロールは次のような結果を表示します。 
    Washington state is known for its diverse food experiences, catering to both locals and visitors.
From fresh seafood to farm-to-table produce, ethnic specialties, and gourmet treats, there is
something to please everyone's taste buds. Seafood, particularly salmon, oysters, crab, and clams,
is a highlight in Washington. With its extensive coastline, rivers, and lakes, the state offers
an abundance of high-quality seafood options.

AISentiment

  1. キャンバス アプリで、ボタン コントロールの OnSelect プロパティを設定します。 
    Set( Result, Environment.AISentiment( {Text:Subject} ).AnalyzedSentiment )
    他のすべての製品に、この数式を使用します。 
    Set( Result, AISentiment( Subject ) )
  2. ボタンを押します。 テキスト コントロールは結果を表示します。 
    Positive

AITranslate

  1. キャンバス アプリで、ボタン コントロールの OnSelect プロパティを設定します。 
    Set( Result, Environment.AITranslate( {Text:Subject, Language: "fr"} ).TranslatedText )
    他のすべての製品に、この数式を使用します。 
    Set( Result, AITranslate( Subject, "fr" ) )
  2. ボタンを押します。 テキスト コントロールは次のような結果を表示します。 
    Washington est un État qui offre une variété d’expériences culinaires pour les habitants et les visiteurs. 
Que vous soyez à la recherche de fruits de mer frais, de produits de la ferme à la table,
de spécialités ethniques ou de friandises gastronomiques, vous trouverez de quoi satisfaire vos
papilles à Washington. Washington est célèbre pour ses fruits de mer, en particulier le saumon, les huîtres,
le crabe et les palourdes. L’État possède un long littoral et de nombreuses rivières et lacs 
qui fournissent des fruits de mer abondants et de haute qualité.