본문으로 건너뛰기

AI Providers

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

개요​

AI Chat / RAG / 임베딩 등 GenD 의 모든 LLM 호출이 사용하는 외부 모델 endpoint 를 등록·관리합니다. Vault KV2 resolver 가 API key 를 런타임에 주입하며, 등록 시 healthcheck 자동 실행으로 자격 유효성 검증합니다.

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

주요 기능​

  • Provider 등록 (OpenAI / Anthropic / OpenRouter / 자체 호스팅)
  • 유형별 분기 — LLM / VLM / Embedding
  • API key Vault 참조 + 자동 healthcheck
  • Provider 비활성화 / 삭제 (soft delete 보존)

기본 사용 흐름​

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

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

관련 API​

/api/v1/admin/llm-providers

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

관련 가이드​