AIワークフローのモデルと変数
AIワークフローのモデルと変数は、AI Flowi Workflowでモデルプロバイダーや再利用できる値をコンポーネントのフィールドに結び付けます。APIハブでは、マネージドアクセス、またはワークスペースで用意したプロバイダーキーを使用できます。対応するコンポーネントのフィールドでは、ワークフローに値を埋め込む代わりに、名前を指定してGlobal Variablesを読み込めます。
執筆：Ai Flowi · 技術レビュー：Janice Lee、Ai Flowiのテクニカルサポート。
公開日 · 更新日
製品： Ai FlowiのAI Flowi Workflow · 設定内容：モデルへのアクセスと再利用できる値
APIハブのモデルプロバイダー
APIハブのカタログには、OpenAI、Anthropic、Google Gemini、DeepSeek、Groq、OpenRouterが含まれています。モデルを呼び出すには、事前にプロバイダーへの経路を設定して有効にする必要があります。ワークスペースに表示されるカタログを確認してください。カタログに掲載されているだけでは、プロバイダーが有効になっているとは限りません。
Flowi AIコンポーネントは、Model選択欄に表示するためにAPIハブの言語モデルカタログを読み込みます。モデル呼び出しには、選択したカタログ項目を使用します。この選択欄があるからといって、掲載されたプロバイダーのすべてのモデルやメディア機能が利用できるわけではありません。
マネージドアクセスとAPIキーの持ち込み（BYOK）
APIハブのマネージド呼び出しでは、モデルの費用にFlowi Tokensを使用します。マネージドキーはワークスペースに属し、許可するAPIやトークン予算を制限できます。マネージドアクセスでは、Flowi AIコンポーネント内にプロバイダーキーを入力する必要はありません。
APIキーの持ち込み（BYOK）では、ワークスペースに保存したプロバイダーキーを使います。APIハブはそのキーを暗号化して保存し、キーの詳細をマスクした状態で返します。キーのプロバイダーは選択したモデルのプロバイダーと一致し、保存したキーが有効である必要があります。BYOKでは、プロバイダーの費用に対してFlowi Tokensは課金されず、プロバイダーのアカウントでその費用を負担します。ワークフローの実行料金は別途かかります。
コンポーネントをテストする前に、モデルへのアクセスを設定してください。コンポーネントの接続が有効なだけでは、外部モデルの呼び出しを検証したことにはなりません。記録された課金とトークン残高を確認するには、ワークフローの使用量とトークン履歴をご覧ください。
実行前にモデル呼び出しの費用を確認する
APIハブでは、マネージドモデル呼び出しを実行する前にFlowi Token使用量を見積もれます。この見積もりは、選択した料金表と入力サイズのプレビューに基づきます。設定画面には、推定使用量、確保額、その確保後の残高が表示されます。
これは概算のプレビューであり、ワークフロー全体の最終的な請求額ではありません。見積もりでは、モデルリクエストの送信や実行に対する課金は行いません。実際のマネージドモデル利用料は、APIハブの課金処理で精算されます。BYOKのプロバイダー利用料は、このマネージドトークンのプレビューとは別です。
Flowi AIコンポーネントを設定する
- ワークフローにFlowi AIコンポーネントを追加します。
- Model選択欄を更新し、目的のAPIハブのカタログ項目を選択します。
- APIハブで、選択したモデルの保存済みワークスペース設定を確認します。保存済み設定は、コンポーネントのPaymentフィールドとBYOK entry idフィールドより優先されます。
- 保存済み設定がmanagedモードの場合、コンポーネントでbyokと指定されていても、呼び出しにはマネージドアクセスを使用します。
- 保存済み設定がbyokの場合、コンポーネントでmanagedと指定されている場合や別のキーが指定されている場合でも、呼び出しには保存済みのワークスペースキーを使用します。
- そのモデルに保存済み設定がない場合は、詳細設定のPaymentフィールドでmanagedまたはbyokを選択します。byokの場合は、プロバイダーの秘密キーではなく、保存したワークスペースキーのBYOK entry idを入力します。
- 実行前に、実際に適用されるモードと保存済みキーを確認します。BYOKキーは、有効で、対象ワークスペースに属し、モデルのプロバイダーと一致している必要があります。
- 害のないテスト用プロンプトでワークフローをテストし、モデルの応答を確認します。
コンポーネントは、選択したモデル項目と指定した支払いモードをAPIハブ経由で送信します。保存済みのワークスペース設定がある場合は、その設定によって実際に適用されるモードが決まります。フロー内にプロバイダーキーは保存しません。モデル呼び出しが失敗した場合は、モデル設定とエラーの詳細を確認してください。ハブが利用できない、モデルが無効になっている、権限がない、BYOK項目が適切でないといった理由で、呼び出しができない場合があります。
既存のモデルプロバイダー設定
モデルプロバイダー設定には、AI Flowi Workflowで使うモデルの認証情報を保存します。プロバイダーサービスは、プロバイダーとモデルの一覧表示、保存時の認証情報の検証、設定済みプロバイダーの識別に加え、有効なモデルと既定モデルの選択に対応しています。これらの設定は、この認証情報の仕組みを使うコンポーネントに引き続き関係します。APIハブのワークスペースBYOK項目とは別の設定です。
プロバイダーの認証情報を保存した後、目的のモデルが有効になっていることを確認し、ワークフローをテストしてください。モデル呼び出しが失敗した場合は、プロバイダー設定とエラーの詳細を確認してください。
Global Variables（グローバル変数）
Global Variablesは、対応するコンポーネントのフィールドに再利用できる値を提供します。変数の読み込みが有効なフィールドでは、コンポーネントの実行前に変数名をその値に解決します。変数を使用するコンポーネントをテストする前に、必要な変数を設定してください。
共有するワークフローのテキストや例に、認証情報の値を含めないでください。設定を文書化する際は、YOUR_MODEL_KEYのような変数名やプレースホルダーを示してください。ワークフローのテキストに秘密情報を埋め込む代わりに、そのフィールドが対応する変数読み込みの操作を使用してください。
関連情報
リンク先のLLMセレクターのチュートリアルでは、ドキュメントに記載されたモデルの振り分けワークフローを紹介しています。コンポーネントカタログでは、そのモデル用コンポーネントや処理用コンポーネントを確認できます。