ホームサーバー上のOpen WebUIでコーディングエージェントをスケジュールする方法

Open WebUI v0.13.3では、選択したターミナルと作業ディレクトリを使ってコーディングエージェントをスケジュール実行できます。使い捨てのチェックアウトで、まずはレポートのみを行うタスクから始めましょう。既知のテストコマンドを実行し、失敗内容を要約して、結果をチャットに送信します。このテストで、定期ジョブに重要なファイルへのアクセスを許可する前に、スケジューラー、権限、結果の配信経路を検証できます。

対応するOpen WebUIのインストール環境、目的のエージェントを提供する接続可能なターミナル連携、そしてアクセス可能なワークスペースが必要です。v0.13.3のリリースノートによると、スケジュール実行時には、保存済みのターミナルとエージェントが引き続き利用可能かどうかが確認されます。ターミナル、ファイルシステム、基盤となるモデル接続は、セットアップの別々の要素として扱ってください。

11月のリリースで何が変わりましたか？

自動化エディターでは、ターミナルとディレクトリを選択してから、そのターミナルで利用可能なエージェントを選べます。設定したターミナルとフォルダーは、スケジュール実行にも引き継がれます。エージェントによる自動化の結果はチャットに送られますが、ほかの種類の自動化では送信先の選択肢が異なる場合があります。以前のv0.13.1リリースでは、接続されたターミナルが対応エージェントを提供している場合に、モデル選択メニューにコーディングエージェントが追加されました。

選択したターミナルは、Open WebUIと同じホスト上で実行することも、接続可能な別サービスとして実行することもできます。ジョブで重要なのはターミナルのファイルシステムです。ノートパソコンに表示されるディレクトリが、コンテナ内には存在しない場合があります。あるターミナルで使えるファイルが、別のターミナルには存在しないこともあります。自動化で選択したターミナル上で、正確なパスを確認してください。

ワークスペースはどのように準備すればよいですか？

専用のテスト用チェックアウトを作成します。できれば、本番用シークレットを含まない小さなリポジトリを使いましょう。既知のリビジョンに固定し、セットアップには無害な成功テストと既知の失敗テストを用意します。最初のレポートでは、テストランナーが対応している場合、入力チェックアウトを読み取り専用で公開します。テストキャッシュとログ用に書き込み可能なスクラッチ領域を用意します。ツールによってはツリーへの書き込みが必須なため、別の場所に書き込むよう設定するか、書き込み可能な使い捨てのコピーを使います。

複数のジョブで同じリポジトリを共有する場合は、エージェントまたはタスクごとに1つのワークツリーを作成します。バックアップと作業ディレクトリは分けてください。ファイルサーバーでタスクに広範な書き込み権限を付与する前に、共有アクセスによってバックアップが失敗する原因を確認してください。

最初のスケジュール済みジョブはどのように設定しますか？

エージェント自動化に対応したリリースで、自動化エディターを開きます。ターミナルを選び、そのターミナルから見えるディレクトリを選んでから、エージェントを選択します。インストール環境でスケジュール設定が選べる場合は、最初のテストには近日中の単発実行を使います。設定したタイムゾーンでスケジュールを確認してください。エージェントとデプロイ環境で利用できる設定を使って、実行時間またはステップ数の上限を控えめに設定します。

具体的な入力、コマンド、結果の形式をジョブに指定します。たとえば、次のようにします。

選択した作業ディレクトリにあるチェックアウトを調べてください。
既存のローカルスモークテストコマンドを一度実行してください。
コマンド、終了ステータス、最初に失敗したテストを報告してください。
コマンドまたはフォルダーが利用できない場合は、その失敗を報告してください。
依存関係をインストールしたり、リポジトリを変更したり、外部サービスに接続したりしないでください。

指示はエージェントを導きます。ファイルシステムとネットワークの境界は、ターミナルとコンテナの設定で別々に制限してください。不足している依存関係が、予期しないインストールではなく、明確なエラーにつながることを確認します。ターミナルと管理者向けの設定については、Open WebUIのドキュメントを出発点にしてください。

最初の実行後に何を確認すべきですか？

