次の方法で共有

JavaScript 用 Azure ConversationAnalysis クライアント ライブラリ - バージョン 1.0.0-beta.1

  • [アーティクル]

このパッケージには、Azure ConversationAnalysis クライアント用の同型 SDK (Node.jsとブラウザーの両方で実行されます) が含まれています。

言語サービス会話 API は、構造化された会話 (テキストまたは音声) の分析に使用できる自然言語処理 (NLP) スキルのスイートです。 このスイートの同期 API は要求を受け入れ、LUIS の一般公開、質問応答、会話Language Understandingなど、複数の言語プロジェクト間で仲介し、要求を処理するために最適な候補サービスを呼び出します。 最後に、候補サービスの応答をペイロードとして含む応答を返します。

場合によっては、この API は呼び出し元とアップストリーム サービスの間で要求と応答を転送する必要があります。 このスイートの非同期 API を使用すると、会話の概要作成や会話 PII 検出などのタスクが可能になります。

主要リンク:

はじめに

現在サポートされている環境

詳細については、Microsoft のサポート ポリシーを参照してください。

前提条件

Azure CLI を使用する場合は、 と <your-resource-name> を独自の一意の名前に置き換えます<your-resource-group-name>。

az cognitiveservices account create --kind ConversationalLanguageUnderstanding --resource-group <your-resource-group-name> --name <your-resource-name> --sku <your-sku-name> --location <your-location>

@azure/ai-language-conversations パッケージのインストール

を使用して、JavaScript 用の Azure ConversationAnalysis クライアント ライブラリを npmインストールします。

npm install @azure/ai-language-conversations

ConversationAnalysisClient を作成して認証する

Language API にアクセスするためのクライアント オブジェクトを作成するには、言語リソースcredentialの と が必要endpointです。 Conversation Analysis クライアントは、API キーの資格情報を使用して認証できます。

言語リソースのエンドポイントは、 Azure Portal または次の Azure CLI スニペットを使用して確認できます。

az cognitiveservices account show --name <your-resource-name> --resource-group <your-resource-group-name> --query "properties.endpoint"

API キーの使用

Azure Portal を使用して言語リソースを参照し、API キーを取得するか、次の Azure CLI スニペットを使用します。

メモ： API キーが "サブスクリプション キー" または "サブスクリプション API キー" と呼ばれる場合があります。

az cognitiveservices account keys list --resource-group <your-resource-group-name> --name <your-resource-name>

API キーとエンドポイントを取得したら、 クラスを AzureKeyCredential 使用して、次のようにクライアントを認証できます。

const { AzureKeyCredential } = require("@azure/core-auth");
const { ConversationAnalysisClient } = require("@azure/ai-language-conversations");

const client = new ConversationAnalysisClient("<endpoint>", new AzureKeyCredential("<API key>"));

JavaScript バンドル

ブラウザーでこのクライアント ライブラリを使用するには、まず bundler を使用する必要があります。 これを行う方法の詳細については、 バンドルに関するドキュメントを参照してください。

主要な概念

ConversationAnalysisClient

ConversationAnalysisClient は、Azure ConversationAnalysis クライアント ライブラリを使用する開発者向けの主要なインターフェイスです。 このクライアント オブジェクトのメソッドを調べて、アクセスできる Azure ConversationAnalysis サービスのさまざまな機能を理解します。

トラブルシューティング

ログの記録

ログの記録を有効にすると、エラーに関する有用な情報を明らかにするのに役立つ場合があります。 HTTP 要求と応答のログを表示するには、環境変数 AZURE_LOG_LEVEL を info に設定します。 または、@azure/logger で setLogLevel を呼び出して、実行時にログ記録を有効にすることもできます。

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

ログを有効にする方法の詳細については、@azure/logger パッケージに関するドキュメントを参照してください。

次のステップ

このライブラリの使用方法の詳細な例については、 サンプル ディレクトリを参照してください。

共同作成

このライブラリに投稿する場合、コードをビルドしてテストする方法の詳細については、投稿ガイドを参照してください。

インプレッション数