다음을 통해 공유

JavaScript용 Azure ConversationAnalysis 클라이언트 라이브러리 - 버전 1.0.0-beta.1

  • 아티클

이 패키지에는 Azure ConversationAnalysis 클라이언트에 대한 등형 SDK(Node.js 및 브라우저에서 모두 실행됨)가 포함되어 있습니다.

언어 서비스 대화 API는 구조화된 대화(텍스트 또는 음성)를 분석하는 데 사용할 수 있는 NLP(자연어 처리) 기술 모음입니다. 이 제품군의 동기 API는 LUIS 일반 공급, 질문 답변, 대화형 Language Understanding 같은 여러 언어 프로젝트 간에 요청 및 중재를 수락한 다음, 요청을 처리하는 가장 적합한 후보 서비스를 호출합니다. 마지막으로 후보 서비스의 응답을 페이로드로 사용하여 응답을 반환합니다.

경우에 따라 이 API는 호출자와 업스트림 서비스 간에 요청 및 응답을 전달해야 합니다. 이 도구 모음의 비동기 API를 사용하면 대화 요약 및 대화형 PII 검색과 같은 작업을 수행할 수 있습니다.

주요 링크:

시작

현재 지원되는 환경

자세한 내용은 지원 정책을 참조하세요.

사전 요구 사항

  • Azure 구독.
  • 기존 [Cognitive Services][cognitive_resource] 또는 언어 리소스입니다. 리소스를 만들어야 하는 경우 Azure Portal 또는 Azure CLI를 사용할 수 있습니다.

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 만들기 및 인증

언어 API에 액세스하는 클라이언트 개체를 만들려면 언어 리소스의 및 이 credential필요합니다endpoint. 대화 분석 클라이언트는 API 키 자격 증명을 사용하여 인증할 수 있습니다.

Azure Portal에서 또는 아래 AzureCLI 코드 조각을 사용하여 언어 리소스에 대한 엔드포인트를 찾을 수 있습니다.

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 번들

브라우저에서 이 클라이언트 라이브러리를 사용하려면 먼저 번들러를 사용해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 번들링 설명서를 참조하세요.

주요 개념

ConversationAnalysisClient

ConversationAnalysisClient 는 Azure ConversationAnalysis 클라이언트 라이브러리를 사용하는 개발자를 위한 기본 인터페이스입니다. 이 클라이언트 개체의 메서드를 탐색하여 액세스할 수 있는 Azure ConversationAnalysis 서비스의 다양한 기능을 이해합니다.

문제 해결

로깅

로깅을 사용하도록 설정하면 실패에 대한 유용한 정보를 파악하는 데 도움이 될 수 있습니다. HTTP 요청 및 응답 로그를 보려면 AZURE_LOG_LEVEL 환경 변수를 info로 설정합니다. 또는 @azure/logger에서 setLogLevel을 호출하여 런타임에 로깅을 사용하도록 설정할 수 있습니다.

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

로그를 사용하는 방법에 대한 자세한 내용은 @azure/logger package docs를 참조하세요.

다음 단계

이 라이브러리를 사용하는 방법에 대한 자세한 예제는 샘플 디렉터리를 참조하세요.

참여

이 라이브러리에 기여하려면 기여 가이드 를 참조하여 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.

Impressions