Skip to main content

 

 

 

 

Template:OutSystems/Documentation_KB/Breadcrumb_New_Layout

 

 

Template:OutSystems/OSLanguageSwitcher

 

 

 

OutSystems

OutSystemsアプリケーションでOutSystems.AI Languages Analysisコンポーネントを使用する

OutSystems.AI Language Analysisコンポーネントを使用すると、キーフレーズ検出、感情分析、言語検出といった様々なテキスト分析操作を実行できます。

また、このコンポーネントには互いに依存しないWebブロックとサーバーアクションが含まれます。Webブロック内にあるデフォルトのUIを、機能で利用することができます。また、特定のUIでロジック内のサーバーアクションを使用することもできます。

利用可能なWebブロックを使用する場合、そのブロック向けに追加ロジックを作成する必要はありません。Webブロックには、必要な操作を実行するためのロジックがすでに関連付けられているためです。ロジックフロー内でサーバーアクションを個別に使用する場合、Webブロックを併用する必要はありません。

前提条件:

  1. Microsoft Azureアカウントを作成します。

  2. テキスト分析サービス、Bingスペルチェック音声テキスト変換用のリソースを作成します。それぞれのフィールドで各リソースを作成するとき、これらをすべて同じリソースグループでグループ化するようにしてください(既存のグループでも新しいグループでも構いません)。

  3. OutSystems.AI Language Analysisとその依存関係をForgeからダウンロードし、環境にパブリッシュします。

  4. Service Centerで、コンポーネントの依存関係に移動し、AzureCognitiveServicesConnectorをクリックして[Site Properties]タブにアクセスし、OcpApimSubscriptionKey_TextAnalyticsAPIOcpApimSubscriptionKey_SpellCheckAPIOcpApimSubscriptionKey_SpeechAPIにサブスクリプションキーを入力します。これらのキーは、手順2で作成した各リソースのAzure Portalの[キー]タブで確認できます。各リソースのタブに表示される2つのキーのどちらでも使用できます。

  5. 引き続きService Centerで、AzureCognitiveServicesConnectorプロパティの[Integrations]タブに切り替え、TextAnalyticsAPISpellCheckAPISpeechAPIの[Effective URL]フィールドにエンドポイントの情報をそれぞれ入力します。これらの情報は、手順2で作成した各リソースのAzure Portalの[概要]タブで確認できます。保存する前に、貼り付けたエンドポイントのバージョン番号(例: /v2.1)を削除します。

キーフレーズ検出

KeyPhrasesHighlight Webブロックを画面にドラッグ&ドロップし、2つの必須の入力パラメータを入力します。

  • Text – キーフレーズ検出で分析するテキスト
  • Language – ISO 639-1標準の言語コードに従った、言語を表す2文字のコード

検出の結果は、検出されたキーフレーズのスタイルを背景色が黄色の太字に変更することによって示されます。GetKeyPhrasesInTextアクションは、Azure Cognitive Services Connectorのテキスト分析API KeyPhrasesアクションを使用してテキストを分析します。

このサーバーアクションを使用するには、GetKeyPhrasesInTextをフローにドラッグして入力パラメータに入力をします。

感情分析

  1. SentimentDetection Webブロックを画面にドラッグ&ドロップします。このWebブロックには3つのプレースホルダと、感情検出を実行するアクション(DetectSentimentInTextサーバーアクション)が含まれます。

  2. これらのプレースホルダを(アイコンや画像などを使用して)カスタマイズし、テキストの感情検出の結果を表示します。

各プレースホルダは、次のような0%~100%の間隔尺度に関連付けられています。

  • ネガティブ: 0% – 39%
  • 中立: 40% – 69%
  • ポジティブ: 70% – 100%

パーセンテージは検出された感情のスコアを示し、テキストの感情が間隔尺度のどの位置にあるかを示します。デフォルトでは、以下の絵文字がテキストの感情を示します。

DetectSentimentInTextサーバーアクションには、Webブロックと同じ入力パラメータが必要です。これは、テキストから検出された感情のスコアを表すDecimal値を返します。間隔尺度はユースケースに応じて変更することができます。

言語検出

GetLanguageFromTextサーバーアクションはテキストを入力パラメータとして受け取り、そのテキストで検出された言語コードを取得します。返されるコードはISO 639-1標準に従った2文字のコードです。

スペルチェック

スペルチェック機能にはWebブロックとサーバーアクションが含まれます。

  1. SpellCheck Webブロックをアプリケーションの画面にドラッグします。
  2. TextAreaプレースホルダで、Inputウィジェットをドラッグして変数にバインドします。

SpellCheck Webブロックには、テキストを分析し、検出されたエラーに対する提案を取得するサーバー側のロジックが含まれます。また、エラーを強調表示し、エンドユーザーが対応方法を選択できるようにするクライアント側のロジックも含まれます。

エンドユーザーは提案を選択することも、無視することもできます。同じエラーが繰り返されている場合、エンドユーザーが提案を無視すると、それ以降、その用語は強調表示されなくなります。

また、Webブロックを使用せずにRunSpellCheckerサーバーアクションをそのまま使用することもできます。サーバーアクションをロジックフローにドラッグし、必須の入力パラメータに入力をします。出力ストラクチャを受け取った後に、フローに追加ロジックを追加できます。

音声テキスト変換

音声テキスト変換機能は音声ファイルを受け取り、その入力を文字起こししたものを出力します。この機能にはSpeechToTextサーバーアクションが含まれます。このサーバーアクションは、以下の入力パラメータを受け取ります。

  • Audio File - 文字起こしの対象となるファイル。URLまたはバイナリファイルを指定できます。ファイルの内容は短い発話である必要があります(具体的には、音声ファイル全体の長さが15秒未満、かつ実際の録音内容が10秒のみである必要があります)。

  • Audio Format - 送信されるファイルの形式。バイナリファイルの場合、この入力パラメータが必須です。サポートされる音声形式はWAVおよびOGGです。

  • Language Code - 音声ファイルの言語。サポートされる言語コードのリストをご覧ください。

  • Profanity - 変換結果内の卑猥な言葉の処理方法を指定する条件。使用可能な値は、卑猥な言葉をアスタリスクに置き換えるmasked、卑猥な言葉を変換結果からすべて削除するremoved、卑猥な言葉を変換結果に含めるrawです。デフォルト設定はmaskedです。

SpeechToTextサーバーアクションの出力パラメータは、信頼スコアが最も高い変換結果を文字起こししたものとなります。

例外処理

UI Webブロックのアクション中に発生しうる例外は、例外発生時にフィードバックメッセージを表示することにより直接処理されます。そのため、コンポーネント内のサーバーアクションで発生した例外は、すべて処理する必要があります。

  • Was this article helpful?