스킬 Azure.AI.VoiceLive (.NET)
🎙️

Azure.AI.VoiceLive (.NET)

안전

Azure VoiceLive 를 사용한 실시간 음성 AI 앱 구축

개발자들은 적절한 인증 및 이벤트 처리를 통해 실시간 음성 AI 기능을 구현하는 데 어려움을 겪고 있습니다. 이 스킬은 안전한 인증, WebSocket 세션 관리 및 양방향 오디오 스트리밍 패턴을 포함한 Azure VoiceLive 에 대한 완전한 .NET SDK 문서화 기능을 제공합니다.

지원: Claude Codex Code(CC)
🥉 72 브론즈
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"Azure.AI.VoiceLive (.NET)" 사용 중입니다. 날씨를 확인할 수 있는 음성 어시스턴트를 만들고 싶습니다

예상 결과:

  • VoiceLiveClient 가 DefaultAzureCredential 을 사용하여 Azure AI 엔드포인트에 연결
  • 세션이 음성 모달리티 및 날씨 함수 정의로 구성됨
  • 사용자가 음성 쿼리를 말하면 오디오가 WebSocket 을 통해 Azure 로 전송됨
  • 함수 호출이 트리거되고 날씨 API 응답이 세션으로 전송됨
  • 어시스턴트가 음성으로 날씨 정보 응답

"Azure.AI.VoiceLive (.NET)" 사용 중입니다. VoiceLive 세션에서 오류를 어떻게 처리하나요

예상 결과:

  • SessionUpdateError 이벤트는 오류 세부 정보를 포함함
  • Cancellation failed 오류는 안전하게 무시할 수 있음
  • 인증 오류는 자격 증명 확인이 필요함
  • 네트워크 오류는 세션 재연결 로직을 트리거해야 함

보안 감사

안전
v1 • 2/24/2026

Static analysis scanned 0 files with 0 lines and detected no security issues. This is a documentation-only skill (SKILL.md) providing guidance for using the Azure AI VoiceLive SDK. No executable code, network calls, or file system access patterns are present in the skill itself. The skill recommends secure authentication practices using DefaultAzureCredential.

0
스캔된 파일
0
분석된 줄 수
0
발견 사항
1
총 감사 수
보안 문제를 찾지 못했습니다
감사자: claude

품질 점수

38
아키텍처
100
유지보수성
87
콘텐츠
50
커뮤니티
100
보안
74
사양 준수

만들 수 있는 것

음성 어시스턴트 개발

실시간으로 음성을 처리하고 합성된 오디오 및 텍스트로 응답하는 대화형 음성 어시스턴트를 구축합니다.

실시간 음성 간 번역

음성 입력을 캡처하여 AI 모델을 통해 처리하고 최소 지연 시간으로 번역된 음성을 출력하는 애플리케이션을 생성합니다.

음성 지원 챗봇

Azure AI VoiceLive 를 사용하여 핸즈프리 사용자 경험을 제공하는 기존 챗봇 시스템에 자연스러운 음성 상호작용을 통합합니다.

이 프롬프트를 사용해 보세요

기본 음성 세션 설정
.NET 에서 기본 Azure VoiceLive 세션을 만드는 것을 도와주세요. DefaultAzureCredential 로 인증하고, 텍스트 및 오디오 모달리티로 세션을 구성하며, 수신 오디오 이벤트를 처리해야 합니다.
함수 호출 구성
Azure VoiceLive 에서 함수 호출을 정의하고 처리하는 방법을 보여주세요. 음성 어시스턴트가 대화 중에 호출할 수 있는 날씨 조회 함수를 추가하고 싶습니다.
맞춤형 음성 및 턴 감지
맞춤형 뉴럴 음성 및 시맨틱 음성 활동 감지를 사용하여 Azure VoiceLive 를 구성하세요. 자연스러운 대화 흐름을 위해 적절한 침묵 기간 및 임계값을 설정합니다.
전체 음성 어시스턴트 구현
Azure VoiceLive SDK 를 사용한 완전한 실시간 음성 어시스턴트 예제를 생성하세요. 인증, 세션 관리, 이벤트 처리 루프, 오류 처리 및 외부 API 에 대한 함수 호출을 포함합니다.

모범 사례

  • 하드코딩된 API 키 대신 인증에 DefaultAzureCredential 사용
  • 완전한 음성 어시스턴트 기능을 위해 Text 및 Audio 모달리티 모두 구성
  • 적절한 리소스 폐기를 위해 VoiceLiveSession 을 항상 using 문으로 감싸기

피하기

  • 소스 코드에 API 키를 하드코딩하지 마세요 - 환경 변수 또는 관리형 ID 사용
  • SessionUpdateError 이벤트에 대한 오류 처리를 생략하지 마세요
  • VoiceLiveSession 폐기를 건너뛰지 마세요 - 항상 using 문 사용

자주 묻는 질문

VoiceLive SDK 를 사용하려면 어떤 Azure 리소스가 필요한가요
VoiceLive 가 활성화된 Azure AI Services 리소스가 필요합니다. 관리형 ID 인증을 위해서는 Cognitive Services User 역할을 할당하거나, Azure Portal 에서 API 키를 획득하세요.
VoiceLive 가 맞춤 음성을 지원하나요
네, VoiceLive 는 Azure Standard 음성, Azure HD 음성 및 Azure Custom 음성을 지원합니다. 내장 음성에는 AzureStandardVoice 를 사용하거나, 맞춤 뉴럴 음성에는 엔드포인트 ID 와 함께 AzureCustomVoice 를 사용하세요.
VoiceLive 는 어떤 오디오 포맷이 필요한가요
VoiceLive 는 모노의 24kHz 샘플 레이트에서 PCM 16-bit 오디오를 사용합니다. 세션 구성에서 InputAudioFormat 및 OutputAudioFormat 을 Pcm16 으로 설정하세요.
VoiceLive 가 여러 언어를 처리할 수 있나요
네, VoiceLive 는 음성 선택을 통해 여러 언어를 지원합니다. en-US-AvaNeural 과 같은 언어 - 지역 음성 식별자를 지정하거나 다른 언어에 대해 맞춤 음성을 구성하세요.
VoiceLive 에서 함수 호출은 어떻게 작동하나요
JSON 스키마 매개변수와 함께 VoiceLiveFunctionDefinition 을 정의하고, 세션 옵션 Tools 컬렉션에 추가한 다음, SessionUpdateResponseFunctionCallArgumentsDone 이벤트를 처리하여 호출을 처리하고 FunctionCallOutputItem 응답을 전송합니다.
VoiceLive 와 Cognitive Services Speech SDK 의 차이점은 무엇인가요
VoiceLive 는 대화형 어시스턴트를 위한 GPT-4o 모델과 함께 실시간 양방향 음성 AI 를 제공합니다. Cognitive Services Speech SDK 는 통합된 AI 추론 없이 음성을 텍스트로, 텍스트를 음성으로 개별적으로 처리합니다.

개발자 세부 정보

파일 구조

📄 SKILL.md