Bagikan melalui

Pustaka klien Azure ConversationAnalysis untuk JavaScript - versi 1.0.0-beta.1

Paket ini berisi SDK isomorfik (berjalan baik di Node.js maupun di browser) untuk klien Azure ConversationAnalysis.

API percakapan layanan bahasa adalah serangkaian keterampilan pemrosesan bahasa alami (NLP) yang dapat digunakan untuk menganalisis percakapan terstruktur (tekstual atau lisan). API sinkron dalam rangkaian ini menerima permintaan dan menengahi di antara beberapa proyek bahasa, seperti LUIS Umumnya Tersedia, Jawaban Atas Pertanyaan, Pemahaman Bahasa Percakapan, lalu memanggil layanan kandidat terbaik untuk menangani permintaan. Akhirnya, ia mengembalikan respons dengan respons layanan kandidat sebagai payload.

Dalam beberapa kasus, API ini perlu meneruskan permintaan dan respons antara pemanggil dan layanan upstram. API asinkron dalam rangkaian ini memungkinkan tugas seperti Ringkasan Percakapan dan deteksi PII Percakapan.

Tautan utama:

Memulai

Lingkungan yang didukung saat ini

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prasyarat

Jika Anda menggunakan Azure CLI, ganti <your-resource-group-name> dan <your-resource-name> dengan nama unik Anda sendiri:

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

Pasang paket @azure/ai-language-conversations

Instal pustaka klien Azure ConversationAnalysis untuk JavaScript dengan npm:

npm install @azure/ai-language-conversations

Membuat dan mengautentikasi ConversationAnalysisClient

Untuk membuat objek klien untuk mengakses LANGUAGE API, Anda memerlukan endpoint sumber daya Bahasa dan credential. Klien Analisis Percakapan dapat menggunakan kredensial kunci API untuk mengautentikasi.

Anda dapat menemukan titik akhir untuk sumber daya Bahasa Anda baik di Portal Microsoft Azure atau dengan menggunakan cuplikan Azure CLI di bawah ini:

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

Menggunakan Kunci API

Gunakan Portal Microsoft Azure untuk menelusuri ke sumber daya Bahasa Anda dan mengambil kunci API, atau gunakan cuplikan Azure CLI di bawah ini:

Catatan: Terkadang kunci API disebut sebagai "kunci langganan" atau "kunci API langganan."

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

Setelah Anda memiliki kunci API dan titik akhir, Anda dapat menggunakan AzureKeyCredential kelas untuk mengautentikasi klien sebagai berikut:

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

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

Bundel JavaScript

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukan ini, silakan lihat dokumentasi bundling kami.

Konsep utama

ConversationAnalysisClient

ConversationAnalysisClient adalah antarmuka utama untuk pengembang yang menggunakan pustaka klien Azure ConversationAnalysis. Jelajahi metode pada objek klien ini untuk memahami berbagai fitur layanan Azure ConversationAnalysis yang dapat Anda akses.

Pemecahan Masalah

Pencatatan

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

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

Untuk instruksi lebih rinci tentang cara mengaktifkan log, Anda dapat melihat dokumen paket @azure/pencatat.

Langkah berikutnya

Silakan lihat direktori sampel untuk contoh terperinci tentang cara menggunakan pustaka ini.

Berkontribusi

Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.

Tayangan

  • Last updated on