SHUKLAO/call-with-ai-agent

call-with-ai-agent은(는) 무엇을 하나요?

🗣️ Next.js와 ElevenLabs를 사용하여 AI 에이전트와 실시간 음성 대화를 통해 상호작용적이고 반응성 높은 사용자 경험을 제공합니다.

개요

이 프로젝트는 Next.js 애플리케이션에서 ElevenLabs의 음성 API를 통합하여 사용자가 AI 에이전트와 자연어로 음성 대화를 나눌 수 있도록 합니다. 실시간 통신을 위해 WebSocket 또는 HTTP 스트리밍을 사용하며, 사용자의 음성 입력을 텍스트로 변환하고 AI의 응답을 다시 음성으로 합성합니다.

주요 기능

• 실시간 음성 대화: 마이크를 통해 말하면 AI가 즉시 응답합니다.
• 고품질 음성 합성: ElevenLabs의 다양한 음성 모델을 선택할 수 있습니다.
• Next.js 통합: 풀스택 React 프레임워크로 서버 및 클라이언트 로직을 간편하게 관리합니다.
• 사용자 정의 가능: 음성 속도, 톤, 언어 등을 조정할 수 있습니다.

설치 방법

1. 저장소를 클론합니다:

   git clone https://github.com/SHUKLAO/call-with-ai-agent.git
   cd call-with-ai-agent
   

2. 의존성을 설치합니다:

   npm install
   # 또는
   yarn install
   

3. 환경 변수를 설정합니다: .env.local 파일을 생성하고 다음 키를 추가합니다:

   ELEVENLABS_API_KEY=your_elevenlabs_api_key
   NEXT_PUBLIC_ELEVENLABS_VOICE_ID=your_voice_id
   

사용 방법

1. 개발 서버를 시작합니다:

   npm run dev
   

2. 브라우저에서 http://localhost:3000으로 이동합니다.

3. 마이크 권한을 허용하고 "대화 시작" 버튼을 클릭합니다.

4. 마이크에 대고 말하면 AI 에이전트가 응답합니다.

API 엔드포인트

• POST /api/voice/transcribe: 음성 파일을 텍스트로 변환합니다.
• POST /api/voice/synthesize: 텍스트를 음성으로 합성합니다.
• GET /api/voice/stream: 실시간 음성 스트리밍을 위한 WebSocket 엔드포인트입니다.

주요 의존성

• Next.js – React 기반 웹 프레임워크
• ElevenLabs – AI 음성 합성 API
• WebSocket – 실시간 통신

라이선스

MIT