Mixseek Orchestrator Config

MixSeek オーケストレーター設定生成

概要

MixSeek-Coreのオーケストレーター設定ファイル（orchestrator.toml）を生成します。複数のチームを並列実行し、評価者による判定を経て最良の回答を選択するTUMIX（TUrnament-style MIXture of experts）フレームワークの設定を定義します。

前提条件

• ワークスペースが初期化されていること（mixseek-workspace-init参照）
• 1つ以上のチーム設定ファイルが存在すること（mixseek-team-config参照）
• 評価設定が存在すること（mixseek-evaluator-config参照、オプション）

使用方法

Step 1: 要件のヒアリング

ユーザーに以下を確認してください:

1. 競合させるチーム: どのチーム設定を使用するか 2. ラウンド設定: 何ラウンド実行するか（デフォルト: 2-5ラウンド） 3. タイムアウト設定: チームごとの制限時間

Step 2: 既存チーム設定の確認

ワークスペース内のチーム設定を確認:

ls $MIXSEEK_WORKSPACE/configs/agents/team-*.toml

Step 3: 設定ファイルの生成

以下のテンプレートを基に設定ファイルを生成:

[orchestrator]
timeout_per_team_seconds = 600
max_rounds = 5
min_rounds = 2

[[orchestrator.teams]]
config = "configs/agents/team-a.toml"

[[orchestrator.teams]]
config = "configs/agents/team-b.toml"

Step 4: ファイルの保存

生成した設定を以下のパスに保存:

$MIXSEEK_WORKSPACE/configs/orchestrator.toml
# または
$MIXSEEK_WORKSPACE/configs/orchestrator-<name>.toml

Step 5: 設定ファイルの検証（必須）

生成後は必ず検証を実行してください。

uv run python skills/mixseek-config-validate/scripts/validate-config.py \
    $MIXSEEK_WORKSPACE/configs/orchestrator.toml --type orchestrator

検証が成功したら、ユーザーに結果を報告します。失敗した場合は、エラー内容を確認して設定を修正してください。

TUMIX（Tournament-style Mixture of Experts）とは

MixSeek-Coreのコア機能で、以下のフローで動作します:

1. Submission Phase: 各チームが並列でタスクを実行し、回答（Submission）を生成 2. Evaluation Phase: 評価者が各Submissionをスコアリング 3. Judgment Phase: 判定者が最終的な勝者を決定 4. Tournament: 上記を複数ラウンド繰り返し、最良の結果を選出

設定項目

ラウンド設定

注意: min_rounds <= max_rounds である必要があります。

タイムアウト設定

例

2チーム競合設定

User: 2つのチームで競わせる設定を作って

Agent: オーケストレーター設定を提案します。

       既存のチーム設定を確認しました:
       - configs/agents/team-web-research.toml
       - configs/agents/team-analysis.toml

       設定:
       - 最大ラウンド数: 5
       - 最小ラウンド数: 2
       - チームタイムアウト: 600秒

       この構成でよろしいですか？

User: はい

Agent: 設定ファイルを生成しました:
       orchestrator.toml

       実行コマンド:
       mixseek exec --config orchestrator.toml

生成される設定ファイル例

# MixSeek Orchestrator Configuration
# Generated by mixseek-orchestrator-config skill

[orchestrator]
# ラウンド設定
max_rounds = 5
min_rounds = 2

# タイムアウト設定
timeout_per_team_seconds = 600
submission_timeout_seconds = 300
judgment_timeout_seconds = 60

# 競合チーム設定
[[orchestrator.teams]]
config = "configs/agents/team-web-research.toml"

[[orchestrator.teams]]
config = "configs/agents/team-analysis.toml"

3チーム以上の競合設定

[orchestrator]
max_rounds = 3
min_rounds = 2
timeout_per_team_seconds = 900

[[orchestrator.teams]]
config = "configs/agents/team-creative.toml"

[[orchestrator.teams]]
config = "configs/agents/team-analytical.toml"

