DOCS/workflow/03_rag/skill_embedding_bridge.md

tags, type, last_updated

tags	type	last_updated
workflow rag embedding bridge companyx	workflow	2026-03-22

임베딩 브리지

목적

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

상위 원칙

• RAG Workflow Index
• infrastructure-ssot-principle.md
• embedding-policy.md

입력

• API 키 또는 인증 정보
• 입력 텍스트 또는 멀티모달 payload
• 출력 차원
• 작업 유형

출력

• 임베딩 벡터
• 사용한 모델명
• 실패 시 오류 원인

처리 순서

1. 워크플로우 입력을 임베딩 API 형식으로 변환한다.
2. 외부 임베딩 API를 호출한다.
3. 응답 벡터를 정규화한다.
4. 호출 결과를 다음 단계로 넘긴다.

실패 분기

• 인증 정보가 없으면 호출하지 않는다.
• 모델명 또는 차원 값이 맞지 않으면 저장 전에 실패한다.
• 응답 파싱 실패를 성공처럼 반환하지 않는다.

현재 기준

• 임베딩 브리지는 워크플로우에서 공용 접점이다.
• 차원과 모델은 별도 SSOT와 정합해야 한다.
• 문서 인덱싱과 검색이 같은 임베딩 기준을 써야 한다.

검증 기준

• 임베딩 호출이 정상 응답을 반환하는지 확인한다.
• 차원 불일치가 있으면 즉시 실패하는지 확인한다.
• RAG 인덱싱과 검색이 같은 모델 계약을 쓰는지 확인한다.

관련 문서

• RAG 업로드·인덱싱 파이프라인
• RAG 검색·Grounding 요청