문서 홈

거버넌스

LLM API 키(BYOK)

조직 수준에서 OpenAI, Anthropic, Google Gemini 등 프로바이더 키 추가: 보안, 청구, 로테이션, 문서에서 채팅 vs Vision과 전사에 대한 영향.

byokopenai api 키anthropicgeminillm 키

BYOK(Bring Your Own Key)는 FlexyAgents가 대시보드에 등록한 자격 증명(설정 → LLM API 키. 경로에 /ko/ 등 로케일 접두사가 포함될 수 있음)으로 모델 프로바이더를 호출한다는 의미입니다. 이러한 호출의 사용량은 계약에 따라 프로바이더 측에서 청구됩니다. 호스팅형 플랜에서는 플랫폼이 모델을 제공하는 경우 FlexyAgents 측 할당량이 계속 적용될 수 있습니다.

Google Gemini 키는 가져오기나 Web 크롤에서 이미지 설명(Vision) 또는 오디오/동영상 전사를 사용할 때 특히 중요합니다. 유효한 조직 Gemini 키가 있으면 이러한 기능은 키를 사용하며 FlexyAgents 플랜의 호스팅형 「이미지 인식」 또는 「미디어 전사」 할당량을 소비하지 않습니다.

키 추가 위치

대시보드 → 설정 → LLM API 키로 이동하세요(정확한 라벨은 로케일에 따라 약간 다를 수 있음). 필요한 프로바이더마다 하나의 키를 추가합니다. 키는 암호화 저장되며 권한 있는 조직 멤버만 조회하거나 교체할 수 있습니다.

저장 후 키 부족으로 실패했던 에이전트를 재테스트하기 전에 설정이 반영될 때까지 약 1분 기다리세요.

  • 지원 프로바이더에는 주요 채팅 모델(해당 시 OpenAI 호환, Anthropic, Google Gemini, UI에 표시되는 기타)이 포함됩니다.
  • 플랜이 특정 프로바이더에서 BYOK만인 경우 채팅은 FlexyAgents 호스팅형 키로 폴백하지 않습니다 — 유효한 키를 제공해야 합니다.

Gemini 및 지식 수집

이미지 가져오기와 크롤은 Gemini 없이 OCR(픽셀에서 텍스트 추출)을 실행할 수 있습니다. 선택적 Gemini Vision은 검색과 답변을 위해 더 풍부한 자연어 설명을 생성합니다 — 호스팅형 인프라에서 청구되는 경우 플랜 제한에서는 이를 「이미지 인식」이라고 합니다.

마찬가지로 활성화된 경우 오디오 및 동영상 파일은 Gemini로 전사할 수 있습니다. 조직이 Gemini 키를 제공하지 않는 한 호스팅형 플랜은 성공한 전사를 월간 「미디어 전사」 제한에 집계할 수 있습니다.

  • 가져오기 UI에서는 호스팅형 월간 이미지 인식 및 미디어 전사 사용량이 표시되어 운영자가 상한 도달 전에 파악할 수 있습니다.
  • 가져오기에서 할당량 오류가 발생하면 Gemini 키를 추가하거나 관리자에게 플랜 상한 인상을 요청하세요. OCR 전용 경로는 Vision 없이도 텍스트를 생성할 수 있습니다.

로테이션 및 인시던트 대응

LLM 키는 데이터베이스 비밀번호처럼 취급하세요: 계획적 로테이션, 유출 시 즉시 로테이션, 어떤 팀이 어떤 프로바이더 계정을 소유하는지 문서화.

키가 만료되면 영향받는 에이전트는 프로바이더 오류를 반환합니다 — 대시보드 로그를 확인하고 한 건 메시지로 채팅을 테스트한 후 프로덕션 복귀하세요.

  • 환경별(스테이징 vs 프로덕션)로 별도 키 또는 프로젝트를 사용하여 스테이징 유출이 프로덕션 지출 상한을 위험에 빠뜨리지 않도록 하세요.
  • 프로바이더 측에서 알림과 예산을 사용하세요. FlexyAgents는 클라우드 청구 안전장치를 대체하지 않습니다.

컴플라이언스 및 데이터 흐름

각 모델 프로바이더와의 DPA가 재위탁, 리전, 보존을 규정합니다. FlexyAgents는 프롬프트와 검색된 컨텍스트를 에이전트가 선택한 프로바이더로 전달합니다.

엄격한 데이터 레지던시가 필요하면 FlexyAgents 배포 옵션과 설정하는 키의 프로바이더 리전을 확인하세요.

스택 위에 구축

근거 있는 어시스턴트를 출시할 준비가 되셨나요?

체험판을 시작하거나, 롤아웃, 거버넌스, 엔터프라이즈 요건에 대해 상담하세요.