Skip to main content
これらの設定は system.settings で確認でき、source から自動生成されています。

ai_function_embedding_default_credentials

呼び出し時にパラメータマップで credentials が渡されない場合に、aiEmbed が使用する 名前付きコレクション の名前です。空の場合はデフォルトがないことを意味し、そのような呼び出しでは credentials を明示的に渡す必要があります。aiEmbedmodel を必須の位置引数として受け取り、名前付きコレクション からは取得しません。埋め込み用のエンドポイントはチャット用のものとは異なるため、ai_function_text_default_credentials とは分けて管理されています。

ai_function_embedding_max_batch_size

aiEmbed が 1 回の HTTP リクエストに含められるテキストの最大数です。API 呼び出しのオーバーヘッドを減らすため、テキストはこのサイズのバッチにまとめられます。たとえば、一意なテキストが 500 件あり、バッチサイズが 100 の場合、HTTP リクエストは 5 回になります。

ai_function_max_api_calls_per_query

AI 関数が 1 クエリあたりに送信できる HTTP リクエストの最大数です。無効にするには 0 に設定します。

ai_function_max_input_tokens_per_query

1 回のクエリ内で、すべての AI 関数の API 呼び出しにおける入力 (プロンプト) トークン総数の上限です。これはプロバイダのレスポンスに基づいて累積的に追跡されます。呼び出しごとの入力トークン数は事前にわからないため、この上限は 1 回の呼び出し分の入力トークン数だけ超過する可能性がある点に注意してください。無効にするには 0 に設定します。 この上限は、レスポンス内で usage オブジェクトを返すプロバイダ (OpenAI、Anthropic、vLLM) に対してのみ適用されます。トークン使用量を返さないプロバイダ (特に HuggingFace TEI) の場合、カウンターは 0 のままになるため、そのような呼び出しを制限するには代わりに ai_function_max_api_calls_per_query を使用してください。

ai_function_max_output_tokens_per_query

1 つのクエリ内における、すべての AI 関数 API 呼び出し にまたがる出力 (completion) トークン の合計上限です。これはプロバイダからのレスポンスに基づいて累積的に追跡されます。呼び出しごとの出力 トークン 数は事前にわからないため、この上限は 1 回の呼び出し分の出力 トークン だけ超過する場合があります。無効にするには 0 に設定します。 この制限が適用されるのは、レスポンス内で usage object を返すプロバイダ (OpenAI、Anthropic、vLLM) のみです。埋め込み関数 (特に aiEmbed) には適用されません。これらは出力 トークン を生成しないためです。

ai_function_max_retries

個々のAPIリクエストに対して、一時的なエラー発生時に行う再試行の最大回数です。各再試行では、ai_function_retry_initial_delay_ms を初期値とする指数バックオフを使用します。

ai_function_request_timeout_sec

AI 関数 (AI Chat の補完および埋め込み API 呼び出し) が行う個々の HTTP リクエストのタイムアウトを秒単位で指定します。リクエストがこの時間内に完了しない場合は失敗とみなされ、ai_function_max_retries に従って再試行されることがあります。

ai_function_retry_initial_delay_ms

失敗した AI 関数の API リクエストを最初に再試行するまでの初期遅延を、ミリ秒単位で指定します。この遅延は、以降の試行ごとに 2 倍になります (指数バックオフ) 。たとえば、デフォルト設定では 1000ms、2000ms、4000ms です。

ai_function_text_default_credentials

呼び出し時にパラメータマップで credentials が渡されない場合、テキスト AI 関数 (aiGenerateaiClassifyaiExtractaiTranslate) が使用する名前付きコレクションの名前です。空の場合はデフォルトがないことを意味し、そのような呼び出しでは credentials を明示的に渡す必要があります。chat-completions の endpoint は 埋め込み 用のものとは異なるため、これは ai_function_embedding_default_credentials とは別です。

ai_function_throw_on_error

true の場合 (デフォルト) 、再試行をすべて使い切っても AI 関数呼び出しが最終的に失敗すると、例外を発生させてクエリを中断します。false の場合、失敗した行にはカラム型のデフォルト値 (String の場合は空文字列) が設定され、処理は継続されます。

ai_function_throw_on_quota_exceeded

true (デフォルト) の場合、AI 関数のクォータ制限 (ai_function_max_input_tokens_per_queryai_function_max_output_tokens_per_query、または ai_function_max_api_calls_per_query) を超えると、例外が発生してクエリは中止されます。false の場合、残りの行にはカラムの型のデフォルト値 (String の場合は空文字列) が設定されます。
最終更新日 2026年7月24日