Hyosung / Ask Hyobee / HSGC

wrtn.ai 도메인과 효성 내부망 연결 구조

제공받은 OpenAPI, 로컬 레퍼런스 코드, 캡처 내용을 기준으로 요청 구조를 정리한다. 핵심은 wrtn.ai 도메인이 보인다고 해서 API가 효성과 무관한 범용 API라는 뜻은 아니며, hsgc-demo 뒤에는 효성 전용 Groupware Chatbot API가 노출되어 있다는 점이다.

OpenAPI Hyosung Groupware Chatbot API Gateway URL ax-api-gateway.wrtn.ai/hsgc-demo Path 49개 추가 범위 Excel Agent Admin + 기존 RAGAS 평가

한 줄 결론

ax-api-gateway.wrtn.ai/hsgc-demo는 Wrtn 도메인으로 노출된 Gateway URL이고, 그 뒤에 붙은 API는 효성 내부 데이터/인프라와 연결되는 Hyosung Groupware Chatbot API로 보는 것이 맞다. 즉, 데모용/벤더 Gateway 경로일 수는 있지만 효성과 무관한 API는 아니다.

아키텍처 다이어그램

드래그로 이동 · 마우스 휠로 확대/축소 신규 개발 확인 필요
110% 
flowchart LR
  %% Hyosung Ask Hyobee / HSGC request structure

  USER["사용자"] --> BROWSER["사용자 브라우저
질문 · 파일 · SSE"]
  BROWSER --> SHELL["효성 그룹웨어 Shell
VOB / C-Cube · Ask Hyobee UI"]

  SHELL -- "1. HTTPS / SSE" --> GATEWAY["Wrtn Domain Gateway
ax-api-gateway.wrtn.ai"]
  GATEWAY -- "2. /hsgc-demo route" --> HSGC["Hyosung Groupware
Chatbot API
OpenAPI 49 paths"]
  GATEWAY -. "파악 필요" .-> GWCHECK(["확인 필요
Gateway 배치/소유"])

  SHELL -. "8. SSO / 사내 파일" .-> ADFS["ADFS · HiCloud
사용자 인증 / 파일"]

  HSGC --> CHAT["Chat API
대화 · 메시지 · SSE"]
  HSGC --> DEEP["Deep Research
검색 · 분석"]
  HSGC --> ADMIN["Admin API
Embedding · Metrics"]
  HSGC --> RND["Research API
Journal · Report"]

  CHAT -- "3. LLM 호출" --> LITELLM["LiteLLM Proxy
Multi LLM Orchestrator"]
  DEEP -- "3. 검색/도구" --> MCP["MCP Gateway
Search · Tools"]
  DEEP --> CRAWLER["Crawler / Docling
크롤링 · 문서 변환"]

  CHAT -- "5. 내부 RAG 검색" --> OPENSEARCH["OpenSearch
Vector Search"]
  ADMIN -- "5. 임베딩/지표" --> OPENSEARCH
  ADMIN --> CRAWLER

  HSGC --> POSTGRES["PostgreSQL + PGVector
대화 · 로그 · 임베딩"]
  HSGC --> REDIS["Redis
cache · memory · interrupt"]
  HSGC --> MSSQL["MSSQL
그룹웨어 원본 DB
읽기 전용"]

  ADMINUSER["운영자 브라우저"] --> OPSADMIN["신규/확장 Admin UI
Excel Agent Admin
RAGAS Dashboard"]
  OPSADMIN -- "기존 지표/임베딩" --> ADMIN
  CHAT -- "RAG 평가 대상
질문 · 답변 · context" --> RAGAS["신규 개발
RAGAS Assessment API/Engine
기존 사내검색 RAG 평가"]
  OPSADMIN -- "평가 설정/조회" --> RAGAS
  RAGAS --> POSTGRES

  SHELL -. "신규 Excel 화면" .-> EXCELFRONT["신규 개발
Excel Chat UI
업로드 · 시트 렌더링"]
  EXCELFRONT --> DUCKDB["신규 브라우저 모듈
DuckDB-WASM + Univer.js
Excel 원본 서버 미전송"]
  EXCELFRONT -- "schema_context / 질문" --> EXCEL["신규 개발
Excel Agent API
SQL 생성 · 요약 · 로그"]
  HSGC -. "Agent API 확장" .-> EXCEL
  OPSADMIN -- "Agent 설정/로그" --> EXCELADMIN["신규 개발
Excel Agent Admin API
파서 정책 · 실행 로그 · 샘플 테스트"]
  EXCEL --> EXCELADMIN
  EXCELADMIN --> POSTGRES

  classDef user fill:#eef3ff,stroke:#6b8cff,color:#2f3440,stroke-width:1.4px;
  classDef gateway fill:#fff5e6,stroke:#f5a33b,color:#2f3440,stroke-width:1.4px;
  classDef api fill:#eefbf5,stroke:#36b678,color:#2f3440,stroke-width:1.4px;
  classDef infra fill:#f1edff,stroke:#9670ff,color:#2f3440,stroke-width:1.4px;
  classDef data fill:#fff6df,stroke:#d49a34,color:#2f3440,stroke-width:1.4px;
  classDef add fill:#ffe4e8,stroke:#e5484d,color:#202938,stroke-width:3px;
  classDef newtech fill:#fff1d6,stroke:#e5484d,color:#202938,stroke-width:2.4px;
  classDef verify fill:#ffeded,stroke:#d92d20,color:#7a1f17,stroke-width:2.8px;

  class USER,BROWSER,SHELL,ADMINUSER user;
  class GATEWAY gateway;
  class HSGC,CHAT,DEEP,ADMIN,RND api;
  class LITELLM,MCP,CRAWLER,ADFS infra;
  class OPENSEARCH,POSTGRES,REDIS,MSSQL data;
  class DUCKDB newtech;
  class OPSADMIN,EXCELFRONT,EXCEL,EXCELADMIN,RAGAS add;
  class GWCHECK verify;
확인 필요 Gateway 배치/소유
세부 설계는 W1 환경·설계 단계에서 Gateway 배치 위치, LiteLLM/MCP 접근 권한, Excel 원본 저장 정책을 확인한 뒤 확정한다.
# 연결 의미
1 효성 UI → ax-api-gateway.wrtn.ai 사용자 브라우저와 그룹웨어 Shell에서 Wrtn 도메인 Gateway로 요청한다.
2 Wrtn Gateway → /hsgc-demo API Gateway 뒤에는 OpenAPI title 기준 Hyosung Groupware Chatbot API가 노출되어 있다.
3 HSGC API → LiteLLM / MCP LLM 호출과 검색/도구 호출은 LiteLLM Proxy 및 MCP Gateway를 통해 처리되는 구조로 판단된다.
4 Deep Research / Embedding → Crawler / Docling 검색, 크롤링, 문서 변환, 임베딩 작업이 내부 마이크로서비스와 연결된다.
5 Admin / 검색 → PostgreSQL / OpenSearch 대화 로그, PGVector, 내부 문서 벡터 검색, 검색 품질 지표와 연결된다.
6 챗봇 Front Excel UI → DuckDB-WASM / Univer.js Excel 원본 파싱, 로컬 테이블 로드, 시트 렌더링은 브라우저 내부에서 처리하고 서버에는 schema context와 질의만 전달하는 구조가 기본안이다.
7 신규/확장 Admin UI → 기존 Admin API / Excel Agent Admin API / RAGAS Assessment Admin UI는 런타임 API 뒤에 직렬로 붙는 컴포넌트가 아니라 운영자 화면이다. 이 화면에서 Excel Agent 설정/로그와 기존 RAG용 RAGAS 평가 대시보드를 함께 제공한다.
8 /hsgc-demo 운영 위치 Wrtn 도메인은 확인되지만, 실제 운영 서버가 Wrtn 인프라인지 Gateway만 Wrtn인지 확인이 필요하다.
9 ADFS / HiCloud / 그룹웨어 내부망 사용자/조직 권한, 사내 파일, 그룹웨어 원본 데이터와 연결되므로 효성 내부망 연동형 API로 보는 것이 맞다.
wrtn.ai 도메인
외부에서 보이는 Gateway/Ingress 계층이다.
hsgc-demo API
OpenAPI title이 Hyosung Groupware Chatbot API로 확인된다.
내부망 연결
사용자/조직 JWT, 그룹웨어 데이터, 검색/임베딩 인프라와 연결된다.

왜 wrtn.ai 도메인인가?

확인됨

OpenAPI는 효성 전용

JSON의 title이 Hyosung Groupware Chatbot API이고, API path가 효성 챗봇, 관리자, R&D 기능으로 구성되어 있다.

추정

Wrtn Gateway가 앞단

ax-api-gateway.wrtn.ai는 벤더가 운영하는 Gateway/Ingress 주소로 보인다. 그 뒤에서 효성 전용 API를 라우팅하거나 프록시하는 구조일 가능성이 높다.

확인 필요

운영 배치 방식

실제 backend가 Wrtn 인프라에 배포되어 있는지, 효성 내부망에 있고 Gateway만 Wrtn인지, 또는 demo 환경만 Wrtn 도메인으로 노출한 것인지는 네트워크/배포 담당 확인이 필요하다.

API 근거

구분 확인된 API 해석
문서 정체 info.title = Hyosung Groupware Chatbot API Wrtn 범용 API가 아니라 효성 그룹웨어 챗봇 API 문서다.
대화/채팅 /api/v1/conversations, /api/v1/conversations/{id}/ai-chat 대화 CRUD와 일반 AI Chat SSE가 이미 문서화되어 있다.
Deep Research /api/v1/conversations/{id}/ai-chat/deep-research Deep Research는 미연동이 아니라 OpenAPI에 존재하는 기능이다.
Admin /api/v1/admin/embedding-jobs, /api/v1/admin/metrics/* 임베딩 현황/크롤링 트리거/사용 지표 API가 이미 있다.
R&D /api/v2/rnd/journal/*, /api/v2/rnd/reports/* 논문/특허/기사, AI 요약, 리포트 기능 API가 이미 있다.
파일 FileData.content = Base64 encoded file 파일은 multipart가 아니라 JSON body 안의 Base64 데이터 구조로 API에 들어간다.
사용자/조직 user_id, corp_code, pg_code, pu_code, team_code는 JWT에서 추출 효성 내부 사용자/조직 권한을 전제로 한 API 구조다.

Excel Agent / 기존 RAGAS 평가 추가 위치

[기존 Hyosung Groupware Chatbot API]
  - Chat
  - Deep Research
  - R&D Journal
  - Report
  - Admin Embedding
  - Admin Metrics

[추가 제안 범위]
  - Chatbot Front Excel UI
      * Excel 업로드/검증
      * 브라우저 내부 SheetJS 파싱
      * DuckDB-WASM 로컬 테이블 로드
      * Univer.js 시트 렌더링
      * schema_context 생성
      * Excel 원본 서버 미전송 기본 정책
  - Excel Agent 실행 API
      * schema_context + 사용자 질문 기반 SQL 생성
      * DuckDB 실행 결과에 대한 자연어 요약/인사이트
      * 실행 로그/오류 로그/품질지표 저장
  - 신규/확장 Admin UI
      * 기존 Admin 지표/임베딩 메뉴 연계
      * Excel Agent Admin 메뉴
      * RAGAS Assessment Dashboard 메뉴
  - Excel Agent Admin API
      * Agent 설정
      * Excel 파서/시트/컬럼 매핑
      * 용어사전/지표/집계 설정
      * 샘플 질의 테스트
      * 실행 로그
  - RAGAS Assessment API/Engine
      * 평가 대상/샘플링
      * Faithfulness / Answer Relevance / Context Precision / Context Recall
      * Human Review
      * LLM Judge
      * Golden Set / A-B 비교
  - Excel 품질지표와 RAGAS 평가지표는 분리 저장
  - 관리자 화면에서는 Excel Agent Admin과 RAGAS Assessment를 병렬 메뉴로 제공

정리

도메인만 보면 외부처럼 보이는 이유

URL의 hostname이 wrtn.ai이므로 Gateway/Ingress는 Wrtn 쪽 도메인이다. 이 레이어는 벤더가 노출한 데모 또는 프록시 주소일 수 있다.

그래도 효성 내부망 연동형 API인 이유

API 내용은 효성 전용이고, 사용자/조직 코드를 JWT에서 추출하며, 게시판 권한, 내부검색, 임베딩, R&D, 리포트, 관리자 지표가 효성 업무 데이터 흐름과 연결되어 있다.

Sources: 제공 OpenAPI https://ax-api-gateway.wrtn.ai/hsgc-demo/openapi.json, Redoc URL, hyosung/reference/groupware-chat-backend-develop, hyosung/reference/BackEnd_20260415.