本文へスキップ
Ankole

AppConfigure

AI Agent 向け: このページの Markdown 版は https://ankole.agentbull.com/ja-JP/docs/app-configuration/index.md、ドキュメント索引は https://ankole.agentbull.com/ja-JP/llms.txt にあります。

サイト管理者は Console → AppConfigure でサイト既定値、ワークスペース方針、共有ランタイム設定を管理します。Pod 管理者は Pod 設定で許可された管理機能を使用します。

設定を探して範囲を選ぶ

編集前にサイト設定と既定値または現在のワークスペースの上書きを選びます。データのワークスペース名は常に表示されます。サイト既定値は上書きのないワークスペースに適用される値であり、強制的な上限ではありません。

既定のタスク表示では、関連設定を一つのフォームで編集し、有効状態・上書き・適用状況を確認できます。読み取り専用のキー一覧では、登録済みキーとパターンの範囲、値の出所、暗号化状態、管理画面を確認できます。検索はフォーム内のフィールドや旧キー名にも対応し、該当フィールドを開きます。管理リンクは担当する Console 画面とタブに移動します。

サイト設定は保存済みサイト値、コードの既定値の順に解決します。テナント設定は、実際に対応する Agent 上書き、ワークスペース上書き、サイト既定値、コードの既定値の順です。Pod 設定はワークスペース値とコードの既定値だけを使用します。対応する五つのキーでは Agent の適用値を読み取り専用で確認できます。

変更とリセット

一つの範囲で単位を確認して保存します。グループ設定は一括で確定し、一項目でも拒否されるとすべて変更せず、下書きを保持します。秘密情報は明示的に表示するまでマスクされます。リセット確認には現在値と、上書き解除後の実際の値・出所が表示されます。同じ値でも、保存した上書きは解除するまで独立した設定です。

時間は保存単位を変えずに読みやすい単位で入力できます。出力上限の指定なし(null)と数値上限を区別し、無応答タイムアウトは明示的に無効(0)にできます。削除データの保持期間を短くする場合は、完全削除の影響を表示します。

Trace と Control Plane Plugin の再起動待ち表示は、実行中プロセスと保存値が一致するまで残ります。Brain の Tick は共有 BM25 インデックスを毎分確認し、トークナイザーの変更時に再構築します。検索の中断や書き込み待ちが発生する場合があります。失敗時は Brain のヘルス画面とサーバーの Tick ログを確認してください。

SMTP は保存前の下書きでテスト送信でき、保存設定や OTP を変更しません。パスワードを入力しなければ保存済みの値を保持します。成功はメール転送サービスが受け付けたことを意味し、下書きを変えると結果は無効になります。

環境変数との違い

AppConfigure は製品設定を PostgreSQL に保存し、多くの変更は後続の処理に適用します。デプロイ環境変数は起動基盤を設定します。ツール用の認証情報は Agent 環境変数で管理してください。

現在の組み込み AppConfigure キー

以下の AppConfigure キーは Ankole 本体に組み込まれているものです。これに加えて Control Plane Plugin が独自のキーを登録する場合もあるため、稼働中のインスタンスにおける正確な一覧は実際の AppConfigure ページで確認してください。

Agent runtime

キー 適用範囲 用途
ai_agent.max_iterations Tenant 1 回の Agent turn で許可されるモデルの最大反復回数
ai_agent.max_output_tokens Tenant 1 回のモデル応答に対する出力トークンの上限
ai_agent.inactivity_timeout_ms Tenant モデルまたは Provider からの応答が途絶えた際、turn を終了するまでの待機時間(ミリ秒)
ai_agent.library.agent_plugin_defaults Tenant Agent Plugin の既定の有効/無効状態
background_agent_jobs.max_running_per_agent Tenant 1 つの Agent あたり同時に実行できる BackgroundAgentJob の上限。既定値 3、有効範囲 1〜64
sessions.wake_recycle Tenant コールド復帰時のモデル会話ローテーション閾値(既定値 min_cold_gap_seconds: 3600、min_context_tokens: 128000、im_max_idle_seconds: 259200)。プロンプトキャッシュが冷えた大きなモデル会話や数日間アイドルだった外部 IM セッションを後続ブランチへ切り替え、上限付きの <wake-briefing> を注入する

Pod、Base、Applet、Drive