生成されたチャットを開き、エージェントの識別情報、作業パス、テストコマンド、終了ステータス、テスト対象のリビジョンを確認します。同じターミナルで同じコマンドを手動実行した結果と比較してください。自動化が完了したことから分かるのは、ワークフローが終了したということだけです。意図したテストが実際に実行されたことを示す証拠も、レポートに必要です。

意図的に失敗するケースをテストします。害のない入力ファイルをあえて見つからない場所に指定するか、使い捨てのターミナルを一時的に停止し、その結果の状態を確認してください。テスト後は元に戻します。担当者がチャット履歴全体を読まなくても、エージェントが利用できない状態、ディレクトリが見つからない状態、テストの失敗、モデルのタイムアウトを見分けられるようにしてください。次の正当な実行で古い出力が気づかないうちに再利用されないことも確認します。

セルフホストのOpen WebUIならコードをローカルに保管できますか？

Open WebUI とそのターミナルはセルフホストできますが、選択したコーディングエージェントがリモートモデルを使用する場合があります。エージェントがシステムプロンプト、ファイルの抜粋、テストログをどこに送信するかを確認してください。プライベートなチェックアウトを接続する前に、プロバイダーの設定を確認します。プロバイダーの認証情報はサービスで指定されたシークレット設定に保存し、プロンプトやログを通じて共有しないでください。

要件上、外部での処理が禁止されている場合は、まずローカルモデルのエンドポイントを使用してください。エンドポイントとエージェントのフォールバック設定を確認し、ターミナルに適用されるネットワーク制限も確認してください。情報の露出を抑える方法については、こちらのAI による脆弱性トリアージとシークレット管理のガイドをご覧ください。

レポートのみのジョブを定期的なワークフローにするには、どうすればよいですか？

最初の実行が成功した場合と失敗した場合の両方を把握できたら、同じディレクトリを使う別のジョブと重ならない定期スケジュールを追加してください。レポートにはタイムスタンプとリポジトリのリビジョンを記録します。アラートはシンプルにし、対応が必要な失敗を通知し、再現に必要な情報を十分に保持してください。アップグレード後も、エージェントの認証情報、ターミナルへの接続、スケジュール対象のディレクトリが引き続き機能するか定期的に確認してください。

後からパッチの適用を許可する場合は、隔離されたブランチで作業し、マージ前にレビューを必須にしてください。そうしないと、スケジューラーの再試行によって副作用が重複する可能性があります。レポートジョブは結果を書き出すだけなので再試行しやすい一方、依存関係の更新やデプロイコマンドは状態を変更します。この移行は、別途権限を与えるかどうか判断してください。

よくある質問

エージェントの自動化はどのバージョンで追加されましたか？

該当する機能は Open WebUI v0.13.3 に記載されています。v0.13.1 のエージェント選択機能は関連していますが、別の機能です。

エージェントが選択肢に表示されないのはなぜですか？

選択したターミナルに接続でき、そのターミナルで対象のエージェントが利用可能になっていることを確認してください。また、インストール済みのバージョンとアカウントの権限でこの機能が使えることも確認してください。

ノートパソコン上のフォルダーを選べますか？

ジョブを実際に実行するターミナル上のパスを選んでください。必要に応じて、まずチェックアウトしたリポジトリをその場所にマウントするかコピーしてください。

自動化の結果はチャンネルに届きますか？

v0.13.3 のリリースノートには、エージェントの自動化でチャットに配信すると記載されています。そのチャット以外の配信先を利用する場合は、現行バージョンの選択肢を確認してからにしてください。

2つの実行が重なった場合はどうすればよいですか？

別々の worktree を使うか、ジョブが重ならないようにスケジュールと実行時間の上限を設定してください。誤ったリビジョンを使った実行結果は、レポートを信頼する前に確認してください。

結論

1つのターミナル、対象を絞った1つの作業ディレクトリ、レポートのみを生成する小規模なジョブを使い、全体の流れを検証しましょう。モデルプロバイダーを確認し、成功と失敗の両方をテストして、本番環境の認証情報はターミナルの外に保管してください。結果を再現できるようになったら、同じ構成で定期的なリポジトリチェックにも対応できます。