Sohri Documentation

Sohri 구성 요소별 기술 문서를 제공합니다.

Sohri 코드 관계도

관리 UI와 실시간 대화 요청이 Graph Builder로 모이고, Skill 호출은 Runtime을 거쳐 Engine에서 실행됩니다.

Sohri App Frontend 관리 UI · 실시간 대화 클라이언트 sohri-app-frontend REST API WebRTC Sohri WebRTC Gateway SDP · Opus/PCM · DataChannel 브리지 sohri-webrtc-gateway WSS /sohri Sohri App Backend 인증 · 워크스페이스 · 시나리오 관리 대화용 단기 JWT 발급 sohri-app-backend Sohri Socket Backend WebSocket · DM 세션/메시지 중계 TTS · 음성 분석 연동 sohri-socket-backend Ed25519 JWT 인증 계약 Sohri PostgreSQL 사용자 · 워크스페이스 · 대화 데이터 sohri-postgres:5432/sohri JDBC Sohri Graph Builder Dialogue Manager · Scenario v2 실행 NLU · Policy · 상태 · 노드 라우팅 sohri-graph-builder POST /v1/session/validate session · message · validate 외부 음성 서비스 EPD · Vocal Biomarkers · TTS api.magovoice.com · Naver Sohri Skill Runtime Graph Builder ↔ Engine 계약 변환 프록시 sohri-skill-runtime POST /v1/skills/execute Sohri Skill Engine Skill 계약 · 구현 · 입력 검증 sohri-skill-engine POST /v1/skills/execute Skill 데이터·공공 API Skill DB · 특일 정보 · 기상 정보 special-days · weather

시스템 문서

특정 파트너나 채널에 종속되지 않는 Sohri 전체 구조와 런타임 책임을 설명합니다.

Sohri 시스템 아키텍처 핵심 서비스, 실시간 대화 흐름, 모델·외부 제공자와 책임·신뢰 경계

구성 모듈

Sohri를 구성하는 각 모듈의 설계, API, 배포 및 운영 문서입니다.

App Backend 회원 인증, 워크스페이스·API Key, 시나리오 관리와 대화·분석 결과 조회 WebRTC Gateway WebRTC 시그널링, Opus/PCM 변환, DataChannel 이벤트와 바지인·재생 상태 관리 Socket Backend 실시간 음성 WebSocket 세션, EPD·DM·TTS 오케스트레이션과 분석·종료 후처리 Graph Builder 대화 그래프, NLU, Policy, 상태 관리, API와 Scenario 문서 Skill Runtime Graph Builder와 Skill Engine 사이의 범용 Skill 실행 프록시 — 실행 계약, 배포와 운영, 릴리스 노트

API 레퍼런스

각 모듈이 외부에 제공하는 엔드포인트, 이벤트, 요청·응답 스키마를 모았습니다.

App Backend REST API 인증·회원, 워크스페이스, 시나리오, 대화·분석 /v1 엔드포인트와 권한 WebRTC Gateway API SDP offer/answer 교환 엔드포인트와 DataChannel 이벤트 Socket Backend 이벤트 /sohri WebSocket JSON 이벤트 봉투와 PCM 프레임 규약 Graph Builder API Dialogue Manager 세션·메시지·시나리오 검증 엔드포인트 Skill Runtime API Skill 실행·상태 확인 엔드포인트, 요청·응답 스키마와 오류 코드

연동 가이드

여러 Sohri 모듈 사이의 요청·응답 흐름과 연동 계약을 설명합니다.

음성 인식 처리 흐름 클라이언트 → WebRTC Gateway → Socket Backend → EPD·DM·TTS 전체 경로와 바지인 처리 Skill 실행 경로 Graph Builder → Skill Runtime → Skill Engine 요청·응답 흐름과 계약 변환 규칙