보이스 프로필 개발 문서
실제 연동 구현용 명세 - 등록 App·AI-Agent ↔ DeviceAgent 인터페이스 정의 - AI-Agent 화자인식 내부 구조·설계 - 등록 App ↔ DeviceAgent: 화면 제어·상태 수신 값 - AI-Agent ↔ DeviceAgent: 실행 요청·임베딩·저장 결과 값 - IoTAgent·AWS 담당: 토픽·발행/구독·메시지 명세 - 모바일·Backend 담당: HTTPS 요청/결과 명세
개발은 내부(등록 App·AI-Agent), SoC(DeviceAgent·IotAgent), 모바일·관제(App·AWS Backend) 세 그룹으로 나눈다. 아래 실행 주체별 역할과 구분하며, 담당별 구현 범위와 연결 작업은 3개 개발 그룹과 연동 인터페이스에서 확인한다.
이 페이지는 보이스 프로필의 등록, 조회·삭제, 화자 식별 문서를 찾기 위한 시작점이다.
제품 사양의 기준은 보이스 프로필 등록 제품 구현 기준서다. 이 허브와 나머지 페이지는 탐색·상세 설계·구현·시험 증거용이다.
통합 개발은 통합 설계·연동 기준서에서 시작한다. 모바일 APP, AWS Backend·클라우드, SoC·DeviceAgent, 화자인식 등록·인식 APP·Service의 책임과 연동 규격을 확인할 수 있다.
먼저 보는 결론
- 개발은 내부, SoC, 모바일·관제 세 그룹으로 나눈다. 모바일 App과 Backend의 실행 책임은 별도로 표시한다.
- 모바일 APP은 사용자 입력과 상태 표시, HTTPS 요청만 담당한다.
- AWS Backend·클라우드는 인증, AWS IoT MQTT, Voice ID·사용자 매핑을 담당한다.
- SoC·DeviceAgent는 MQTT와 Binder 중계·검증을 담당하고 화자를 판정하지 않는다.
- 화자인식 등록·인식 APP·Service는 A1 화면, 녹음·품질 검사, Voice ID·로컬 식별을 담당한다.
- 원본 PCM은 A1 밖으로 보내지 않는다.
문서 찾기
| 확인할 내용 | 문서 |
|---|---|
| 세 개발 그룹의 담당·인터페이스·남은 연결 작업 | 개발 분담과 인터페이스 |
| 제품 사양의 유일한 상위 기준 | 제품 구현 기준서 |
| 역할별 책임·완료 조건·공동 계약 | 4개 역할과 책임 |
| 현재 구조와 담당 모듈 | 전체 구조와 책임 |
| 등록 시작부터 완료까지 | 등록 씬 설계 |
| 음성 품질 검사와 일반 음성 차단 | 등록 음성 검증과 음성 경로 차단 |
| 실제 대화의 화자 식별 | 런타임 화자 식별 |
| 화자별 서버 관심사 조회·등록 상태 | 관심사와 등록 상태 관리 |
| 현재 저장 위치와 제거된 인터페이스 | 저장소·이번 차수 범위 |
| voiceId 기반 요청·응답과 실제 타입 | 서버 관심사 계약 |
| MQTT·Binder·상태·오류 규격 | 통합 설계·연동 기준서 |
| 취소·재시도·복구 | 실패·취소·복구 |
| 시험 보드·APK·실행 방법 | 로컬 PoC 시험 환경 |
현재 코드 형상과 구현·검증 경계는 제품 구현 기준서의 2026-09-01 코드 대조 기준을 먼저 확인한다.
현재 구현 상태
| 구분 | 상태 | 확인된 범위 |
|---|---|---|
| A1 등록 화면 | 구현 | 플랫폼 서명 별도 APK, KO/EN 화면, 시작·취소·재시도 |
| OnDevice 등록 | 구현 | 5.2초 고정 수집 5세트, 신호 품질과 세트 간 임베딩 일관성 검사 |
| Voice ID·기준 임베딩 | 구현 | UUID Voice ID, 앱 전용 저장소, 복수 프로필 |
| 프로필 조회·삭제 | 구현 | 실제 A1 저장소 기준 목록과 Voice ID 단위 삭제 |
| 런타임 식별 | CPU PoC | 기존 STT 발화 PCM 재사용, 로컬 임베딩 비교 |
| 서버 관심사 조회 | 샘플 구현 | voiceId로 조회, 문자열 목록을 비동기 콜백 수신. 제품 AWS 연동은 별도 |
| 대화내역·모바일 대화창 | 다음 차수 | 현재 공개 API·화면에서 제거. 구형 DB는 서비스 시작 시 정리 |
| 로컬 MQTT 시험 | 구현 | PC Gateway·Broker로 AWS 없는 왕복 시험 |
| 클라우드 보이스 프로필 저장·사용자 조회 | 미구현 | 제품 AWS Backend, 동기화 처리, 실제 Cloud ACK 필요 |
| 고급 등록 검증 | 미구현 | 문장 일치, 세트 내부 다화자, 재생·합성 음성 방어 |
구현은 코드, 빌드 또는 실기기 왕복이 있다는 뜻이다. 화자 정확도 승인과 제품 Cloud
완료를 뜻하지 않는다.
실행 영역별 역할
| 영역 | 포함 모듈 | 책임 |
|---|---|---|
| 모바일 APP | 휴대폰 앱 | 사용자 입력, 등록·조회·삭제 요청, 상태 표시 |
| AWS Backend·클라우드 | Backend, AWS IoT Core, 클라우드 보이스 프로필 저장소 | 인증, MQTT 발행·구독, Voice ID·사용자 매핑 |
| SoC·DeviceAgent | IotAgent, DeviceAgent | MQTT-Binder 중계, 검증, Activity 실행, 전달 대기 저장소 |
| 화자인식 등록·인식 APP·Service | Registration App, OnDevice Agent Service | UI, 녹음, 품질 검사, Voice ID, 저장·식별 |
세부 완료 조건과 변경 승인표는 4개 역할과 책임을 기준으로 한다.
모듈 내부 책임
| 주체 | 책임 | 금지 데이터·행동 |
|---|---|---|
| 모바일 APP | 기기·닉네임 선택, 등록·조회·삭제 요청 | A1 녹음, Voice ID 생성 |
| AWS Backend | 인증, MQTT command/result 중계 | 기기 내부 화자 판정 |
| IotAgent | AWS IoT MQTT 연결과 Bundle 변환 | 등록 UI, 음성 모델 실행 |
| DeviceAgent | 요청 검증, Registration App 실행, Binder 중계, 전달 대기 저장소 | PCM/WAV 처리, 화자 판정 |
| Registration App | Figma 화면과 사용자 입력 | AudioRecord, 임베딩 처리 |
| OnDevice Agent Service | 녹음, 품질 검사, 프로필 생성·저장·식별 | Cloud 계정·권한 결정 |
확인된 검증
- 등록 화면 실행, 취소, 프로필 목록·삭제의 MQTT-Binder 왕복을 실기기에서 확인했다.
- 플랫폼 서명 Agent 설치 후 STT·CPU 화자인식 초기화와 등록 프로필 로드를 확인했다.
- 과거 대화내역 시험 결과는 현재 제공 기능의 근거가 아니다. 09-29 변경은 관련 JVM 테스트·디버그 빌드로 검증했으며 새 APK의 실기기 검증은 별도다.
- 정확한 보드 정보, APK 해시와 실행 명령은 로컬 PoC 시험 환경에 둔다.
제품화 전에 남은 일
- AWS Backend 인증, 제품 MQTT 상태·결과 토픽과 클라우드 보이스 프로필 저장소를 연결한다.
- DeviceAgent 전달 대기 저장소를 Cloud 동기화 처리와 연결하고 실제 ACK를 처리한다.
- Cloud 사용자 매핑과 A1 로컬 삭제를 하나의 제품 삭제 흐름으로 만든다.
- 실제 사용자 데이터로 품질·화자 판정 기준과 최대 등록 인원을 확정한다.
- 세트 내부 다화자와 재생·합성 음성 방어 범위를 결정한다.
- 재부팅 후 식별, Cloud 조회, 삭제까지 종단 간 시험을 수행한다.
참고 문서
- Figma KO: node
1:577 - Figma EN: node
1:1279 - Privacy And Safety
- Source Map
- Test Plan
후속 A2A·개인화 확장
- Experience Goal × Knowledge Graph: Context에서 목표와 실행으로
- Speaker Context Contract
- Speaker Memory Management
- TaskManager Integration
과거 설계
과거 설계는 이력 확인용이며 현재 구현 책임을 판단하는 기준으로 사용하지 않는다.