SK-Intellix A2A Knowledge Hub
Cloud A2A가 발화와 context를 해석해 Agent·Skill과 실행 단계를 구성하고, On-device bridge와 DeviceAgent가 이를 실제 기능으로 수행한 뒤 결과를 다시 계획 상태에 반영하는 전체 구조의 진입점이다.
상위 도메인과 다른 프로젝트는 SK-Intellix Engineering Knowledge Hub에서 본다.
처음 읽는 순서
| 순서 | 문서 | 핵심 질문 |
|---|---|---|
| 1 | System Overview | A2A 전체 구성과 책임은 무엇인가? |
| 2 | Speech-LLM Context-Aware Architecture | STT, context, memory와 Planner는 어떻게 이어지는가? |
| 3 | Planner and Routing | route family, owner Agent와 Skill은 어떻게 선택되는가? |
| 4 | Planner Deep Dive | 실제 catalog, prompt, schema와 runtime은 어떻게 동작하는가? |
| 5 | TaskManager 기준 사양서 | 기기 계획은 어떻게 안전한 실행으로 바뀌는가? |
| 6 | Experience Goal AS-IS / TO-BE | 단일 turn을 넘어 목표와 결과를 어떻게 유지하는가? |
| 7 | Runtime Validation Closure | 현재 구현, 실기기 증거와 남은 No-Go는 무엇인가? |
영역별 진입점
Architecture and Product
| 목적 | 문서 |
|---|---|
| 전체 책 구조 | Book Roadmap |
| 발표용 흐름 | A2A Presentation Storyline |
| 제품 요구사항 | A2A Product PRD |
| 도입 전후 효과 | A2A Before/After Impact |
| 역할별 읽기 | Role-Based Reader Paths |
| 용어 | Glossary and Concept Index |
Planner and Routing
| 목적 | 문서 |
|---|---|
| 판단 구조 | Planner and Routing |
| 구현 상세 | Planner Deep Dive |
| 의미 경계 조정 | Semantic Boundary Calibration |
| 축 튜닝 cycle | Router Axis Tuning Roadmap |
| follow-up | Follow-up Question Strategy |
| 기준선 | Planner-TaskManager Baseline Readiness |
Experience Goal
| 목적 | 문서 |
|---|---|
| Experience 의미·AS-IS/TO-BE | Experience Goal AS-IS / TO-BE |
| 목표·관찰·재계획 | Experience Supervisor |
| 이론과 현재 구현 | Experience Workflow Design Foundations |
| 기존 Planner와 통합 | Existing Planner Integration |
| 실사용·사용성 | Usability Playbook |
| 학술적 정리 | Academic Deep Dive |
| live 판정 | Runtime Validation Closure |
Agentic Scenario and Capability Evidence
| 목적 | 문서 |
|---|---|
| 대표 생활 경험 | Adaptive Welcome & Care Supervisor |
| 보안·순찰 목표 | Adaptive Home Guardian Supervisor |
| 공간 행동 아이디어 | Experience Creative Motion Scenarios |
| DeviceAgent 실행·관찰 원장 | Agentic I/O Coverage Matrix |
| capability 변경 근거 | Agentic Capability Change Ledger |
Device Execution and TaskManager
| 목적 | 문서 |
|---|---|
| Core 전체 규범 | TaskManager 기준 사양서 |
| Cloud·On-device 폐루프 | Voice TaskManager Closed Loop |
| DeviceAgent API | DeviceAgent TaskManager API Contract |
| 시스템 앱 API | TaskManagerClient AAR API |
| context 기반 계획 | Device Context Planning Spec |
| capability 조합 | Capability Composition Catalog |
| PUI·Voice 경계 | PUI and Voice Task Design Hub |
| 실행 모니터 | TaskManager Live Monitor · Task Monitor UI |
| LLM/MCP 표현 | TaskManager LLM/MCP Mapping |
On-device Bridge and Console
| 목적 | 문서 |
|---|---|
| bridge 구조 | On-device Bridge |
| Text E2E 계약 | A2A Text E2E Console |
| 테스트 화면 | A2A Text Console |
| 계층 간 계약 | Contract Matrix |
| 소스 위치 | Source Map |
Validation, Vendor and Operations
| 목적 | 문서 |
|---|---|
| 요구사항 추적 | Requirements Traceability |
| 검증 기준 | Validation Guide |
| 성공 기준 | A2A Success Criteria |
| 현재 공백 | Status and Gap Audit |
| 업체 전달 | Vendor Handoff |
| 업체 구현 패키지 | Vendor Implementation Package |
| 다음 과제 | Next Action Board |
| 문서 운영 | Global Wiki Operations |
코드 진입점
| 영역 | 저장소 | 핵심 경로 |
|---|---|---|
| Cloud A2A | ~/work/8.cloudLLM/backend-cloud-llm-lambda |
gemini/a2a/planner, gemini/a2a/runtime |
| On-device | ~/work/2.A1_LLM_Aent/skmagic_ondeviceai_agent |
ForegroundService, CloudIntentWorkflowRunner, DeviceCommunicator |
| DeviceAgent | ~/work/1.A1_SoC_new/SoC/a1-packages-mr6 |
apps/DeviceAgent, apps/TaskManagerClient |
| Test | Cloud repo와 A2A test assets | planner, task-event, E2E와 benchmark tests |
현재 판단 원칙
- catalog와 owner selection이 Agent·Skill 책임을 정하고 Planner가 실행 구조를 만든다.
- 정상 Task progress는 Cloud LLM을 반복 호출하지 않는다.
- 실패·차단·사용자 변경처럼 의미 판단이 필요한 event만 제한적으로 재계획한다.
- capability source 존재, Task wiring, 실기기 실행과 positive detection을 구분한다.
- 컴파일·unit test·dry-run은 실기기 물리 완료의 대체 증거가 아니다.
- 문서의 최신 상태 주장은 source, test artifact 또는 board evidence와 연결한다.
찾기
문서명 전체 목록을 이 허브에 반복하지 않는다. 상단 Search에서 planner,
TaskManager, Experience, device context, validation 같은 개념으로 찾고,
도메인 전체 순서는 SK-Intellix Domain Reading Order를
사용한다.