Microsoft のコグニティブ アクション

Azure Cognitive Services を使用すると、機械学習の専門知識がなくても、人工知能を使用して意思決定を加速できます。

重要

Azure では、Azure Cognitive Services Text Analytics v2.x を 2024 年 2 月 29 日 に廃止します。 ライブラリは、Microsoft Cognitive Text Analytics アクション が使用します。 2024 年 2 月 29 日以降、これらのアクションはデスクトップ フローでサポートされなくなり、操作できなくなります。

デスクトップ フローが提供するさまざまな Microsoft Cognitive アクションを利用すると、この機能をデスクトップ フローに統合できます。 Microsoft Cognitive アクションでは、テキスト分析、コンピューター ビジョン、スペル チェックのタスクを実行できます。

すべての Microsoft コグニティブ アクションには、サービスまたはサービス グループのサブスクリプションを検証するサブスクリプション キーが必要です。 キーは、作成した各リソースの Azure ポータルで確認できます。

スペル チェック アクションのスクリーンショット。

スペル チェック

「Bing Spell Check」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
Text いいえ テキスト値リスト 送信するテキストまたはテキストのリストです
Mode はい テキスト値 スペル チェック モードを指定します
Mkt はい テキスト値 プルーフ モードは、次の言語コードのみに対応しています: en-us、es-es、pt-br。 スペル モードでは、すべての言語コードに対応しています
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します

画像を分析します

「Analyze Image」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サーバーの場所 N/A 米国西部、米国西部 2、米国東部、米国東部 2、米国中西部、米国中南部、西ヨーロッパ、北ヨーロッパ、東南アジア、東アジア、オーストラリア東部、ブラジル南部、カナダ中部、 インド中部、英国南部、東日本 米国西部 この API 呼び出しに使用するサーバーの場所です
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
イメージの提示 N/A ファイルから、GCS から ファイルから 画像をフル パスで提供するか、URL アドレスで提供するかを指定します
画像ファイル いいえ ファイル 送信する画像ファイルの完全なパス (フォルダー名とファイル名) です
画像 URL いいえ テキスト値 画像の URL アドレスです
ビジュアル機能 はい テキスト値 返される視覚的特徴の種類を示すテキスト値です。 複数の値は、コンマで区切る必要があります。 例: categories, tags, description
Details はい テキスト値 返されるドメイン固有の詳細を示すテキスト値です。 複数の値は、コンマで区切る必要があります
Language はい テキスト値 返される言語を示すテキスト値です。 サービスは、指定された言語で認識結果を返します
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します

イメージの説明

「Describe Image」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サーバーの場所 N/A 米国西部、米国西部 2、米国東部、米国東部 2、米国中西部、米国中南部、西ヨーロッパ、北ヨーロッパ、東南アジア、東アジア、オーストラリア東部、ブラジル南部、カナダ中部、 インド中部、英国南部、東日本 米国西部 この API 呼び出しに使用するサーバーの場所です
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
イメージの提示 N/A ファイルから、GCS から ファイルから 画像をフル パスで提供するか、URL アドレスで提供するかを指定します
画像ファイル いいえ ファイル 送信する画像ファイルの完全なパス (フォルダー名とファイル名) です
画像 URL いいえ テキスト値 画像の URL アドレスです
最大候補者数 はい テキスト値 返される候補の記述の最大数です。 既定値は 1 です
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します

OCR

「OCR」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サーバーの場所 N/A 米国西部、米国西部 2、米国東部、米国東部 2、米国中西部、米国中南部、西ヨーロッパ、北ヨーロッパ、東南アジア、東アジア、オーストラリア東部、ブラジル南部、カナダ中部、 インド中部、英国南部、東日本 米国西部 この API 呼び出しに使用するサーバーの場所です
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
イメージの提示 N/A ファイルから、GCS から ファイルから 画像をフル パスで提供するか、URL アドレスで提供するかを指定します
画像ファイル いいえ ファイル 送信する画像ファイルの完全なパス (フォルダー名とファイル名) です
画像 URL いいえ テキスト値 画像の URL アドレスです
Language はい テキスト値 画像内で検出するテキストの BCP-47 言語コードです
向きの検出 はい テキスト値 画像のテキストの向きを検出するかどうかを指定します
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します

イメージをタグ付けする

「Tag Image」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サーバーの場所 N/A 米国西部、米国西部 2、米国東部、米国東部 2、米国中西部、米国中南部、西ヨーロッパ、北ヨーロッパ、東南アジア、東アジア、オーストラリア東部、ブラジル南部、カナダ中部、 インド中部、英国南部、東日本 米国西部 この API 呼び出しに使用するサーバーの場所です
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
イメージの提示 N/A ファイルから、GCS から ファイルから 画像をフル パスで提供するか、URL アドレスで提供するかを指定します
画像ファイル いいえ ファイル 送信する画像ファイルの完全なパス (フォルダー名とファイル名) です
画像 URL いいえ テキスト値 画像の URL アドレスです
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します

言語を検出

「Text Analytics - Detect Language」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サーバーの場所 N/A 米国西部、米国西部 2、米国東部、米国東部 2、米国中西部、米国中南部、西ヨーロッパ、北ヨーロッパ、東南アジア、東アジア、オーストラリア東部、ブラジル南部、カナダ中部、 インド中部、英国南部、東日本 米国西部 この API 呼び出しに使用するサーバーの場所です
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
Text いいえ テキスト値 分析するテキストです
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します

キー フレーズ

「Text Analytics - Key Phrases」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サーバーの場所 N/A 米国西部、米国西部 2、米国東部、米国東部 2、米国中西部、米国中南部、西ヨーロッパ、北ヨーロッパ、東南アジア、東アジア、オーストラリア東部、ブラジル南部、カナダ中部、 インド中部、英国南部、東日本 米国西部 この API 呼び出しに使用するサーバーの場所です
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
Text いいえ テキスト値リスト 分析するテキストまたはテキストのリストです
Language はい テキスト値 テキストの言語です
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します

センチメント

「Text Analytics - Sentiment」という名前の Microsoft Cognitive サービスを呼び出します。

入力パラメーター

引数 オプション 受入 既定の値 説明設定
サーバーの場所 N/A 米国西部、米国西部 2、米国東部、米国東部 2、米国中西部、米国中南部、西ヨーロッパ、北ヨーロッパ、東南アジア、東アジア、オーストラリア東部、ブラジル南部、カナダ中部、 インド中部、英国南部、東日本 米国西部 この API 呼び出しに使用するサーバーの場所です
サブスクリプション キー いいえ テキスト値 この API 呼び出しに使用するサブスクリプション キーです
Text いいえ テキスト値リスト テキスト
Language はい テキスト値 テキストの言語を表す ISO 639-1 の 2 文字
Timeout はい 数値 30 エージェントがサーバーとの接続が確立するまで待機する時間 (秒) です。この時間を経過すると、接続は失敗します

生成された変数

引数 Type 説明設定
JSONResponse カスタム オブジェクト API 応答の結果です
StatusCode 数値 返された状態コードです

例外

例外 内容
要求がタイムアウトしました 要求の実行中にタイムアウトが発生したことを示します
Cognitive Services を呼び出すことができませんでした Cognitive Services の呼び出し中に問題が発生したことを示します