tags: [workflow, rag, embedding, bridge, companyx]

# 임베딩 브리지

## 목적
- 워크플로우에서 임베딩 서비스를 호출하는 공통 접점을 정의한다.
- RAG 인덱싱과 검색에서 같은 임베딩 계약을 사용하게 한다.

## 상위 원칙
- [RAG Workflow Index](./README.md)
- [infrastructure-ssot-principle.md](../../../../0_VALUE/02_Governance/infrastructure-ssot-principle.md)
- [embedding-policy.md](../../../../0_VALUE/02_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)