[[orchestrator.teams]]
config = "configs/agents/team-practical.toml"

実行方法

CLIコマンド

# 基本実行
mixseek exec --config orchestrator.toml

# 詳細ログ付き
mixseek exec --config orchestrator.toml --log-level debug

# Logfire観測付き
mixseek exec --config orchestrator.toml --logfire

UIからの実行

# UI起動
mixseek ui

# 「実行」ページでorchestrator.tomlを選択して実行

トラブルシューティング

チーム設定ファイルが見つからない

Error: Team config not found: configs/agents/team-xxx.toml

解決方法: 1. ファイルパスが正しいか確認 2. $MIXSEEK_WORKSPACEからの相対パスで指定 3. mixseek-team-configスキルでチーム設定を作成

ラウンド設定エラー

Error: min_rounds must be <= max_rounds

解決方法:

• min_roundsをmax_rounds以下に設定

タイムアウトエラー

Error: Team execution timed out

解決方法: 1. timeout_per_team_secondsを増加 2. チームのtimeout_seconds設定を確認 3. Member Agent数を削減

評価・判定設定との連携

オーケストレーターは以下の設定ファイルと連携します:

• evaluator.toml: Submissionのスコアリング設定
• judgment.toml: 最終判定の設定

これらはmixseek-evaluator-configスキルで生成できます。

参照

• TOMLスキーマ詳細: references/TOML-SCHEMA.md
• チーム設定: skills/mixseek-team-config/
• 評価設定: skills/mixseek-evaluator-config/

Orchestrator Configuration TOML Schema

概要

オーケストレーター設定ファイル（orchestrator.toml）のスキーマ定義です。複数チームの並列実行とTUMIXトーナメントの設定を定義します。

ファイル配置

• パス: $MIXSEEK_WORKSPACE/orchestrator.toml
• または: $MIXSEEK_WORKSPACE/configs/orchestrator-<name>.toml

必須フィールド

[[orchestrator.teams]] セクション（1つ以上必須）

オプションフィールド

[orchestrator] セクション

設定ファイルパス（重要）

`evaluator_config`、`judgment_config`、`prompt_builder_config` を指定しない場合、以下のデフォルトパスが検索されます：

注意: カスタムパス（例：configs/evaluators/evaluator.toml）を使用する場合は、必ず明示的に指定してください。指定しないとデフォルト設定（Gemini等）が使用されます。

[orchestrator]
# カスタムパスを使用する場合は明示的に指定
evaluator_config = "configs/evaluators/evaluator.toml"
judgment_config = "configs/judgment/judgment.toml"
prompt_builder_config = "configs/prompt_builder.toml"

バリデーションルール

1. ラウンド設定: min_rounds <= max_rounds 2. チーム数: 1つ以上のチーム設定が必要 3. チーム設定ファイル: 指定されたパスにファイルが存在すること

# バリデーション例
assert orchestrator.min_rounds <= orchestrator.max_rounds
assert len(orchestrator.teams) >= 1
for team in orchestrator.teams:
    assert os.path.exists(workspace / team.config)

完全な設定例

最小構成

[[orchestrator.teams]]
config = "configs/agents/team-a.toml"

[[orchestrator.teams]]
config = "configs/agents/team-b.toml"

標準構成

[orchestrator]
max_rounds = 5
min_rounds = 2
timeout_per_team_seconds = 600

[[orchestrator.teams]]
config = "configs/agents/team-web-research.toml"

[[orchestrator.teams]]
config = "configs/agents/team-analysis.toml"

フル構成

[orchestrator]
# ラウンド設定
max_rounds = 5
min_rounds = 2

# タイムアウト設定
timeout_per_team_seconds = 900
submission_timeout_seconds = 600
judgment_timeout_seconds = 120

# 関連設定ファイル（カスタムパス使用時は必須）
evaluator_config = "configs/evaluators/evaluator.toml"
judgment_config = "configs/judgment/judgment.toml"
prompt_builder_config = "configs/prompt_builder.toml"

