본문으로 건너뛰기

AI Bindings

stub 가이드 (이슈 #1403 pattern — cycle 19 신규) — cycle 18 PR #1452 의 패턴으로 작성된 minimum-viable 가이드. 실제 사용 데이터가 표시된 스크린샷은 운영 시드 작업 (#1159) 후 후속 사이클에서 추가됩니다.

개요​

use_case (RAG / agent / 임베딩 등) × workspace 별로 어느 provider 를 사용할지 라우팅 규칙을 정의합니다. workspace 별 token 사용량 추적과 결합하여 다중 테넌트 비용 분리도 가능합니다.

  • 메뉴 경로: /admin/llm-bindings
  • 서비스 도메인: Admin (LLM Provider 관리, Epic #1414)

주요 기능​

  • use_case 매트릭스 — 예: rag, schema-graph, agent-chat
  • workspace 별 provider 라우팅
  • default provider fallback
  • binding 추가 / 변경 / 삭제 (workspace admin)

기본 사용 흐름​

  1. 사이드바 또는 직접 URL 로 페이지 진입
  2. 헤더 영역의 새로 만들기 / 새로고침 등 CTA 로 데이터 작업
  3. 행/카드에 hover 하여 노출되는 액션 (상세 / 수정 / 삭제 등) 으로 개별 항목 관리

destructive 액션 (삭제) 은 다이얼로그 confirm 이 필수이며, 가능한 경우 soft delete 로 동작합니다.

관련 API​

/api/v1/admin/llm-bindings, /api/v1/llm-bindings/effective

상세 응답 스키마는 API Reference 의 해당 라우터 섹션을 참조하세요.

관련 가이드​