MATCHA 技術仕様
workload automation MATCHA の構成、ジョブの実行のしくみ、データの扱い、信頼性とセキュリティの考え方をまとめています。はじめの 2 章は全体像、それ以降は各機能の詳しい仕様です。
概要
MATCHA は、業務システムで毎日・毎月決まった時刻や順番で行う処理(バッチ処理)を自動で実行し、その結果を見守るソフトウェアです。この種のソフトウェアは「ジョブスケジューラ」「ワークロードオートメーション」と呼ばれます。
個々の処理をジョブ、ジョブを実行順につないだ一連の流れをジョブネットと呼びます。MATCHA は、決めた日時になるとジョブネットを起動し、ジョブを実行先のコンピューターに順番に指示し、結果に応じて次のジョブへ進めます。異常があれば記録し、担当者に知らせます。AI への問い合わせもジョブの一種として、ほかのジョブと同じ流れの中に組み込めます。
- 3 つのプログラムで動きます: 全体を管理するサーバー、ジョブを実行する各コンピューター上のエージェント、人が操作するManager(Windows アプリ)です。データベースはサーバーに内蔵しており、別のデータベース製品や監視製品は要りません。
- 通信はすべて暗号化します: サーバーとエージェントは互いの証明書を確かめ合う暗号化通信(相互 TLS)、Manager とサーバーは HTTPS でつながります。
- 記録を失わないように作っています: 状態の変更と実行ログの書き込みは必ず同時に行い、サーバーが途中で止まっても、再起動時に「結果不明で中断」として記録を残します。
- AI は社外・社内を選べます: Claude・OpenAI などのオンラインのサービスと、社内のコンピューターで動かすローカル LLM(Ollama など)のどちらにも接続できます。
各機能の状態を 提供中(実装済みで動作するもの)、開発中(いま作っているもの)、予定(これから作るもの)で示しています。2026 年 10 月 28 日時点の状態です。
用語
| 用語 | 意味 |
|---|---|
| ジョブ | 1 つの処理。コマンドの実行、変数の設定、条件分岐、AI への問い合わせなど、種類があります。 |
| ジョブネット | ジョブを実行順につないだ流れ。フロー図で作ります。起動の単位です。 |
| 実行 | ジョブネットを 1 回起動したもの。実行ごとに番号が付き、状態とログが残ります。 |
| カレンダー | ジョブネットを起動してよい日(稼働日)の一覧。 |
| スケジュール | 「どのカレンダーの稼働日の何時に、どのジョブネットを起動するか」の定義。 |
| ホスト | ジョブを実行するコンピューター。エージェントを入れて、サーバーに名前を付けて登録します。 |
| ワークスペース | サーバーから各ホストへ配るスクリプトや設定ファイルの置き場。 |
構成と通信
1 台のサーバーが、複数のホストのエージェントにジョブを指示します。人は Manager から、ほかのシステムはコマンドライン(CLI)や API から、サーバーに対して操作します。Manager や CLI がサーバーのデータベースを直接読み書きすることはなく、操作はすべてサーバーの API を通ります。
通信経路
| 経路 | 内容 | 方式 | 既定のポート |
|---|---|---|---|
| Manager・CLI → サーバー | 操作・参照 | HTTPS + JSON(REST) | 10057 |
| サーバー → エージェント | ジョブの指示、ワークスペースの配布 | 相互 TLS | 10055 |
| エージェント → サーバー | ジョブの結果、アウトプットの送信 | 相互 TLS | 10056 |
| サーバー → エージェント | CPU・メモリ・ディスクの計測 | HTTPS + JSON | 9443 |
| エージェント → AI サービス | AI ジョブの問い合わせ | HTTPS(社内のローカル LLM は HTTP も可) | 接続先による |
| サーバー → 通知先 | 異常の通知 | SMTP(STARTTLS / SSL / 平文)、Web フック(HTTP(S)) | 接続先による |
ポートはいずれも設定で変更できます。サーバーからエージェントへの接続とエージェントからサーバーへの接続は別の通信で、どちらも相互 TLS です。
コンポーネント
MATCHA サーバー 提供中
C 言語で書かれた 1 つのプログラム(matcha_serverd)で、Windows と Linux の両方で同じソースから動きます。データベース(SQLite)を内蔵し、暗号化通信には mbedTLS を使います。役割ごとに別のプロセスを立てるのではなく、1 つのプロセスの中で次の処理を順に回します。
| 処理 | 役割 |
|---|---|
| スケジューラ | スケジュールに従ってジョブネットを起動し、ジョブを実行順に進めます(スケジューラと実行モデル)。 |
| ジョブの送信・受信 | エージェントへジョブを指示し、結果を受け取ります。 |
| 問い合わせ API | Manager・CLI・ほかのシステムからの操作を受け付けます(API とコマンドライン)。 |
| ホストの監視 | 各エージェントの CPU・メモリ・ディスクの使用率を順番に計測し、応答の有無を確認します。 |
| 通知 | 異常をメール・Web フックで知らせます。送れなかった通知は時間をおいて送り直します。 |
| ワークスペース | ファイルを各ホストへ配り、ジョブのアウトプットを受け取ります。配布は別のスレッドで行い、スケジューラを止めません。 |
| 起動時の整合性確認 | 前回止まったときに実行中のまま残った記録を見つけ、「中断(結果不明)」として閉じます(信頼性)。 |
Windows では、Manager の「サーバーを新規作成」で、その PC にサーバーを作って起動できます。この場合はサービスではなく利用者のプログラムとして動き、管理者権限は要りません。Windows サービスとして登録することもできます。
MATCHA エージェント 提供中
ジョブを実行する各ホストに常駐する C 言語のプログラム(matcha_agentd)です。サーバーからの指示を受けてコマンドや AI ジョブを実行し、結果を返します。CPU・メモリ・ディスクの計測値を返す監視用の API も持ちます。
- Windows: Windows サービスとして動きます。異常終了したときは、Windows のサービス回復機能で自動的に再起動します(1・2 回目は 5 秒後、3 回目以降は 30 秒後)。サービスにせず通常のプログラムとして動かすこともできます。
- Linux: Manager が作るセットアップファイルでは、専用のユーザーで動く systemd のサービスとして起動し、異常終了したときは systemd が自動的に再起動します。systemd を使わない環境向けに、異常終了したら待ち時間を 1 秒から最大 60 秒まで伸ばしながら再起動する監視用のプロセス(スーパーバイザー)も同梱しています。root 権限での起動は、設定で明示的に許可しない限り拒否します。
MATCHA Manager 提供中
.NET と Avalonia で作った Windows のデスクトップアプリです。日本語と英語に対応しています。
- 運用: 実行監視(一覧とフロー図で状態を表示、強制停止・もう一度実行・保留解除)、実行ログ(終了コードと出力)。
- 定義: ジョブネット(フロー図エディター)、スケジュール、カレンダー、ホストとエージェントのセットアップ、ワークスペース、AI 接続、AI ひな型。
- 管理: ユーザー、ユーザーグループ、通知チャネル、エクスポート/インポート、ライセンス。
はじめて接続するサーバーでは、証明書の SHA-256 指紋を表示して利用者に確認を求め、信頼した証明書を記憶します。以後、証明書が変わった場合は警告します。画面の使い方は操作マニュアルをご覧ください。
コマンドライン(jbcs) 提供中
サーバーの API を呼び出すコマンドラインツールです。ほかのシステムや既存の運用スクリプトから MATCHA を操作するときに使います(API とコマンドライン)。
ジョブとジョブネット
ジョブネットは、ジョブとそれをつなぐ線(フロー)でできています。線の先のジョブは、つながっているすべての前のジョブが終わってから始まります(AND 結合)。どこからも線が入っていないジョブが最初に実行されます。条件分岐のジョブからは「成立」と「不成立」の 2 本の線が出て、結果に応じてどちらか一方に進みます。循環するつなぎ方はできません。
ジョブの種類
| 種類 | 実行場所 | 内容 | 状態 |
|---|---|---|---|
ジョブ(コマンド実行)dispatch | エージェント | 指定したホストでコマンド・スクリプトを実行します。実行ユーザー、環境変数、制限時間、ワークスペースの利用を指定できます。 | 提供中 |
変数設定value_set | サーバー | ジョブネットの変数に値を設定します。値の中で $名前 でほかの変数を参照できます($$ は $ そのもの)。 | 提供中 |
計算calc | サーバー | 整数の四則演算(+ - * / とかっこ)を計算し、結果を変数に入れます。0 で割る・式の誤りはエラーです。日付の計算はできません。 | 提供中 |
条件分岐condition | サーバー | 変数の値(整数)が、指定した範囲(5、10-20、100- をカンマ区切り)に入るかで「成立」「不成立」に分かれます。変数が未設定・数値でない場合はエラーです。正規表現による比較はできません。 | 提供中 |
終了end | サーバー | その流れを終わらせます。ジョブネットの終了コード(0〜255)を設定できます。 | 提供中 |
ジョブネット呼び出しjobnet_call | サーバー | 別のジョブネットを同じ実行の一部として実行し、終わるまで待ちます。呼び出し先の結果がこのジョブの結果になります。入れ子の呼び出しにも対応します。 | 提供中 |
ジョブネット起動jobnet_submit | サーバー | 別のジョブネットを独立した新しい実行として起動し、待たずに次へ進みます。 | 提供中 |
保留解除release | サーバー | 保留中のジョブを解除します。同じジョブネットのほか、実行中の別のジョブネットのジョブも指定できます。 | 提供中 |
AI 問い合わせllm | エージェント | AI に指示文を送り、答えを変数・ファイルに受け取ります(AI ジョブ)。 | 提供中 |
AI エージェントai_agent | エージェント | 目的を渡すと、AI が許可された道具を使って何回か作業し、結果を返します。 | 開発中 |
ファイルコピーfile_copy | エージェント | ホスト間でファイルをコピーするジョブ。 | 予定 |
サーバーで実行する種類のジョブは、エージェントを使わずにその場で終わります。
ジョブごとの設定
| 設定 | 内容 |
|---|---|
| 保留する | 前のジョブが終わっても開始せず、保留解除(画面の操作・保留解除ジョブ・CLI)を待ちます。人の確認を挟みたい箇所に使います。 |
| エラーでも後続へ進む | このジョブが異常終了しても、後続のジョブへ進みます。既定では、異常終了したジョブの先には進みません。 |
| 実行ユーザー | エージェント上でジョブを動かすユーザー。Windows ではパスワードも指定します(エージェントとジョブの実行)。 |
| 環境変数 | コマンド実行ジョブに渡す環境変数。 |
| 制限時間 | この時間を過ぎると、エージェントがジョブを止めて「時間切れ」として報告します。指定しない場合は終わるまで待ちます。 |
| ワークスペースを使う | コマンドの最初の語をワークスペース内のパスとして実行します(ワークスペース)。 |
ジョブネットの変数($名前)は、変数設定・計算・条件分岐・終了・保留解除・ジョブネット呼び出し/起動の各設定と、AI 問い合わせの指示文の中で使えます。変数は 1 回の実行の中で共有され、実行ごとに独立しています。
ジョブネットごとの設定
| 設定 | 内容 |
|---|---|
| 多重起動 | 前の実行が終わる前に同じジョブネットが起動されたときの扱い。許可(並行して実行)、スキップ(今回は実行せずに終了として記録)、待機(前の実行が終わるまで待つ)から選びます。 |
| 制限時間 | ジョブネット全体の制限時間。超えたときの扱いを警告(通知だけして実行を続ける)、停止(残りのジョブを止めて異常終了)、スキップ(残りのジョブを止めて正常終了として閉じる)から選びます。 |
| 公開範囲 | 全員、または管理者と選んだユーザーグループのメンバーだけ(ユーザーと権限)。 |
ジョブネット・カレンダー・スケジュールの定義は、保存するたびに新しい版として記録され、前の版も残ります。
スケジューラと実行モデル
スケジュールとカレンダー 提供中
- カレンダーは稼働日の一覧です。Manager では、平日・毎日・銀行営業日(土日・祝日・12/31〜1/3 を除く)などをまとめて設定できます。祝日は計算で求めています。
- スケジュールは「カレンダー+起動時刻(HH:MM)」の組を 1 つ以上と、起動するジョブネットの一覧からなります。時刻はサーバーのコンピューターの時刻です。
- 保存した時点より前の予定は起動しません。過去の日付を含むカレンダーを使っても、過ぎた分がまとめて起動されることはありません。
- サーバーが止まっていた間に過ぎた予定は、サーバーの再開後に起動します。同じ予定を二重に起動しないよう、ジョブネット・予定時刻・スケジュール・カレンダーの組で重複を確認しています。
- スケジュールは一時停止・再開できます。停止していた間に過ぎた予定は、再開しても起動しません。
ジョブネットは、スケジュールのほかに Manager の「今すぐ実行」、CLI、API から手動で起動できます。手動起動もスケジュールによる起動と同じ経路で処理されます。
実行の進み方
スケジューラは、サーバーのメインループの中で次の段階を繰り返します。
- 展開: 起動するジョブネットの定義(ジョブ・線・各設定)を、その時点の写し(スナップショット)として実行用の領域にコピーします。実行中に定義を編集しても、動いている実行には影響しません。呼び出し先のジョブネットは、呼び出しのジョブに到達した時点で展開します。
- 開始判定: 多重起動の設定を確認し、実行を開始します。実行中のジョブネットの制限時間もこの段階で確認します。
- 実行: 実行可能になったジョブのうち、コマンド実行と AI 問い合わせはエージェントへ送ります。送れなかった場合(ホストが未登録・エージェントに届かない)は、異常にはせず次の周期で送り直します。サーバーで実行する種類のジョブはその場で終わらせます。
- 結果の反映: エージェントから結果が届くと、ジョブの状態と実行ログを同時に記録し、線の先のジョブを進めます。
実行とジョブの状態
| 状態 | 内部名 | 意味 |
|---|---|---|
| 待機中 | begin | 開始前(前のジョブの終了・保留解除・予定時刻を待っている)。 |
| 実行待ち | ready | 開始の条件がそろい、実行を待っている。 |
| 実行中 | run | 実行している。 |
| 正常終了 | end | 正常に終わった。 |
| エラー | runerr | ジョブが異常終了した。ジョブネットでは「実行中(エラーあり)」を表し、残りのジョブが終わると異常終了になります。 |
| 異常終了 | enderr | ジョブネットが、異常終了したジョブを含んで終わった。 |
| 強制停止 | abort | 操作者の強制停止、または制限時間による停止で止めた。 |
| 中断(結果不明) | interrupted | サーバーが途中で止まったため、実際の結果が分からないまま閉じた(信頼性)。 |
ジョブネットは、実行中・実行待ちのジョブが 1 つもなくなった時点で終わります。異常終了したジョブが 1 つでもあれば異常終了、なければ正常終了です。強制停止すると、まだ始まっていないジョブは実行されません。
強制停止は、サーバー上の実行を止めるものです。エージェントですでに動いているジョブのプロセスは、現在は最後まで実行されます。エージェント上のプロセスも止める機能は 予定 です。
エージェントとジョブの実行
相互 TLS と証明書 提供中
- サーバーとエージェントの通信は、相互 TLS(双方が証明書を提示し、相手の証明書を確かめる方式)が必須です。設定で無効にすることはできません。
- エージェントの証明書は、Manager の「エージェントのセットアップ」でホストごとに発行します(EC P-256 の鍵、ホスト名入りの証明書)。設定ファイルと証明書を 1 つのフォルダーにまとめて作るので、ホストにコピーして起動するだけで接続できます。
- エージェントは、サーバーの証明書を持つ相手からだけジョブやファイル配布を受け付けます。ほかのエージェントの証明書では、エージェントに処理をさせることはできません。サーバーと同じ名前のホストには証明書を発行しません。
- 証明書が漏れたときや使わなくなったときは、Manager から失効させられます。失効した証明書での接続は、TLS の接続確立の直後に切断します。ホストを削除すると、そのホストの証明書はすべて失効します。
- 接続を許可するサーバーの IP アドレスを、エージェントの設定で追加で絞り込むこともできます。
- ホストは名前で識別します。接続先は DNS 名(ジョブを送るたびに名前解決)または固定 IP アドレスで登録できます。
同時実行 提供中
エージェントは、ジョブを 1 つずつ別の作業プロセス(ワーカー)で実行するため、1 台で複数のジョブを同時に実行できます。ジョブの実行中も、新しい指示の受け付けや計測は止まりません。
- 同時に実行するジョブ数の上限は、エージェントの設定
MaxConcurrentJobs(既定 5)で決めます。上限を超えた指示は待ち行列に入れず、すぐに「混雑」の結果として返します(そのジョブは異常終了として記録されます)。 - 同じジョブの指示が重ねて届いた場合は、二重に実行しません。
- 結果はワーカーから親のプロセスに集め、親のプロセスがサーバーへ送ります。
制限時間 提供中
ジョブの制限時間は、エージェント自身が測って守らせます。サーバーと通信できない状態でも、時間を過ぎたジョブはエージェントが止め(Linux はプロセスグループ単位、Windows はジョブオブジェクト単位)、「時間切れ」と分かる結果を返します。制限時間を指定しないジョブは、終わるまで待ちます。
実行ユーザー 提供中
- Windows: 指定したユーザーとパスワードでログオンし、そのユーザーのプロファイルと既定の環境でジョブを起動します。ドメインのユーザーも指定できます。
- Linux: 指定したユーザーとそのグループに切り替えてから起動します。切り替えには、エージェントにその権限が必要です。
- ユーザーの切り替えに失敗した場合は、別のユーザーのまま実行することはせず、起動失敗として報告します。
- パスワードは、使い終わるとメモリから消去し、ログには出力しません。
結果の報告
- 終了コードと、標準出力・標準エラーを結果として返します(1 ジョブ 1 MB まで)。実行ログで確認できます。
- プログラムを起動できなかった場合、実行中にクラッシュした場合も、「実行中」のまま残さず、それと分かる結果を返します。ワーカー自体が結果を返さずに終わった場合も、親のプロセスが代わりにエラーの結果を返します。
- エージェントを停止するときは、新しい指示の受け付けを止め、実行中のジョブを一定時間(既定 30 秒)待ってから、残ったジョブを子プロセスまでまとめて終了させます。
ワークスペース 提供中
ジョブで使うスクリプトや設定ファイルをサーバーにまとめて置き、各ホストへ配る機能です。ホストごとに手作業でプログラムを入れる必要がなくなります。使うかどうかは任意で、ワークスペースを使わずに任意のコマンドを実行することもできます。
- 配布先: 各エージェントの設定
WorkspacePathのフォルダーです。1 台のホストは 1 つのワークスペースにだけ入れられます。 - マスタ: 正しい内容の置き場所を、サーバー、または特定のエージェントのワークスペースから選べます。エージェントがマスタの場合も、内容はいったんサーバーに読み込んでから配ります。エージェント同士が直接ファイルをやりとりすることはありません。
- 差分配布: 変更のあったファイルだけを送ります(SHA-256 で比較)。除外パターン(ファイル名・拡張子)に合うファイルは送りません。
- 更新方法: 「自動」はジョブの実行直前にそのホストへ配布してから実行します。配布できなかったときは、エージェントの手元の内容で実行し、警告を記録します。「手動」は操作したときだけ配布し、手元の内容がマスタと違うまま実行された場合は、実行結果に警告を付けます。
- アウトプット: ジョブが
Outputフォルダーに書いたファイルは、ジョブの終了後に、サーバーまたは指定したエージェント(集約先)へ送られます。集約先ではホスト名ごとのフォルダーに分けて保存します。 - Linux では、
#!で始まるスクリプトと実行ファイルは、配布時に実行できる状態になります。
マスタから削除したファイルは、配布済みのホストからは自動では削除されません。
AI ジョブ
AI はジョブの一種として、ほかのジョブと同じフロー図に置きます。前のジョブの結果を指示文に入れ、AI の答えを変数に受け取り、その値で条件分岐できます。AI との通信は MATCHA に組み込まれており、外部の AI ツールを起動する方式ではありません。AI ジョブは Community Edition でも使えます。
実行のしくみ
- AI ジョブは、コマンド実行ジョブと同じくエージェントで実行します。サーバーは指示文の変数を置き換え、ひな型を合成し、AI 接続の情報を添えてエージェントに送ります。応答に時間がかかっても、サーバーのスケジューラは待たずにほかの処理を続けます。
- ローカル LLM は社内の GPU マシンなどに置くことが多いため、その近くのエージェントから呼び出せます(
http://localhost:11434のような社内だけの接続先にも届きます)。 - AI 接続(接続先・既定のモデル・API キー)はサーバーで一元管理します。キーをホストごとに配る必要はありません。キーをサーバーに置かず、エージェントのホストの環境変数から読む設定もできます。
| 接続先の種類 | 使う API | 決まった形の答え(JSON) |
|---|---|---|
| Claude(Anthropic) | Messages API | ツール指定で受け取る |
| OpenAI | Chat Completions API | JSON スキーマ指定で受け取る |
| OpenAI 互換(Ollama・LM Studio・vLLM・llama.cpp など) | Chat Completions 互換 API | 対応していればスキーマ指定、なければ指示文で形式を伝える |
AI 問い合わせ(llm) 提供中
指示文を 1 回送って答えを 1 回受け取るジョブです。分類・要約・抽出・判定に向いています。
- 指示文: システム指示と指示文に、ジョブネットの変数(
$MAIL_BODYなど)を入れられます。お手本(入力と出力の例)を添えられます。作業フォルダーのテキストファイルを入力として添えることもできます(1 ファイル 1 MB まで)。 - 答えの受け取り方: テキストのまま変数に入れるか、JSON として受け取ります。JSON スキーマを指定すると答えを照合し、合わなければ 1 回だけ出し直させ、それでも合わなければ異常終了にします。JSON の項目ごとに別の変数へ入れられ、答えをファイルにも書けます。
- ひな型: よく使うシステム指示・指示文・お手本・答えの形を「AI ひな型」として保存し、複数のジョブで使い回せます。ジョブ側で指定した項目がひな型より優先されます。使われているひな型は削除できません。
- 資料参照: 社内のマニュアルなどのファイル(
manuals/*.mdのような指定も可)を参考資料として指示文に入れ、それに基づいて答えさせます。1 ファイル 1 MB・合計 8 MB まで、テキストのみです。モデルが受け付けられる長さを超えた場合は、黙って切り捨てずに異常終了にします(ローカル LLM が長い指示文の先頭を切り捨てた場合も検出します)。 - 試しに実行: ジョブやひな型の編集画面から、見本の値で 1 回問い合わせ、答え・変数・トークン数を確かめられます。ジョブネットは動きません。
- やり直し: 通信エラーや混雑(HTTP 429・5xx)のときだけ、指定した回数やり直します。
| 終了コード | 意味 |
|---|---|
| 0 | 答えを受け取った(形式も合った) |
| 1 | 答えの形式が合わない |
| 2 | 接続できない・認証エラー・モデルがない・設定の誤り |
| 3 | 時間切れ |
| 4 | 上限超え(トークン数・1 日の上限・資料が長すぎる) |
| 5 | AI が回答を拒否した |
| 6 | 入力ファイルを読めない・答えのファイルを書けない |
記録と使いすぎ防止 提供中
- ジョブごとに、使ったモデルと入力・出力のトークン数を記録します。Manager で AI 接続ごと・日ごとの使用量を確認できます。金額の計算は行いません。
- AI 接続ごとに 1 日のトークン数の上限を決められます。上限を超えると、新しい AI ジョブは送る前に終了コード 4 で止まります。ジョブごとに最大出力トークン数も決められます。
- 会話の記録(指示文と答え)を 1 ジョブ 1 MB まで保存します。資料参照のファイルは、名前だけを記録し、中身は残しません。記録の保存期間は実行履歴の保存期間に従います。
- 実行ログには、答えの先頭(約 8 KB)と使ったトークン数を残します。
Manager の実行詳細で会話の記録を表示する機能は 開発中 です。
AI 接続とキーの保護 提供中
- API キーは、サーバーが初回起動時に作る鍵で AES-256-GCM により暗号化して保存します。API の応答には含めず、「キーがあるかどうか」だけを返します。ログやエクスポートしたファイルにも入りません。
- エージェントは HTTPS の接続先の証明書を必ず検証します(Windows の信頼済みルート証明書、Linux の標準の証明書、または指定した CA)。検証せずに送る設定はありません。
- 社外へ出る接続先には、Manager で「社外にデータを送ります」と表示します。社内のプロキシを経由して社外へ出る設定もできます(社内の接続先にはプロキシを使いません)。
AI エージェント(ai_agent) 開発中
目的を渡すと、AI が許可された道具を使って何回か作業し、結果を返すジョブです。
- 道具: 作業フォルダーのファイル一覧・読み取り・書き込み、許可したコマンドの実行、結果の返却。作業フォルダーの外には出られません。
- コマンドは許可リストに合うものだけを、シェルを通さずに実行ユーザーで実行します(
;・|・>などは使えません)。 - やりとりの回数・合計トークン数・時間に上限を設けます。
- 人の確認が必要な業務では、AI エージェントの後ろに保留付きのジョブを置き、人が結果を見てから先へ進めます。
ローカル AI パック 開発中
名寄せ、OCR(画像からの文字の読み取り)、文章の読み取り・整形といった用途ごとに、設定済みの AI(モデルの指定・推奨設定・ひな型・サンプルのジョブネット)を選んで取り込めるようにします。
- 動かす土台は Ollama に統一します。エージェントがホストの CPU・メモリ・GPU・Ollama の有無を報告し、そのホストで動くパックだけを候補に出します。
- モデル本体は MATCHA から配布せず、取り込み時に Ollama が入手先から取得し、ハッシュを確かめます。モデルのライセンスは取り込み時に表示して同意を得ます。
- OCR のため、AI ジョブに画像を入力できるようにします。
エクスポート/インポート 提供中
ジョブネット・カレンダー・スケジュールと、ジョブが使うワークスペースのファイルを 1 つのファイル(.matcha)にまとめて持ち出し、別の MATCHA サーバーへ取り込む機能です。環境の移行やバックアップ、インターネットに出られない環境への持ち込みに使えます。
- 形式: UTF-8 の JSON 1 ファイル(形式名
matcha.package/1)。ファイルの内容は base64 で埋め込み、SHA-256 を付けます。中身を人が読めます。上限は 1 ファイル 64 MB(設定で変更可)です。 - 依存関係: 呼び出す・起動するジョブネット、保留解除の対象のジョブネット、スケジュールが使うカレンダーとジョブネット、ワークスペースのファイルを自動で一緒に入れます。
- 入れないもの: 実行ユーザーのパスワード、名前に PASSWORD・SECRET・TOKEN・API_KEY などを含む環境変数の値、ユーザーグループの設定、実行履歴、ホスト・ユーザー・通知チャネル・ライセンス。入らなかったものは一覧で表示します。
- 下見: 取り込む前に、中身・同じ ID の有無・どのホストで、どの実行ユーザーで、何が実行されるかの一覧を表示します。この時点では何も書き込みません。
- 割り当て: ファイルの中のホスト名・実行ユーザーを、取り込み先の名前に割り当てます。同じ ID があるものは「取り込まない」「上書き(新しい版として保存)」「別の ID で取り込む」から選び、別の ID にした場合は参照も書き換えます。
- 安全な取り込み: 取り込みは「全部入るか、何も入らないか」です。スケジュールは必ず停止した状態で取り込み、取り込んだ直後に動き出すことはありません。
Manager の「エクスポート/インポート」画面のほか、CLI の jbcs export / jbcs import でも同じことができます。操作は管理者だけが行えます。AI 接続とひな型をエクスポート/インポートの対象に加える機能は 開発中 です(AI 接続はホストと同じく取り込み時に割り当て、キーはファイルに入れません)。
通知と監視
通知 提供中
| 通知チャネル | 内容 |
|---|---|
| メール(SMTP) | STARTTLS(587 番など)、SSL(465 番)、平文から選べます。SMTP 認証に対応します。件名・本文は UTF-8 で、日本語のジョブネット名も化けません。宛先は 1 チャネル 8 件まで。 |
| Web フック | Slack・Mattermost 互換の形式({"text": …})で指定の URL に送ります。 |
- チャネルごとに、送る重大度の下限(info・warn・error・crit)を決めます。例えば、メールは warn 以上、チャットは error 以上だけ、のように分けられます。
- 通知する出来事: ジョブ・ジョブネットの異常終了、サーバー再起動による中断、ジョブネットの制限時間の超過(警告、または停止・スキップ)、ホストの応答なしと復旧。
- 送れなかった通知は、間隔を伸ばしながら送り直します。上限まで送れなかった通知は失敗として記録します。
- 「テスト送信」で設定を確かめられ、失敗したときは理由(接続できない、認証を拒否された、HTTP の応答など)を表示します。
通知先(メールサーバー・Web フックの接続先)とは暗号化して通信しますが、相手の証明書の検証は行いません。
ホストの監視 提供中
サーバーは登録した各ホストのエージェントに順番に問い合わせ、CPU 使用率・メモリ使用量・ディスク使用量を記録します。この問い合わせで応答の有無も確かめ、応答がなくなったときと復旧したときに通知します。応答がない間は、最後に計測できた値をその時刻とともに表示します。
ユーザーと権限 提供中
| ロール | できること |
|---|---|
| 管理者 | すべての操作。ジョブネット・スケジュール・カレンダー・ホスト・ワークスペース・通知チャネル・AI 接続の編集、ユーザーとライセンスの管理、エクスポート/インポート。 |
| オペレーター | すべての閲覧と、ジョブネットの実行・強制停止・保留解除、ワークスペースの配布。定義の変更はできません。 |
| 閲覧者 | 実行状況・ログ・定義の閲覧のみ。 |
- 権限はサーバーが API の呼び出しごとに確認します。Manager 以外から操作しても同じ制限がかかります。
- ジョブネットの公開範囲: ジョブネットごとに「全員」または「管理者と、選んだユーザーグループのメンバーだけ」を選べます。限定したジョブネットは、ほかのユーザーには一覧・実行監視・実行ログのどこにも表示されず、実行もできません。
- 安全策: 有効な管理者が 1 人もいなくなる変更はできません。パスワードは 8 文字以上です。パスワードを変えると、そのユーザーのほかのサインインはすべて無効になります。
- サインインのトークンの有効期限は 24 時間です。
Community Edition のユーザーは管理者 1 名です。複数のユーザーとロールは PRO Edition で使えます(エディションと制限)。
API とコマンドライン
問い合わせ API 提供中
- HTTPS + JSON の REST 形式です。
POST /loginで受け取ったトークンをAuthorization: Bearerヘッダーに付けて呼び出します。 - 応答は
{"ok": true, "data": …}または{"ok": false, "error": {"code": …, "message": …}}の共通の形です。 - 対象: 認証、ジョブネット定義、カレンダー・スケジュール、実行状況と操作(起動・強制停止・保留解除)、実行ログ、ホストと証明書、ユーザー・グループ、通知チャネル、ワークスペース、ライセンス、エクスポート/インポート、AI 接続・ひな型・試しに実行。
- Manager も同じ API を使っています。ほかのシステムから同じ操作ができます。
エンドポイントの詳細は API リファレンスをご覧ください。
コマンドライン(jbcs) 提供中
1 つのコマンドにサブコマンドを付けて使います。呼び出すたびにサインインし、トークンをディスクに保存しません。
jbcs execute -z <サーバー> -U <ユーザー> -P <パスワード> -j NIGHTLY jbcs status -z <サーバー> -U <ユーザー> -P <パスワード> -r 105
| サブコマンド | 内容 |
|---|---|
execute | ジョブネットを起動します。起動日時の指定、変数の受け渡しができます。 |
status | 実行の状態を表示し、状態を終了コードで返します(0 待機中、1 実行待ち、2 実行中、21 実行中・時間超過、22 実行中・エラーあり、3 正常終了、4 異常終了、5 強制停止・中断)。 |
list | 最近の実行を一覧表示します。 |
abort | 実行を強制停止します。 |
release | 保留中のジョブを解除します。 |
logs | 実行ログをジョブネット・ジョブ・実行・期間で検索します。 |
export / import | エクスポート/インポート(取り込みの下見だけを行う指定もできます)。 |
引数・接続・認証・サーバー側のエラーでは、終了コード 255 を返します。
データベース
- サーバーに SQLite を内蔵しています。データは 1 つのデータベースファイルに保存され、別のデータベース製品のインストールや管理は要りません。
- テーブルは役割ごとに名前の接頭辞で分けています:
mst_(定義)、sts_(実行の状態)、hst_(追記だけの履歴・ログ)、sys_(システムの設定)、ui_(画面表示だけに使う情報。なくてもジョブの実行に影響しない)。 - 版の管理: ジョブネット・カレンダー・スケジュールは、更新のたびに新しい版を追加し、前の版を残します。削除も論理削除で、過去の実行の記録はそのまま残ります。
- 実行時の写し: 実行を始めるときに、ジョブの設定を実行用のテーブルにコピーします。過去の実行が、その時点でどの設定で動いたかが分かります。
- 保存期間: Community Edition は 30 日分の実行履歴を保存し、それより古い実行・ログ・送信済みの通知・AI の使用量と会話の記録は毎時自動で削除します。PRO Edition は既定ですべて保存し、保存日数(1〜36500 日)を設定できます。
- マシンの入れ替えや移設では、データベースのフォルダーごと移せば、定義・履歴・サーバー ID(ライセンスの対象)がそのまま引き継がれます。
信頼性・クラッシュ耐性
ジョブスケジューラで最も避けるべきことは、「実行したのか、していないのか分からない」状態です。MATCHA は、想定外の終了があっても記録が欠けないように作っています。
サーバー 提供中
- 状態と記録を同時に書く: ジョブやジョブネットが終わる(正常終了・異常終了・強制停止・中断)ときは、状態の更新と、終了時刻・理由の実行ログへの記録を、必ず 1 つのトランザクションで行います。片方だけが書かれた状態は残りません。
- 起動時の整合性確認: サーバーは起動するとき、ほかの処理を始める前に、前回実行中のまま残っていたジョブネットとジョブを探します。見つかったものは「中断(結果不明)」として終了時刻を記録し、通知します。意図的な強制停止とは区別して記録します。
- 送れなかった指示: エージェントへ指示を送れなかったジョブは、異常にせずに次の周期で送り直します。
- クラッシュの記録: 致命的なエラーで止まるときも、その内容をログに書いてから終了します。
- サーバーは 1 台で動かす構成です。冗長構成(HA)は PRO Edition の機能として 予定 です。
エージェント 提供中
- ジョブの起動失敗・実行中のクラッシュ・ワーカーの異常終了・時間切れを検知し、必ず結果として報告します。ジョブが「実行中」のまま止まらないようにしています。
- エージェント自体が異常終了したときは、自動で再起動します(Windows はサービスの回復機能、Linux は systemd またはスーパーバイザー)。クラッシュの内容はログに残します。
- 複数のプロセスが同時にログを書いても、1 行が混ざらないようにしています。
エージェントがジョブの結果をサーバーへ届けられなかった場合、現在はエラーをログに記録します。届くまで結果を保存して送り直す機能は 予定 です。
セキュリティ
| 項目 | 内容 |
|---|---|
| 通信の暗号化 | サーバーとエージェントは相互 TLS(必須)、Manager・CLI とサーバーは HTTPS。TLS は mbedTLS で実装しています。 |
| エージェントの証明書 | ホストごとにサーバーが発行し、失効できます。エージェントはサーバーの証明書を持つ相手からだけ処理を受け付けます。 |
| サーバーの証明書 | Manager ははじめての接続で指紋を確認させ、変わったときは警告します。 |
| 認証 | ユーザーのパスワードは PBKDF2-SHA256(10 万回)のハッシュで保存します。ログインの失敗は、ユーザー名の誤りとパスワードの誤りを区別せず、同程度の処理時間で返します。 |
| 権限 | 3 つのロールとジョブネットの公開範囲を、サーバーが API の呼び出しごとに確認します。 |
| 秘密の扱い | AI の API キーは AES-256-GCM で暗号化して保存します。実行ユーザーのパスワード、SMTP のパスワード、API キーは API で読み出せません(書き込みのみ)。エクスポートしたファイルにはパスワード・キーを入れません。 |
| 実行ユーザーのパスワード | エージェントへは暗号化した通信で送り、エージェントは使い終わるとメモリから消去します。サーバーのデータベース内での暗号化保存は 予定 です。 |
| エージェントの権限 | Linux では root 権限での起動を既定で拒否します。秘密鍵ファイルがほかのユーザーから読める設定になっていると警告します。 |
| ライセンス | ライセンスファイルは ECDSA P-256 で署名し、サーバー ID に結び付けます。内容が変更されたもの・別のサーバー用のものは適用されません。 |
| AI の安全 | AI ジョブは登録した接続先だけを使い、HTTPS の証明書を必ず検証します。社外へ送る接続先は画面で明示します。AI エージェントは許可した道具とコマンドだけを使えます(開発中)。 |
動作環境
| プログラム | OS | 備考 |
|---|---|---|
| Manager | Windows 10 / 11(x64) | .NET・Avalonia。日本語・英語 |
| サーバー | Windows 10 / 11(Manager から作成)、Linux(RHEL 8 / 9 互換、x86_64) | SQLite 内蔵。外部のデータベースは不要 |
| エージェント | Windows(Windows Server 2019 以降、Windows 10 / 11)、Linux(x86_64) | Windows はサービスまたは通常のプログラム、Linux は systemd で起動 |
| ローカル AI(任意) | Ollama が動くホスト | モデルに応じたメモリ・GPU が必要。Ollama は利用者がインストールします |
導入の流れはドキュメント 概要をご覧ください。
エディションと制限
| Community Edition | PRO Edition | |
|---|---|---|
| 価格 | 無料 | 買い切り(永久ライセンス)。PRO 25 / PRO 100 / PRO Unlimited |
| ホスト(エージェント) | 5 台まで | 25 台 / 100 台 / 無制限 |
| ユーザー | 管理者 1 名 | 上限なし(3 つのロール、ユーザーグループ) |
| 実行履歴の保存期間 | 30 日 | 既定ですべて保存。日数を設定可能 |
| ジョブの実行・監視・編集、通知、API、CLI、AI ジョブ、エクスポート/インポート | 使えます | 使えます |
| 冗長構成(HA) | — | 予定 |
| サポート | ドキュメント | 1 年間無償(専用窓口)、2 年目以降は年額で更新 |
- 上限はサーバーがライセンスを確認して守ります。上限を超える追加は「ライセンスの上限に達しています」として拒否します。
- ライセンスはサーバー ID(サーバーの初回起動時に作られ、データベースに保存される ID)に対して発行します。Manager で適用するとすぐに切り替わり、サーバーの再起動は要りません。
- PRO から Community に戻しても、上限を超えるホストやユーザーは削除されません(新しく追加できなくなります)。
価格はエディションの比較表をご覧ください。
主な制限値
| 項目 | 値 |
|---|---|
| 同時実行ジョブ数(エージェントごと) | 既定 5(設定で変更可) |
| ジョブの出力(標準出力・標準エラー) | 1 ジョブ 1 MB まで |
| エクスポートファイル | 64 MB まで(設定で変更可) |
| AI の入力ファイル・資料 | 1 ファイル 1 MB、資料は合計 8 MB まで(テキストのみ) |
| AI の会話の記録 | 1 ジョブ 1 MB まで |
| サインインの有効期限 | 24 時間 |
| 実行履歴の保存日数(PRO) | 1〜36500 日、またはすべて保存 |
開発状況
現在は発売前のプレビュー段階です。PHASE 1 の機能がそろった時点で発売します。
| 機能 | 内容 | 状態 |
|---|---|---|
| スケジューラ | スケジュール・カレンダーによる起動、多重起動の制御、制限時間、AND 結合と条件分岐、ジョブネットの呼び出し・起動、保留と保留解除 | 提供中 |
| ジョブの種類 | コマンド実行、変数設定、計算、条件分岐、終了、ジョブネット呼び出し・起動、保留解除、AI 問い合わせ | 提供中 |
| エージェント | 相互 TLS、証明書の発行と失効、同時実行、制限時間、実行ユーザー、クラッシュの検知と自動再起動 | 提供中 |
| ワークスペース | ファイルの差分配布、アウトプットの回収と集約 | 提供中 |
| 通知と監視 | メール・Web フック、ホストの計測と応答確認 | 提供中 |
| ユーザーと権限 | 3 つのロール、ユーザーグループ、ジョブネットの公開範囲 | 提供中 |
| ライセンス | サーバー ID に結び付けたライセンス、実行履歴の保存期間 | 提供中 |
| API・CLI | HTTPS + JSON の API、コマンドライン(jbcs) | 提供中 |
| エクスポート/インポート | ジョブネット・カレンダー・スケジュールとワークスペースのファイル | 提供中 |
| AI 問い合わせ | Claude・OpenAI・OpenAI 互換(ローカル LLM)、ひな型、お手本、資料参照、試しに実行、使用量と会話の記録、API キーの暗号化 | 提供中 |
| AI エージェント | 道具と会話の繰り返し、上限 | 開発中 |
| AI の記録の表示 | Manager の実行詳細で会話の記録を表示 | 開発中 |
| AI のエクスポート/インポート | AI 接続(取り込み時に割り当て)とひな型 | 開発中 |
| ローカル AI パック | 用途とホストのスペックで選ぶ Ollama のモデル、画像の入力(OCR) | 開発中 |
| サンプル | 業務別のジョブネットの例 | 開発中 |
| マーケットプレイス | ジョブネット・AI ひな型の配布と販売 | 予定 |
| 契約ユーザー専用ページ | ご契約のお客様向けのページ | 予定 |
| 冗長構成(HA) | PRO Edition の機能 | 予定 |
| ファイルコピージョブ | ホスト間のファイルコピー(file_copy) | 予定 |
| 実行中のジョブの停止 | 強制停止したとき、エージェントで実行中のプロセスも止める | 予定 |
| 結果の再送 | エージェントが結果を届けられなかったときに保存して送り直す | 予定 |
| 実行ユーザーのパスワードの暗号化保存 | サーバーのデータベース内での暗号化 | 予定 |
機能の全体像はドキュメント 概要、画面の使い方は操作マニュアルをご覧ください。
最終更新: 2026年10月28日