キー 適用範囲 用途
pod.allow_external_guests Tenant 招待された外部ゲストによる共有 Pod ページへのアクセスを許可するかどうか。既定値 true
pod.applet.limits Tenant Applet 呼び出しの制限値(既定値 timeout_ms: 60000、heap_mb: 128)
pod.base.limits Tenant Base のクエリおよびレコード制限値(既定値 query_rows: 1000、record_bytes: 1000000、group_count: 1000、statement_timeout_ms: 5000)
pod.office.limits Tenant Office ページ(スプレッドシート、Word 文書、プレゼンテーション)の制限値。ブラウザ上で開ける最大ファイルサイズ(max_file_bytes: 20971520)と、編集内容をファイルへ書き戻すタイミング(compaction_idle_seconds: 30、compaction_op_threshold: 100、compaction_structural_threshold: 10)
drive.trash_retention_days Tenant 削除された Drive ノードを自動で完全削除するまでの保持日数。既定値は 30。0 にすると設定変更まで無期限に保持
drive.vfs_max_upload_bytes Site Worker の /drive VFS アップロード 1 件あたりの最大バイト数。既定値 0 はオブジェクトストアの上限を使用
pod.ot_replay_window Tenant OT リプレイ用に保持する直近のドキュメント変更バッチ数。既定値 1000
pod.ocr_existing_scans Tenant アップロード時に OCR で読み取られなかったスキャン PDF のページを OCR モデルに送る。OCR プロバイダーがページごとに課金する。ゴミ箱にある PDF(ゴミ箱内のフォルダーにあるものを含む)は送らない。既定値 false

Workflow

キー 適用範囲 用途
workflow.max_concurrency_per_run Tenant 1 つの Workflow が要求できるタスク同時実行数の上限。既定値 8、有効範囲 1〜32
workflow.max_running_per_agent Tenant 1 つの Agent で複数の run にまたがって同時実行できる Workflow タスク数の上限。既定値 8、有効範囲 1〜64
workflow.max_agent_calls_per_run Tenant 1 つの Workflow が作成できるサブエージェント呼び出し数の上限。既定値 32、有効範囲 1〜1,024

これらの上限は、設定変更後に新しく開始される Workflow 作業に適用されます。個々の run でこれより低い同時実行数や呼び出し上限を指定することはできますが、テナント上限を超えて引き上げることはできません。タスクの挙動やその他のサイズ制限については、Workflow を参照してください。

Brain

Brain はテナントのシステム主体 ankole_brain としてモデルを呼び出します。抽出(light)、分析(heavy)、URL 取得(web_fetch)、再順位付け(rerank)は Console のモデル設定で管理し、Pod とサイトの設定を継承します。

キー 適用範囲 用途
brain.enabled Tenant Brain の検索・学習・保守処理を有効にする。無効化しても保存済みの知識は保持される
brain.embedding_model Site ベクトル検索に使用する Provider、モデル、次元数。空欄の場合はベクトル検索が無効になる
brain.search_tokenizer Site BM25 トークナイザー(icu、jieba、lindera_japanese、lindera_korean)。変更後は BM25 インデックスの再構築が必要
brain.chunking Tenant Source チャンクのサイズ、オーバーラップ、入力上限
brain.forgetting テナント 記憶の種類ごとの減衰半減期
brain.dreaming_task_cron Tenant 知識の統合処理(Dreaming)を定期実行するスケジュール
brain.self_healing_task_cron Tenant 古くなったチャンク、embedding、検索インデックスの投影を再構築するスケジュール
brain.signal_channel_batch_idle_time Tenant 未処理のチャットメッセージが学習処理へ送られるまでのアイドル秒数(会話終了時にも学習が開始される)
brain.skill_learning_enabled Tenant Skill lesson の学習と配信を有効にする。無効化しても保存済みの lesson は残るが、実行時には提供されなくなる
brain.skill_learning_reflection_threshold Tenant 1 つの Agent が Skill lesson の振り返り(reflection)を開始するまでに必要な未処理 Signal Job 数。最小値は 2

知識管理の仕組みと必要なモデル設定については Brain を、Skill とあわせて提示される教訓については Skill lessons を参照してください。

AI Gateway と observability

キー 適用範囲 用途
ai_gateway.compaction Site 会話履歴の自動圧縮ポリシー
observability.traces.enabled Site 次回の control plane 起動時にプロセス全体の OpenTelemetry エクスポートを有効にするかどうか
observability.traces.provider Site トレースのセマンティック投影方式(langfuse、langsmith、または汎用の opentelemetry)
observability.traces.otlp_endpoint Site トレース送信先のベース OTLP/HTTP エンドポイント(任意)
observability.traces.otlp_headers Site トレース送信時に付与する暗号化済み認証ヘッダー(任意)

