Azure ConversationAnalysis ügyfélkódtár JavaScripthez – 1.0.0-beta.1-es verzió

Ez a csomag egy izomorf SDK-t tartalmaz (Node.js és böngészőkben egyaránt fut) az Azure ConversationAnalysis-ügyfélhez.

A language service conversations API egy természetes nyelvfeldolgozási (NLP) készségekből álló csomag, amely strukturált (szöveges vagy beszélt) beszélgetések elemzéséhez használható. A csomag szinkron API-ja fogad egy kérést, és közvetít több nyelvi projekt között, például a LUIS Általánosan elérhető, a Kérdés megválaszolása, a Beszélgetési Language Understanding, majd meghívja a legjobb jelölt szolgáltatást a kérés kezeléséhez. Végül egy választ ad vissza, amely a jelölt szolgáltatás válaszát hasznos adatként adja vissza.

Bizonyos esetekben ennek az API-nak továbbítania kell a kéréseket és a válaszokat a hívó és egy felsőbb rétegbeli szolgáltatás között. Az ebben a csomagban található aszinkron API-k olyan feladatokat tesznek lehetővé, mint a Beszélgetések összegzése és a Beszélgetési PII észlelése.

Fő hivatkozások:

• Forráskód
• Csomag (NPM)
• API-referenciadokumentáció
• Termékdokumentáció
• Példák

Első lépések

Jelenleg támogatott környezetek

• A Node.jsLTS-verziói
• A Safari, a Chrome, az Edge és a Firefox legújabb verziói.

További részletekért tekintse meg támogatási szabályzatunkat .

Előfeltételek

• Egy Azure-előfizetés.
• Meglévő [Cognitive Services][cognitive_resource] vagy Nyelvi erőforrás. Ha létre kell hoznia az erőforrást, használhatja az Azure Portalt vagy az Azure CLI-t.

Ha az Azure CLI-t használja, cserélje le <your-resource-group-name> a és <your-resource-name> a nevet a saját egyedi nevére:

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

Telepítse a(z) @azure/ai-language-conversations csomagot

Telepítse a JavaScripthez készült Azure ConversationAnalysis ügyfélkódtárat a következővel npm:

npm install @azure/ai-language-conversations

Hozzon létre és hitelesítsen egy ConversationAnalysisClient

Ahhoz, hogy létrehozhasson egy ügyfélobjektumot a Language API eléréséhez, szüksége lesz a endpoint Language erőforrásra és egy credential. A beszélgetéselemzési ügyfél api-kulcs hitelesítő adatait használhatja a hitelesítéshez.

A nyelvi erőforrás végpontját az Azure Portalon vagy az alábbi Azure CLI-kódrészlet használatával találja meg:

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

API-kulcs használata

Az Azure Portalon keresse meg a nyelvi erőforrást, és kérjen le egy API-kulcsot, vagy használja az alábbi Azure CLI-kódrészletet :

Megjegyzés: Néha az API-kulcsot "előfizetési kulcsnak" vagy "előfizetési API-kulcsnak" is nevezik.

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

Miután rendelkezik API-kulccsal és végpontokkal, az AzureKeyCredential osztály használatával hitelesítheti az ügyfelet az alábbiak szerint:

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

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

JavaScript-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek részleteiért tekintse meg a csomagküldő dokumentációt.

Fő fogalmak

ConversationAnalysisClient

ConversationAnalysisClient az Azure ConversationAnalysis ügyfélkódtárat használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az Azure ConversationAnalysis szolgáltatás különböző funkcióinak megismeréséhez.

Hibaelhárítás

Naplózás

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL értékre info. A naplózás futásidőben is engedélyezhető a következő hívással setLogLevel@azure/logger:

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

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációt.

Következő lépések

A kódtár használatára vonatkozó részletes példákért tekintse meg a mintakönyvtárat.

Közreműködés

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Kapcsolódó projektek

• JavaScripthez készült Microsoft Azure SDK