LLM Wiki

← Docs hub

SK-Intellix A2A Knowledge Hub

이 페이지는 현재 작업 중인 SK-Intellix Cloud A2A, 온디바이스 브릿지, DeviceAgent TaskManager, SoC 연동, 메모리/개인화 설계를 찾아가기 위한 브라우저용 진입점이다.

상위 도메인 분리는 SK-Intellix Engineering Knowledge Hub에서 본다. 이 페이지는 그중 Cloud A2A와 A2A에 직접 연결된 실행/계약 문서를 다루는 하위 허브다.

현재 이 세션에서는 fallback 정적 서버가 http://127.0.0.1:8767/에 떠 있다. 바로 보려면 http://127.0.0.1:8767/docs/a2a/로 들어간다.

먼저 볼 순서

  1. 전체 구조: Cloud A2A가 사용자 발화를 plan/task로 바꾸고, 온디바이스와 DeviceAgent가 실행하는 구조를 본다.
  2. 판단 구조: Planner/Router가 route family와 multi-step plan을 어떻게 고르는지 본다.
  3. 계약 구조: Cloud, 온디바이스, DeviceAgent 사이 payload와 event 계약을 본다.
  4. 프로젝트 위치: 실제 소스가 어느 repo/파일에 있는지 찾는다.
  5. 검증 상태: ADB/실기기 E2E에서 무엇을 확인해야 하는지 본다.

핵심 목차

주제 봐야 하는 내용
5분 요약 A2A Executive Summary
전체 그림 Book Roadmap, System Overview
Speech-LLM 운영 구조 Speech-LLM Context-Aware A2A Architecture
역할별 읽기 경로 A2A Role-Based Reader Paths
전역 위키 운영 A2A Global Wiki Operations
접속/서버 상태 Local Access Guide
시각 지도 Visual Map
용어/개념 색인 A2A Glossary and Concept Index
항목별 구조도 Architecture Diagrams
판단 구조 Planner and Routing
계층 간 계약 Contract Matrix
복합명령/기기 실행 Device Task Flow
실제 예시 흐름 Scenario Walkthroughs
19.comToMe 예시 19.comToMe A2A Workflow Example
19.comToMe 구현 계약 19.comToMe DeviceAgent Contract
실제 소스 위치 Source Map
근거 색인 A2A Evidence Index
요구사항 추적 Requirements Traceability Matrix
다음 액션 보드 A2A Next Action Board
검증 Validation Guide
업체 전달 Vendor Handoff
업체 구현 패키지 DeviceAgent Vendor Implementation Package
DeviceAgent API DeviceAgent TaskManager API Contract
TaskManager Framework 상세 DeviceAgent TaskManager Framework Wiki
Task Executor Wiring DeviceAgent Task Executor Wiring Wiki
LLM/MCP -> TaskManager 매핑 TaskManager LLM/MCP Mapping Wiki
Task 완료/Callback 계약 TaskManager Callback Completion Wiki
업체 구현 체크리스트 TaskManager Vendor Implementation Checklist
SoC TaskManager 큰 기능 SoC TaskManager Execution Subsystem
DeviceAgent/SoC 도메인 DeviceAgent / SoC Domain Map
업체 API 인수 기준 Vendor API Acceptance Checklist
업체 테스트 증거 양식 Vendor Test Evidence Template
업체 미확정 질문 Vendor Open Questions
현재 상태/공백 Status and Gap Audit
문서 품질 감사 Documentation Quality Audit
업무 분장 Work Breakdown
메모리/개인화 Memory and Personalization
메모리 DB/동기화 Memory DB and Sync Contract
라우터 성능 Benchmark and Router Evolution

프로젝트별 진입점

Cloud A2A

대표 repo:

핵심 파일:

gemini/a2a/planner/main_router_api.py
gemini/a2a/planner/assets/main_router.system_prompt.txt
gemini/a2a/runtime/orchestrator.py
gemini/a2a/runtime/task_manager.py
gemini/a2a/runtime/workflow_state.py

보는 순서:

  1. Planner가 turn_mode, selected_routes, steps를 만든다.
  2. Runtime이 planner 결과를 agent step과 device_task_requests로 변환한다.
  3. Workflow state가 task event를 받아 완료/실패/replan 필요 여부를 판단한다.

On-device Agent Bridge

대표 repo:

핵심 파일:

ForegroundService.kt
CloudIntentWorkflowRunner.kt
DeviceIntentExecutor.kt
DeviceCommandSink.kt
DeviceCommunicator.kt
CloudDeviceTaskRequests.kt
ManagedDeviceTask.kt

보는 순서:

  1. Cloud 응답의 device_task_requests를 받는다.
  2. device_intent_step을 CloudIntentWorkflowRunner가 순차 workflow로 실행한다.
  3. 실제 device token 또는 task request를 DeviceAgent 쪽으로 전달한다.
  4. 정상 진행 이벤트는 로컬에서 처리하고, replan이 필요한 이벤트만 Cloud로 올린다.

DeviceAgent / SoC

대표 repo:

핵심 파일:

TaskManager.java
TaskReasonContract.java
DevicePlanningContextProvider.java
TaskIngressClassifier.java
TaskEventListener.java
MainApi.java

보는 순서:

  1. TaskManager가 task/workflow queue와 상태를 관리한다.
  2. DevicePlanningContextProvider가 Cloud 계획 전에 필요한 최소 기기 상태 snapshot을 제공한다.
  3. 실패/차단/일시중단 이벤트는 reason_code, reason_params, requires_cloud_decision으로 올라간다.

Test / Benchmark

대표 위치:

test/A2A_TEST/benchmarks
test/A2A_TEST/organized
test/test_device_e2e_*.py
test/test_task_event_*.py

보는 순서:

  1. Family routing 성능은 benchmark 결과로 본다.
  2. 복합명령은 planner output, device request 변환, workflow runner 순서로 본다.
  3. 실기기 검증은 ADB 연결 후 E2E audit로 확인한다.

현재 구현 상태 요약

브라우저에서 찾는 방법

  1. 현재 세션에서는 http://127.0.0.1:8767/index.html을 연다.
  2. 상단 메뉴에서 Docs를 누른다.
  3. SK-Intellix A2A Knowledge Hub를 누른다.
  4. 더 빠르게 보려면 바로 http://127.0.0.1:8767/docs/a2a/로 들어간다.

기본 llmwiki serve 포트는 보통 8765다. 포트가 점유되어 있거나 접속이 안 되면 Local Access Guide를 따른다.

빠른 URL

원본 위키 파일 위치

상세 문서는 아래 markdown 파일들에 정리되어 있다. 현재 정적 사이트의 일반 Home은 세션 중심 화면이라, 상세 위키 파일은 Graph/Search와 이 Hub를 함께 사용해서 접근한다.

/home/silogood/.local/share/llm-wiki-pratiyush/wiki/overview.md
/home/silogood/.local/share/llm-wiki-pratiyush/wiki/concepts/A2A Book Roadmap.md
/home/silogood/.local/share/llm-wiki-pratiyush/wiki/concepts/A2A Table of Contents.md
/home/silogood/.local/share/llm-wiki-pratiyush/wiki/concepts/Project Entry Points.md
/home/silogood/.local/share/llm-wiki-pratiyush/wiki/concepts/A2A Contract Matrix.md
/home/silogood/.local/share/llm-wiki-pratiyush/wiki/concepts/A2A Implementation Source Map.md