Langfuse、LangSmith、VictoriaTraces およびその他の OTLP/HTTP レシーバーの設定手順については、LLM observability を参照してください。

パスワードレス Email OTP と Pod ログインポリシー

キー 適用範囲 用途
authn.email.mail Site、暗号化 パスワードレス Email OTP サインイン用の SMTP 配信設定(server、from、port、ssl、および任意の認証情報)。空の場合は Email OTP が無効になる
authn.email.code_ttl_seconds Site 認証コードの有効秒数。既定値 600
authn.email.send_limits サイト 共通の送信時間枠とメールアドレス・送信元・チャネルごとの上限
authn.email.failure_limits サイト 共通の検証失敗時間枠とメールアドレス・送信元ごとの上限
principals.pod_login_policy Tenant、別の場所で管理 Pod メンバーのログインおよび招待ポリシー(allow_email_otp、allow_member_credential_change、allowed_email_domains、require_sso_for_members、allow_invite_links)。Pod Settings で管理

Identity、Plugin、機能フラグ、tenant のデフォルト値

キー 適用範囲 用途
principals.identity_providers.active Tenant、読み取り専用 Pod ワークスペースのメンバーと管理者の認証に使われる有効なテナント Identity Provider。Pod Settings および Identity Provider ページで管理
principals.identity_providers.directory_full_sync_interval_minutes Tenant 組織ディレクトリのフル同期を実行する間隔(分)
tenants.privileged_tenant_id Site、読み取り専用 このサイトを管理する siteadmin グループを持つ特権テナントの ID
plugins.enabled_ids Site、別の場所で管理 次回起動時に有効化する :optional な Control Plane Plugin の一覧(:always プラグインはビルドに含まれ常時有効)
features.<flag> Site OpenFeature ベースの機能公開ポリシー({enabled, percent, targets}、Ankole.Features.Config)
signals.show_dead_letter_error_details Site Conversation に投稿される dead letter 通知に、文字数制限およびマスク処理済みの Session turn エラー詳細を含めるかどうか。既定値 false
system.timezone Tenant スケジュール実行など control plane 機能で使用する既定タイムゾーン
i18n.default_locale Pod この Pod ワークスペースのインターフェース、通知メール、Agent メッセージの既定表示言語(Pod 管理者は Pod Settings からも変更可能)

Worker、web 読み取り、セキュリティ

キー 適用範囲 用途
agent_workers.ready_timeout_seconds Site Worker が ready にならないまま待機を許容する秒数。超過すると新しいキャッシュディスクで再構築される。既定値は 600(10 分)
agent_workers.rendered_fetch_idle_ttl_ms Tenant 組み込み web_fetch のレンダリングフォールバック用ブラウザをアイドル保持する時間(ミリ秒)
security.ssrf_filter Site モデル主導の fetch リクエストに対して、プライベート IP、ループバック、リンクローカル、CGNAT アドレスへのアクセスを遮断するかどうか

なお、security.ssrf_filter をオフにした場合でも、クラウドメタデータエンドポイントへのアクセスは常に遮断されます。

agent_workers.ready_timeout_seconds は、起動後に準備完了へ進まないインスタンスを自動復旧するための設定です。アイドル状態のインスタンス解放については、provider YAML の idleReleaseAfter で設定します。詳しくは Worker を参照してください。

初回セットアップの状態

キー 適用範囲 用途
setup.bootstrap_activation_code Site、読み取り専用 初回セットアップページで使用する一時アクティベーションコード
setup.completed Site、読み取り専用 このインスタンスで初回セットアップが完了済みかどうか

これらのキーは初回セットアップフローによって管理されます。アクティベーションコードを確認したい場合は kit show bootstrap-activation-code を実行してください。AppConfigure ページから直接編集することはできません。

暗号化設定

認証情報にあたる設定項目は暗号化して保存され、一覧画面やエディタ上ではマスク表示されます。マスク表示のまま保存すれば現在の値が維持され、新しい値を入力して保存した場合のみ上書きされます。

現在の設定値を確認する必要がある場合に限り、Reveal を使用してください。表示された認証情報をチャット、スクリーンショット、チケットなどに貼り付けないよう注意してください。