المهارات @azure/ai-voicelive (JavaScript/TypeScript)
🎙️

@azure/ai-voicelive (JavaScript/TypeScript)

آمن

Azure 로 실시간 음성 AI 앱 구축하기

이 스킬은 Azure AI Voice Live SDK 를 사용하여 실시간 음성 AI 애플리케이션을 구축하기 위한 포괄적인 문서와 코드 예제를 제공합니다. 개발자가 JavaScript 와 TypeScript 로 음성 어시스턴트, 대화형 AI, 음성 - 음성 애플리케이션을 만들 수 있도록 지원합니다.

يدعم: Claude Codex Code(CC)
🥉 73 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "@azure/ai-voicelive (JavaScript/TypeScript)". DefaultAzureCredential 로 VoiceLiveClient 를 어떻게 생성하나요?

النتيجة المتوقعة:

import { DefaultAzureCredential } from '@azure/identity';
import { VoiceLiveClient } from '@azure/ai-voicelive';

const credential = new DefaultAzureCredential();
const endpoint = process.env.AZURE_VOICELIVE_ENDPOINT!;
const client = new VoiceLiveClient(endpoint, credential);

استخدام "@azure/ai-voicelive (JavaScript/TypeScript)". 어떤 음성 옵션을 사용할 수 있나요?

النتيجة المتوقعة:

Azure Standard voices (en-US-AvaNeural, 등), 엔드포인트 ID 를 가진 Azure Custom voices, 화자 클로닝을 위한 Azure Personal voices, OpenAI voices (alloy, echo, shimmer).

استخدام "@azure/ai-voicelive (JavaScript/TypeScript)". 오류는 어떻게 처리하나요?

النتيجة المتوقعة:

구독에서 onError 핸들러를 사용하여 VoiceLiveConnectionError, VoiceLiveAuthenticationError, VoiceLiveProtocolError 타입을 캐치하세요.

التدقيق الأمني

آمن
v1 • 2/24/2026

This is a documentation-only skill containing guidance for using the Azure AI Voice Live SDK. No executable code was detected. The skill provides usage examples for a legitimate Azure service. No security concerns identified.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

음성 어시스턴트 구축

음성을 이해하고 AI 생성 오디오로 응답하며 다중 턴 대화를 처리할 수 있는 인터랙티브한 음성 어시스턴트를 만듭니다.

실시간 음성을

고객 서비스, 접근성 또는 문서화 애플리케이션을 위해 저지연 라이브 음성 - 텍스트 음성을 구현합니다.

대화형 챗봇

GPT 모델을 사용하여 사용자와 자연스러운 음성 대화를 할 수 있는 음성 지원 챗봇을 구축합니다.

جرّب هذه الموجهات

기본 음성 클라이언트 설정
TypeScript 에서 Microsoft Entra ID 인증을 사용하여 기본 VoiceLiveClient 를 설정하는 방법을 보여주세요.
세션 구성
텍스트 및 오디오 모달리티, 사용자 정의 지침, Azure Semantic VAD 턴 감지를 사용하여 음성 세션을 구성하세요.
이벤트 처리
구독 패턴을 사용하여 오디오 델타 스트리밍, 텍스트 델타, 음성 이벤트에 대한 이벤트 핸들러를 구현하세요.
함수 호출
세션 구성에서 함수 호출 도구를 설정하고 외부 API 를 통합하기 위한 함수 호출 이벤트를 처리하세요.

أفضل الممارسات

  • 보안 인증을 위해 API 키를 하드코딩하는 대신 항상 DefaultAzureCredential 사용
  • 기본 서버 VAD 보다 더 나은 턴 감지를 위해 Azure Semantic VAD 사용
  • 메모리 누수를 방지하기 위해 작업 완료 시 subscription.close() 를 호출하여 구독 정리

تجنب

  • 환경 변수나 Entra ID 대신 소스 코드에 API 키 직접 하드코딩
  • 연결, 인증, 프로토콜 오류를 따로 처리하지 않음
  • 텍스트 없이 오디오 모달리티만 설정 - 이로 인해 많은 대화 기능이 중단됨

الأسئلة المتكررة

어떤 인증 방법을 지원하나요?
Microsoft Entra ID(권장) 및 AzureKeyCredential 을 사용한 API 키 인증.
어떤 환경을 지원하나요?
Node.js LTS (20+) 및 모던 브라우저 (Chrome, Firefox, Safari, Edge) 와 번들러.
어떤 오디오 형식을 지원하나요?
PCM16 24kHz(기본), PCM16-8kHz, PCM16-16kHz, G711 ulaw, G711 alaw.
턴 감지는 어떻게 작동하나요?
서버 VAD 는 음성 활동 감지를 사용합니다. Azure Semantic VAD 는 AI 를 사용하여 더 나은 턴 교대를 위한 대화 컨텍스트를 이해합니다.
커스텀 음성을 사용할 수 있나요?
네, 엔드포인트 ID 를 가진 Azure Custom voices 와 화자 프로파일 클로닝을 위한 Azure Personal voices 를 지원합니다.
어떤 모델을 지원하나요?
비용 효율적인 애플리케이션을 위한 GPT-4o-realtime-preview, GPT-4o-mini-realtime-preview, phi4-mm-realtime.

تفاصيل المطور

بنية الملفات

📄 SKILL.md