Dpro-at/Tel-Agent

Tel‑Agent – 오픈 소스 AI 전화 어시스턴트 게이트웨이

개요 – Tel‑Agent는 기존 SIP 전화 회선(또는 SIP 호환 PBX)을 AI 에이전트에 연결하는 셀프 호스팅 게이트웨이입니다. 수신 전화는 사용자 정의 규칙에 따라 라우팅됩니다. 사람에게 연결하거나, 차단하거나, AI가 응답하도록 설정할 수 있습니다. AI는 실시간으로 대화하고, 외부 HTTP 엔드포인트를 호출하며, 메시지를 남기고, 일정을 확인하는 등의 작업을 수행합니다. 동일한 AI 에이전트가 사용자의 자격 증명을 사용하여 수십 개의 메시징 채널(웹 채팅, SMS, 이메일, WhatsApp, Telegram, Discord, Slack 등)에서도 대화할 수 있습니다.

중요성 – 기존의 상용 "AI 접수원" 서비스는 대부분 클로즈드 소스이며 클라우드 전용이어서 녹음 데이터와 API 키가 공급업체의 손에 있습니다. Tel‑Agent를 사용하면 전체 스택을 자신의 하드웨어에서 실행하고, 원하는 LLM이나 TTS/STT 제공업체를 선택(또는 로컬 모델 실행)하여 모든 데이터를 직접 제어할 수 있습니다.

핵심 기능

멀티 채널 수신 라우팅 – SIP 음성 및 24개 이상의 메시징 플랫폼(WhatsApp, Telegram, Discord, Slack, 이메일 등) 지원.
실시간 AI 대화 – 음성 인식, LLM 생성, 음성 합성을 스트리밍하며, 첫 음성 응답까지 800ms 미만 소요.
도구 호출 – 에이전트가 임의의 HTTP 엔드포인트를 호출하여 일정 조회, 티켓 생성, 통화 전환 등의 작업을 수행 가능.
전체 기록 및 전사 – 모든 상호작용이 저장 및 검색 가능하며, GDPR/EU‑AI‑Act를 준수.
셀프 호스팅 배포 – Windows/macOS/Linux용 네이티브 설치 프로그램, Docker‑Compose, Caddy 기반 HTTPS 리버스 프록시 제공.
플러그형 백엔드 – 기본적으로 Deepgram (STT), ElevenLabs (TTS) 및 클라우드 LLM 사용. v1.1에서는 로컬 모델(Ollama, Whisper, Piper) 지원 예정.
다국어 지원 – UI 및 에이전트는 현재 영어, 독일어, 아랍어, 스페인어, 네덜란드어를 지원하며, i18n 기여를 환영합니다.

아키텍처 개요

레이어	기술
음성/에이전트 런타임	Python + LiveKit Agents
HTTP API	FastAPI (Python)
프론트엔드 대시보드	Next.js + React
영속성	SQLite (기본값) – 선택 사항 PostgreSQL
캐시 / 큐	Redis
TLS 종료 / 리버스 프록시	Caddy
패키징	Windows 설치 프로그램, macOS pkg, Linux DEB/RPM, Docker‑Compose

빠른 시작 (Docker)

git clone https://github.com/Dpro-at/Tel-Agent.git
cd Tel-Agent
cp .env.example .env               # ENCRYPTION_KEY 설정 (예: openssl rand -hex 32)
# .env를 편집하여 STT/LLM/TTS 키 및 채널 자격 증명 추가
docker compose up -d --build       # API, 대시보드, LiveKit, Redis 등 시작

대시보드: http://localhost:38471
API 문서: http://localhost:38472/docs
빌드 단계를 건너뛰려면 릴리스된 docker-compose.release.yml을 사용하거나 릴리스 페이지에서 네이티브 설치 프로그램을 실행하세요.

일반적인 사용 사례

AI 접수원 – 비즈니스 전화 자동 응답, 정보 제공, 예약 조정 및 필요 시 사람에게 연결.
옴니채널 지원 – 단일 AI 어시스턴트가 음성, SMS, WhatsApp, Slack 등을 처리하여 일관된 고객 경험 제공.
내부 도구 – 범용 HTTP 도구를 통해 에이전트가 내부 API(티켓팅, 재고 관리 등)를 트리거.
데이터 소유권 준수 – 녹음 및 전사 내용을 온프레미스에 보관하여 GDPR 또는 EU‑AI‑Act 요구 사항 충족.

라이선스 및 상용 옵션

AGPL‑3.0 – 네트워크를 통해 제공되는 모든 수정 사항은 공개되어야 합니다.
기업용 상용 클로즈드 소스 라이선스는 Dpro GmbH를 통해 제공됩니다.

추가 정보

로드맵: docs/ROADMAP.md
기여 가이드: CONTRIBUTING.md (온보딩 튜토리얼 포함)
보안 정책: SECURITY.md
API 사양: docs/SPEC.md

요약 – Tel‑Agent는 AI 기반 전화 접수원(및 기타 여러 메시징 채널)을 자체 인프라에서 실행할 수 있게 해주는 오픈 소스 셀프 호스팅 브리지로, 데이터, 모델 및 통합에 대한 완전한 제어권을 제공합니다.