happybell80
60a892e5ab
SSOT는 로컬 0_VALUE/. GitHub URL은 복사본 참조로 SSOT 원칙 위반. 02_Governance는 존재하지 않는 구 경로로 전부 깨진 링크. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
53 lines
1.7 KiB
Markdown
53 lines
1.7 KiB
Markdown
---
|
|
tags: [workflow, rag, embedding, bridge, companyx]
|
|
type: workflow
|
|
last_updated: 2026-03-22
|
|
---
|
|
|
|
# 임베딩 브리지
|
|
|
|
## 목적
|
|
- 워크플로우에서 임베딩 서비스를 호출하는 공통 접점을 정의한다.
|
|
- RAG 인덱싱과 검색에서 같은 임베딩 계약을 사용하게 한다.
|
|
|
|
## 상위 원칙
|
|
- [RAG Workflow Index](./README.md)
|
|
- [infrastructure-ssot-principle.md](../../../../0_VALUE/20_Governance/infrastructure-ssot-principle.md)
|
|
- [embedding-policy.md](../../../../0_VALUE/20_Governance/embedding-policy.md)
|
|
|
|
## 입력
|
|
- API 키 또는 인증 정보
|
|
- 입력 텍스트 또는 멀티모달 payload
|
|
- 출력 차원
|
|
- 작업 유형
|
|
|
|
## 출력
|
|
- 임베딩 벡터
|
|
- 사용한 모델명
|
|
- 실패 시 오류 원인
|
|
|
|
## 처리 순서
|
|
1. 워크플로우 입력을 임베딩 API 형식으로 변환한다.
|
|
2. 외부 임베딩 API를 호출한다.
|
|
3. 응답 벡터를 정규화한다.
|
|
4. 호출 결과를 다음 단계로 넘긴다.
|
|
|
|
## 실패 분기
|
|
- 인증 정보가 없으면 호출하지 않는다.
|
|
- 모델명 또는 차원 값이 맞지 않으면 저장 전에 실패한다.
|
|
- 응답 파싱 실패를 성공처럼 반환하지 않는다.
|
|
|
|
## 현재 기준
|
|
- 임베딩 브리지는 워크플로우에서 공용 접점이다.
|
|
- 차원과 모델은 별도 SSOT와 정합해야 한다.
|
|
- 문서 인덱싱과 검색이 같은 임베딩 기준을 써야 한다.
|
|
|
|
## 검증 기준
|
|
- 임베딩 호출이 정상 응답을 반환하는지 확인한다.
|
|
- 차원 불일치가 있으면 즉시 실패하는지 확인한다.
|
|
- RAG 인덱싱과 검색이 같은 모델 계약을 쓰는지 확인한다.
|
|
|
|
## 관련 문서
|
|
- [RAG 업로드·인덱싱 파이프라인](./rag_upload_indexing_pipeline.md)
|
|
- [RAG 검색·Grounding 요청](./rag_search_grounding_request.md)
|