# 競合チーム設定
[[orchestrator.teams]]
config = "configs/agents/team-creative.toml"

[[orchestrator.teams]]
config = "configs/agents/team-analytical.toml"

[[orchestrator.teams]]
config = "configs/agents/team-practical.toml"

TUMIX実行フロー

┌─────────────────────────────────────────────────────────┐
│                    Orchestrator                          │
│                                                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │              Round N (min_rounds ~ max_rounds)   │    │
│  │                                                  │    │
│  │  ┌─────────┐  ┌─────────┐  ┌─────────┐         │    │
│  │  │ Team A  │  │ Team B  │  │ Team C  │  ...    │    │
│  │  └────┬────┘  └────┬────┘  └────┬────┘         │    │
│  │       │            │            │               │    │
│  │       ▼            ▼            ▼               │    │
│  │  ┌─────────────────────────────────────────┐   │    │
│  │  │         Submissions (並列生成)           │   │    │
│  │  └─────────────────────────────────────────┘   │    │
│  │                      │                          │    │
│  │                      ▼                          │    │
│  │  ┌─────────────────────────────────────────┐   │    │
│  │  │         Evaluator (スコアリング)         │   │    │
│  │  └─────────────────────────────────────────┘   │    │
│  │                      │                          │    │
│  │                      ▼                          │    │
│  │  ┌─────────────────────────────────────────┐   │    │
│  │  │         Judgment (最終判定)              │   │    │
│  │  └─────────────────────────────────────────┘   │    │
│  │                      │                          │    │
│  │                      ▼                          │    │
│  │              Round Winner                       │    │
│  └─────────────────────────────────────────────────┘    │
│                         │                                │
│                         ▼                                │
│                  Final Winner                            │
└─────────────────────────────────────────────────────────┘

関連設定ファイル

評価設定（evaluator.toml）

# $MIXSEEK_WORKSPACE/configs/evaluators/evaluator.toml
default_model = "google-gla:gemini-2.5-pro"

[[metrics]]
name = "ClarityCoherence"
weight = 0.34

[[metrics]]
name = "Coverage"
weight = 0.33

[[metrics]]
name = "Relevance"
weight = 0.33

判定設定（judgment.toml）

# $MIXSEEK_WORKSPACE/configs/judgment/judgment.toml
model = "google-gla:gemini-2.5-pro"
temperature = 0.0

パス解決

チーム設定ファイルのパスは $MIXSEEK_WORKSPACE からの相対パスで指定します:

# 正しい例
[[orchestrator.teams]]
config = "configs/agents/team-a.toml"

# 誤った例（絶対パス）
[[orchestrator.teams]]
config = "/home/user/workspace/configs/agents/team-a.toml"  # ❌

トラブルシューティング

Evaluator/JudgmentでデフォルトモデルGeminiが使用される

症状: evaluator.tomlやjudgment.tomlでClaudeCodeを設定したのに、ログでGeminiが使用されている

原因: orchestrator.tomlにevaluator_configとjudgment_configのパスが指定されていない

解決策:

[orchestrator]
# カスタム設定ファイルのパスを明示的に指定
evaluator_config = "configs/evaluators/evaluator.toml"
judgment_config = "configs/judgment/judgment.toml"

注意: デフォルトではconfigs/evaluator.tomlとconfigs/judgment.tomlが検索されます。configs/evaluators/やconfigs/judgment/などのカスタムパスを使用する場合は、必ず明示的に指定してください。

チーム設定が見つからない

Error: Team config not found

• ワークスペースパスを確認: echo $MIXSEEK_WORKSPACE
• ファイルの存在を確認: ls $MIXSEEK_WORKSPACE/configs/agents/
• パスが相対パスであることを確認

ラウンド設定エラー

Error: min_rounds > max_rounds

• min_roundsをmax_rounds以下に設定

タイムアウト値エラー

Error: timeout_per_team_seconds must be between 10 and 3600

• 値を10-3600の範囲内に設定