대부분의 음성 AI (Voice AI) 예제는 대화 중심입니다. 사용자가 어시스턴트와 대화하고, 어시스턴트가 응답하면 데모가 끝납니다.

저는 좀 더 촉각적인 무언가를 원했습니다. 전화번호로 전화를 걸고, 명령을 말하면, 시스템이 변하는 것을 보는 것입니다.

그래서 이 예제는 Telnyx 전화번호를 음성 제어 시설 명령줄 (command line)로 변환합니다. 전화를 걸어 다음과 같이 말하면 됩니다:

하역장 게이트를 열어줘
창고 조명을 켜줘
냉동고 알람을 확인해줘

앱은 음성을 듣고, 말한 요청을 시뮬레이션된 IoT 장치에 매핑하며, 상태를 업데이트하고, 명령을 로그에 기록한 뒤, 결과를 다시 말해줍니다.

기본 흐름 (The Basic Flow)

이 앱은 작은 Python Flask 서비스입니다.

누군가 Telnyx 번호로 전화를 걸면:

1. Telnyx가 Flask로 Call Control 웹훅 (webhook)을 보냅니다.
2. 앱이 전화를 받습니다.
3. Telnyx AI gather가 발신자의 음성 명령을 캡처합니다.
4. 앱이 명령을 장치와 동작으로 파싱 (parse)합니다.
5. 앱이 시뮬레이션된 장치 상태를 업데이트합니다.
6. Telnyx가 짧은 확인 메시지를 말합니다.
7. 명령이 감사 로그 (audit log)에 나타납니다.

중요한 점은 결과가 눈에 보인다는 것입니다. 데모 중에 /devices 페이지를 열어두고 각 명령 후에 새로고침할 수 있습니다.

실시간 통화에서 로컬 파서 (Local Parser)를 사용하는 이유

이 앱에는 로컬 HTTP API를 통해 명령을 파싱하기 위한 Telnyx AI 추론 (Inference) 경로가 포함되어 있습니다. 이는 이 패턴이 더 넓은 자연어 (natural language)를 어떻게 처리할 수 있는지 보여주는 데 유용합니다.

실시간 전화 통화에서는 응답성 (responsiveness)이 더 중요합니다. Telnyx AI gather가 명령을 캡처한 후, 앱은 알려진 데모 문구에 대해 결정론적 파서 (deterministic parser)를 사용합니다. 이를 통해 두 번째 AI 호출을 피하고 전화 경험을 더 빠르게 느끼게 합니다.

이는 유용한 프로덕션 (production) 교훈입니다. 음성 AI 시스템의 모든 부분이 생성형 (generative)일 필요는 없습니다. 유연성이 필요한 곳에는 AI를 사용하고, 지연 시간 (latency)과 신뢰성이 중요한 곳에는 결정론적 로직 (deterministic logic)을 사용하세요.

이것이 무엇이 될 수 있는가

현재 앱은 시뮬레이션된 장치를 사용합니다:

• 하역장 게이트 (loading dock gate)
• 창고 조명 (warehouse lights)
• 냉동고 알람 (freezer alarm)
• 비상 발전기 (backup generator)
• 관개 펌프 (irrigation pump)

실제 운영 환경(production)에서는 동일한 패턴을 실제 시스템에 연결할 수 있습니다:

• 건물 출입 통제 (building access control)
• 현장 장비 (field equipment)
• 차량/함대 장치 (fleet devices)
• 산업용 알림 (industrial alerts)
• 시설 운영 (facilities operations)

위험한 동작의 경우, 발신자 인증 (caller authentication), 허용 목록 (allowlists), 그리고 확인 단계 (confirmation steps)를 추가해야 합니다. 또한 명령 로그 (command logs)를 데이터베이스에 저장하고, 웹훅 서명 검증 (webhook signature verification)을 활성화된 상태로 유지해야 합니다.

데모 스크립트 (Demo Script)

/devices를 엽니다.

해당 번호로 전화를 겁니다.

다음과 같이 말합니다:

하역장 게이트를 열어줘 (unlock the loading dock gate)

/devices를 새로고침하여 게이트가 잠금 해제되었음을 보여줍니다.

그 다음 다음과 같이 말합니다:

창고 조명을 켜줘 (turn on the warehouse lights)

다시 새로고침하여 조명이 켜졌음을 보여줍니다.

/commands를 열어 감사 로그 (audit log)를 보여줍니다.

이것이 전체 과정입니다: 음성 입력 (voice input), 명령 파싱 (command parsing), 상태 변경 (state change), 음성 확인 (spoken confirmation), 그리고 감사 추적 (audit trail).

링크 (Links)

• Telnyx Call Control: https://developers.telnyx.com/docs/voice/call-control
• Telnyx AI Inference: https://developers.telnyx.com/docs/inference
• Telnyx IoT: https://telnyx.com/products/iot-sim-card