SK-Intellix Cross-Domain Integration Map
도메인을 분리하면 책임은 선명해지지만, 실제 제품 흐름은 여러 도메인을 건넌다. 이 문서는 도메인을 다시 섞기 위한 문서가 아니라, 분리된 도메인 사이의 발전 흐름과 연관 모듈을 보여주는 지도다.
핵심 원칙은 다음이다.
Primary domain은 하나만 둔다.
Cross-domain flow는 별도 spine으로 표현한다.
1. 대표 발전 흐름
A2A -> TaskManager -> 복합명령은 하나의 대표 예시다. 정확히는 중간에 On-device Bridge가 있고, 복합명령은 TaskManager 위의 use case다.
Speech / context input
-> A2A planner
-> A2A runtime device_task_requests
-> On-device Bridge local workflow
-> DeviceAgent TaskManager submitTask / submitWorkflow
-> DeviceAgent domain executor
-> task_event / reason_code
-> local continuation or Cloud replan
-> Composite command / scenario outcome
이 흐름을 한 도메인으로 합치면 안 된다. 합치면 다음 경계가 흐려진다.
| 단계 | Primary domain | 책임 |
|---|---|---|
| STT/딕셔너리/Cloud fallback | SPEECH |
발화를 usable text/token/rewrite 후보로 만든다 |
| Planner / route / step plan | A2A |
무엇을 어떤 순서로 할지 계획한다 |
| Device request 전달 | ONDEVICE |
Cloud output을 local workflow/token/task로 바꾼다 |
| 실행 lifecycle | TASKMANAGER |
queue, executor, callback, reason_code, cancel/timeout을 관리한다 |
| 제품 API / SDK 후보 | FRAMEWORK_SDK |
DeviceAgent API/runtime과 외부 API surface를 안정화한다 |
| HAL/BSP bring-up | AOSP_BSP |
QSSI/UM, HAL, vendor service, DTS/driver evidence를 관리한다 |
| 시나리오/복합명령 | CASES |
여러 도메인을 묶은 제품 기능 예시를 설명한다 |
2. Cross-Domain Spine 목록
| Spine | 발전 방향 | 시작 문서 | 이어서 볼 문서 |
|---|---|---|---|
| Voice-to-Plan | 음성인식 -> A2A | Speech Recognition Module | A2A Planner Deep Dive, Speech-LLM Context-Aware A2A Architecture |
| Plan-to-Device | A2A -> On-device Bridge -> TaskManager | Cloud·On-device·TaskManager Closed Loop | On-device Bridge Category, DeviceAgent TaskManager 기준 사양서 |
| Task-to-Composite Command | TaskManager -> workflow/case | DeviceAgent TaskManager 기준 사양서 | Scenario Walkthroughs, 19.comToMe Workflow Example |
| Identity-to-Personalization | 화자인식 -> Memory -> A2A/Task policy | Speaker Identity Service | Speaker Memory Management, Memory Category |
| Runtime-to-BSP | DeviceAgent runtime -> HAL/BSP | Framework and SDK Hub | AOSP and BSP Category, QCS6490 Platform Vendor Brief |
| Vendor Acceptance | 설계/계약 -> 업체 구현/evidence | Vendor Meeting Entry | Vendor Handoff, Vendor API Acceptance Checklist |
3. A2A -> TaskManager -> 복합명령 상세
이 spine은 Cloud intelligence가 실제 장기 device workflow로 바뀌는 흐름이다.
3.1 모듈 연결
| 순서 | 모듈/문서 | 산출물 | 다음 모듈이 받는 것 |
|---|---|---|---|
| 1 | Speech Recognition Module | recognized_text, processed text, token/rewrite 후보 |
A2A planner input |
| 2 | A2A Planner | turn_mode, selected_routes, steps[] |
A2A runtime |
| 3 | Cloud·On-device·TaskManager Closed Loop | device_task_requests[], depends_on, wait_policy |
On-device Bridge |
| 4 | On-device Bridge | local workflow, token/task submission, event relay | DeviceAgent TaskManager |
| 5 | DeviceAgent TaskManager 기준 사양서 | TaskRecord, queue state, onTaskEvent, reason_code |
local continuation or Cloud replan |
| 6 | Scenario Walkthroughs | device-only / mixed / cloud-only scenario outcome | product case docs |
| 7 | 19.comToMe Workflow Example | 장기 ComeToMe workflow, rollout stage, speaker gate 후보 | vendor/API/test contract |
3.2 데이터 연결
| 데이터 | 생성 owner | 소비 owner | 설명 |
|---|---|---|---|
recognized_text |
SPEECH |
A2A |
planner의 현재 발화 입력 |
steps[] |
A2A |
A2A runtime, ONDEVICE |
cloud/device step 분리와 의존성 |
device_task_requests[] |
A2A runtime |
ONDEVICE |
device 실행 요청 목록 |
token_text |
A2A runtime 또는 SPEECH adapter |
ONDEVICE, TASKMANAGER |
기존 SK token 기반 실행 입력 |
cloud_workflow_id, cloud_step_id |
A2A |
ONDEVICE, TASKMANAGER, VALIDATION |
trace와 event correlation |
submitTask, submitWorkflow |
TASKMANAGER API |
DeviceAgent runtime | 단일/복합 실행 등록 |
onTaskEvent |
TASKMANAGER |
ONDEVICE, A2A |
정상 event는 local 처리, 판단 필요 event만 replan 후보 |
reason_code, reason_params |
TASKMANAGER |
A2A, VENDOR, VALIDATION |
실패/차단 사유 구조화 |
3.3 복합명령으로 발전하는 지점
복합명령은 A2A만으로 완성되지 않는다. A2A는 “여러 step을 어떤 순서로 실행할지”를 만든다. 복합명령이 제품 기능이 되려면 TaskManager가 아래 책임을 가져야 한다.
| 필요 기능 | TaskManager 책임 |
|---|---|
| 순차 실행 | depends_on, wait_policy, step unlock |
| 장기 실행 | RUNNING, PROGRESS, timeout, cancel |
| 실패 처리 | FAILED, BLOCKED, NEEDS_USER_INPUT, reason_code |
| 정상 continuation | COMPLETED event로 다음 local step 실행 |
| replan gate | requires_cloud_decision=true인 경우만 Cloud로 올림 |
| multi-source | Cloud A2A뿐 아니라 MQTT/App/Schedule/Local Voice도 같은 lifecycle 사용 |
4. 도메인 통합이 아니라 연결 표기
아래는 문서 구조상 판단 기준이다.
| 경우 | 문서를 합칠지 | 이유 |
|---|---|---|
| A2A planner와 TaskManager API가 한 흐름에 등장 | 합치지 않음 | 판단 owner와 실행 owner가 다름 |
| 복합명령 예시가 A2A/TaskManager/화자인식을 함께 사용 | case 문서로 둠 | 제품 시나리오는 cross-domain이다 |
| AOSP HAL이 TaskManager 실행에 필요 | 합치지 않음 | platform bring-up과 runtime policy가 다름 |
| 업체 회의에서 모든 도메인을 설명 | 업체 meeting entry에서 연결 | 회의용 packet은 별도 입구가 필요 |
5. 문서에 표시해야 할 관련 모듈
교차 도메인 문서에는 아래 형식을 붙인다.
Primary domain: A2A
Related domains: SPEECH, ONDEVICE, TASKMANAGER
Upstream: Speech Recognition Module
Downstream: On-device Bridge, TaskManager
Evidence: Source and Evidence Catalog / Domain Document Map
이 표기가 있어야 도메인을 분리하면서도 실제 제품 흐름을 잃지 않는다.