Delen via

Azure ConversationAnalysis-clientbibliotheek voor JavaScript - versie 1.0.0-beta.1

  • Artikel

Dit pakket bevat een isomorfe SDK (wordt zowel in Node.js als in browsers uitgevoerd) voor de Azure ConversationAnalysis-client.

De taalservicegesprekken-API is een suite van NLP-vaardigheden (Natural Language Processing) die kunnen worden gebruikt voor het analyseren van gestructureerde gesprekken (tekstueel of gesproken). De synchrone API in deze suite accepteert een aanvraag en bemiddelt tussen projecten in meerdere talen, zoals LUIS Algemeen beschikbaar, Vragen beantwoorden, Gespreks Language Understanding, en roept vervolgens de beste kandidaatservice aan om de aanvraag af te handelen. Ten slotte retourneert het een antwoord met het antwoord van de kandidaat-service als een nettolading.

In sommige gevallen moet deze API aanvragen en antwoorden doorsturen tussen de aanroeper en een upstream-service. Met de asynchrone API's in deze suite kunt u taken zoals gesprekssamenvatting en detectie van gespreks PII's uitvoeren.

Belangrijke koppelingen:

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Vereisten

Als u de Azure CLI gebruikt, vervangt u en <your-resource-name> door <your-resource-group-name> uw eigen unieke namen:

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

Installeer het pakket @azure/ai-language-conversations

Installeer de Azure ConversationAnalysis-clientbibliotheek voor JavaScript met npm:

npm install @azure/ai-language-conversations

Een maken en verifiëren ConversationAnalysisClient

Als u een clientobject wilt maken voor toegang tot de Taal-API, hebt u de endpoint van uw taalresource en een credentialnodig. De gespreksanalyseclient kan een API-sleutelreferentie gebruiken om te verifiëren.

U vindt het eindpunt voor uw taalresource in Azure Portal of met behulp van het onderstaande Azure CLI-fragment :

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

Een API-sleutel gebruiken

Gebruik de Azure-portal om naar uw taalresource te bladeren en een API-sleutel op te halen, of gebruik het onderstaande Azure CLI-fragment :

Opmerking: Soms wordt de API-sleutel een 'abonnementssleutel' of 'abonnements-API-sleutel' genoemd.

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

Zodra u een API-sleutel en eindpunt hebt, kunt u de AzureKeyCredential klasse als volgt gebruiken om de client te verifiëren:

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

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

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundler gebruiken. Raadpleeg onze bundeldocumentatie voor meer informatie over hoe u dit doet.

Belangrijkste concepten

ConversationAnalysisClient

ConversationAnalysisClient is de primaire interface voor ontwikkelaars die de Azure ConversationAnalysis-clientbibliotheek gebruiken. Verken de methoden op dit clientobject om inzicht te krijgen in de verschillende functies van de Azure ConversationAnalysis-service waartoe u toegang hebt.

Problemen oplossen

Logboekregistratie

Het inschakelen van logboekregistratie kan helpen bij het ontdekken van nuttige informatie over fouten. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de AZURE_LOG_LEVEL omgevingsvariabele in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door aan te roepen setLogLevel in de @azure/logger:

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

Voor meer gedetailleerde instructies over het inschakelen van logboeken kunt u de @azure-/loggerpakketdocumenten bekijken.

Volgende stappen

Bekijk de map met voorbeelden voor gedetailleerde voorbeelden van het gebruik van deze bibliotheek.

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.

Weergaven