機能フラグ

概要

Shannonはフィーチャーフラグを使用して、コードを変更することなくオプション機能、実験的機能、エンタープライズ拡張を制御します。これにより、以下のクリーンな分離が可能になります：

オープンソースのコア機能（すべての人が利用可能）
エンタープライズ/プライベート機能（フラグの背後に制限）
実験的機能（テスト用に切り替え可能）

ゼロ再コンパイル

サービスを再構築せずに機能を有効/無効にする

環境ベース

開発/ステージング/本番用の異なるフラグ

クリーンな分離

OSSコアから隔離されたエンタープライズ機能

段階的ロールアウト

完全な展開前に新機能をテストする

設定

設定ファイル

フィーチャーフラグは、config/shannon.yamlのfeaturesセクションで定義されています：

# config/shannon.yaml
features:
  # エンタープライズワークフロー機能
  ads_research: false              # 広告リサーチワークフロー（エンタープライズ）
  advanced_synthesis: false        # 高度な合成テンプレート

  # 実験的機能
  parallel_streaming: true         # マルチエージェントの並列ストリーミング
  enhanced_memory: false           # 拡張ベクトルメモリ

  # カスタム統合
  vendor_tools_enabled: false      # ベンダー固有のツールを有効にする

環境変数

フィーチャーフラグは環境変数で上書きできます：

# .env
SHANNON_FEATURE_ADS_RESEARCH=true
SHANNON_FEATURE_PARALLEL_STREAMING=false

命名規則: SHANNON_FEATURE_<FLAG_NAME_UPPERCASE>

優先順位

環境変数（最優先）
設定オーバーレイ（config/overlays/shannon.{env}.yaml）
ベース設定（config/shannon.yaml）
コードデフォルト（最低優先）

使用パターン

Goコード内（オーケストレーター）

package main

import (
    "github.com/Kocoro-lab/Shannon/go/orchestrator/internal/config"
)

func routeWorkflow(ctx context.Context, req *pb.Request) error {
    cfg, _ := config.LoadShannon()

    // フィーチャーフラグをチェック
    if cfg.Features.AdsResearch {
        return routeToAdsResearchWorkflow(ctx, req)
    }

    return routeToStandardWorkflow(ctx, req)
}

Pythonコード内（LLMサービス）

from llm_service.config import load_shannon_config

config = load_shannon_config()

# フィーチャーフラグをチェック
if config.get("features", {}).get("vendor_tools_enabled"):
    from llm_service.tools.vendor import register_vendor_tools
    register_vendor_tools()

条件付きインポートパターン

フィーチャーフラグを使用して条件付きインポートを行い、クリーンな分離を実現します：

# roles/presets.py
_PRESETS = {
    "general": GENERAL_PRESET,
    "research": RESEARCH_PRESET,
}

# エンタープライズロールを条件付きで読み込む
if config.get("features", {}).get("ads_research"):
    try:
        from .enterprise.ads_analyst import ADS_ANALYST_PRESET
        _PRESETS["ads_analyst"] = ADS_ANALYST_PRESET
    except ImportError:
        pass  # Shannonはエンタープライズモジュールなしで動作します

一般的なフィーチャーフラグ

フラグ名	タイプ	説明	デフォルト
`ads_research`	エンタープライズ	市場分析を伴う広告リサーチワークフロー	`false`
`parallel_streaming`	実験的	マルチエージェントの並列SSEストリーミング	`true`
`advanced_synthesis`	エンタープライズ	カスタム合成テンプレート	`false`
`vendor_tools_enabled`	統合	ベンダー固有のツールアダプターを有効にする	`false`
`enhanced_memory`	実験的	ハイブリッド検索を伴う高度なベクトルメモリ	`false`

ベストプラクティス

1. デフォルトは無効にする

新機能はベース設定でfalseにデフォルト設定するべきです：

# config/shannon.yaml
features:
  new_feature: false  # ✅ 安全なデフォルト

2. 環境オーバーレイを使用する

異なるデプロイメント用に環境固有のオーバーレイを作成します：

# config/overlays/shannon.production.yaml
features:
  ads_research: true
  parallel_streaming: true
  enhanced_memory: false  # まだテスト中

次のように読み込みます：

SHANNON_CONFIG_PATH=config/overlays/shannon.production.yaml

3. Try/Exceptでガードする

エンタープライズ/オプション機能には常に優雅なフォールバックを使用します：

if config.features.vendor_tools_enabled:
    try:
        from .vendor import CustomVendorTool
    except ImportError:
        logger.warning("ベンダーツールが利用できないため、標準ツールを使用します")

4. フィーチャー要件を文書化する

features:
  # GA4_SERVICE_ACCOUNT_KEY環境変数が必要
  # ベンダーモジュール: llm_service/tools/vendor_adapters/ga4/
  ga4_integration: false

エンタープライズフィーチャーパターン

ShannonはOSSコアとエンタープライズ拡張をフィーチャーフラグを使用して分離します：

ファイル構造

Shannon/
├── config/
│   ├── shannon.yaml                    # ベース設定（OSS）
│   └── overlays/
│       └── shannon.enterprise.yaml     # エンタープライズフラグ
├── go/orchestrator/
│   └── internal/workflows/
│       ├── standard_workflow.go        # OSSワークフロー
│       └── enterprise/                 # エンタープライズワークフロー
│           └── ads_research.go         # フラグで制限
└── python/llm-service/
    └── llm_service/
        ├── roles/
        │   ├── presets.py              # OSSロール + 条件付き読み込み
        │   └── enterprise/             # エンタープライズロール
        │       └── ads_analyst.py      # フラグで制限
        └── tools/
            └── vendor_adapters/        # ベンダーツール（制限付き）

条件付きワークフロールーティング

// orchestrator/internal/workflows/router.go
func SelectWorkflow(ctx context.Context, cfg *config.Shannon, req *pb.Request) Workflow {
    // エンタープライズ機能フラグの確認
    if cfg.Features.AdsResearch && req.Context["workflow_type"] == "ads_research" {
        return NewAdsResearchWorkflow()
    }

    // OSSワークフローにフォールバック
    return NewStandardWorkflow()
}