SK-Intellix On-device Bridge
Cloud A2A의 계획을 DeviceAgent가 소비할 수 있는 Task·Workflow로 변환하고, 기기 event를 Cloud workflow와 사용자 응답에 다시 연결하는 경계다.
핵심 흐름
Cloud plan and device requests
-> response parsing and contract mapping
-> DeviceAgent TaskManager dispatch
-> local progress handling
-> terminal event correlation
-> user response or bounded Cloud decision
기준 문서
| 목적 | 문서 |
|---|---|
| 전체 폐루프 | Cloud·On-device·TaskManager Closed Loop |
| 세 계층 데이터 흐름 | Cloud-On-device-DeviceAgent Data Flow |
| payload와 correlation | Contract Matrix |
| context 최신성 | Device Source Freshness Contract |
| 구현 소스 | Source Map |
| Text E2E | A2A Text E2E Console |
| 실제 voice 동등성 | Voice Parity Audit |
| 음성 세션 종료 | TTS Lifecycle Recovery |
| release APK 복구 | System APK Release Recovery |
책임 경계
| 포함 | 제외 |
|---|---|
| Cloud response parsing과 schema 변환 | route family와 목표 판단 |
| Task·Workflow 전달과 ID 보존 | DeviceAgent queue와 도메인 기능 구현 |
| 정상 progress의 local 처리 | 모든 event의 LLM 재호출 |
| terminal failure의 Cloud relay | 물리 완료의 임의 추정 |
| voice session과 Task pause/resume 연결 | 업체 acceptance 증거 대체 |
대표 소스
~/work/2.A1_LLM_Aent/skmagic_ondeviceai_agent
ForegroundService.kt
CloudIntentWorkflowRunner.kt
DeviceIntentExecutor.kt
DeviceCommandSink.kt
DeviceCommunicator.kt
CloudDeviceTaskRequests.kt
ManagedDeviceTask.kt
정상 QUEUED, RUNNING, PROGRESS와 고정된 dependency 진행은 로컬에서 처리한다.
FAILED, BLOCKED, TIMEOUT, 사용자 변경처럼 의미 판단이 필요한 경우만 Cloud에
전달한다. post-STT text test와 실제 wake word·audio·STT 경로는 별도로 검증한다.