ガバナンス

LLM API キー(BYOK)

組織レベルで OpenAI、Anthropic、Google Gemini などのプロバイダーキーを追加:セキュリティ、請求、ローテーション、およびドキュメントにおけるチャット vs Vision と文字起こしへの影響。

byokopenai api キーanthropicgeminillm キー

BYOK(Bring Your Own Key)とは、FlexyAgents がダッシュボードに登録した認証情報(設定 → LLM API キー。パスには /ja/ などのロケール プレフィックスが含まれる場合があります)でモデル プロバイダーを呼び出すことを意味します。これらの呼び出しの使用量は契約に従いプロバイダー側で課金されます。ホスト型プランでは、プラットフォームがモデルを提供する場合、FlexyAgents 側のクォータが引き続き適用されることがあります。

Google Gemini キーは、インポートや Web クロールで画像説明(Vision)または音声/動画の文字起こしを使用する場合に特に重要です。有効な組織 Gemini キーがあると、これらの機能はキーを使用し、FlexyAgents プランのホスト型「画像認識」または「メディア文字起こし」クォータを消費しません。

キーの追加場所

ダッシュボード → 設定 → LLM API キーへ移動してください(正確なラベルはロケールにより若干異なる場合があります)。必要なプロバイダーごとに 1 つのキーを追加します。キーは暗号化して保存され、権限のある組織メンバーのみが閲覧または置換できます。

保存後、キー不足で失敗していたエージェントを再テストする前に、設定が反映されるまで 1 分ほどお待ちください。

  • サポート対象プロバイダーには、主要なチャット モデル(該当する場合は OpenAI 互換、Anthropic、Google Gemini、UI に表示されるその他)が含まれます。
  • プランが特定プロバイダーで BYOK のみの場合、チャットは FlexyAgents ホスト型キーにフォールバックしません — 有効なキーを提供する必要があります。

Gemini とナレッジ取り込み

画像のインポートとクロールは、Gemini なしで OCR(ピクセルからのテキスト抽出)を実行できます。オプションの Gemini Vision は、検索と回答のためにより豊富な自然言語説明を生成します — ホスト型インフラで課金される場合、プラン制限ではこれを「画像認識」と呼びます。

同様に、有効化されている場合、音声および動画ファイルは Gemini で文字起こしできます。組織が Gemini キーを提供しない限り、ホスト型プランは成功した文字起こしを月次の「メディア文字起こし」制限にカウントする場合があります。

  • インポート UI では、ホスト型の月次画像認識およびメディア文字起こし使用量が表示され、運用者が上限到達前に把握できます。
  • インポートでクォータ エラーが発生した場合、Gemini キーを追加するか、管理者にプラン上限の引き上げを依頼してください。OCR のみのパスは Vision なしでもテキストを生成できます。

ローテーションとインシデント対応

LLM キーはデータベース パスワードのように扱ってください:計画的なローテーション、漏洩時の即時ローテーション、どのチームがどのプロバイダー アカウントを所有するかの文書化。

キーが期限切れになると、影響を受けるエージェントはプロバイダー エラーを返します — ダッシュボード ログを確認し、1 件のメッセージでチャットをテストしてから本番復帰してください。

  • 環境ごと(ステージング vs 本番)に別のキーまたはプロジェクトを使用し、ステージングの漏洩が本番の支出上限を危険にさらさないようにしてください。
  • プロバイダー側でアラートと予算を使用してください。FlexyAgents はクラウド請求の安全装置に代わるものではありません。

コンプライアンスとデータフロー

各モデル プロバイダーとの DPA が、再委託先、リージョン、保持を規定します。FlexyAgents はプロンプトと取得したコンテキストを、エージェントが選択したプロバイダーへ転送します。

厳格なデータレジデンシーが必要な場合、FlexyAgents のデプロイ オプションと、設定するキーのプロバイダー リージョンを確認してください。

自社スタックで構築

根拠のあるアシスタントを本番投入する準備はできましたか?

トライアルを開始するか、展開、ガバナンス、エンタープライズ要件についてご相談ください。