GizClaw/flowcraft

解決する課題

FlowCraftは、特定のモデルプロバイダーや実行モデルに依存することなく、拡張性の高いAIアプリケーションを構築するために設計されたモジュール式のGoツールキットです。エージェントの実行、長期記憶、プラグインベースのアプリケーション構成を標準化された方法で提供し、開発者がプロバイダーやバックエンドを容易に入れ替えられるようにします。

仕組み

このプロジェクトはいくつかのレイヤーで構成されています：

• Core: エージェント、グラフ、ツール、メモリの実行コントラクトを定義します。グラフをエージェントエンジンにコンパイルするための宣言型DAGエンジンが含まれています。
• Craft: craft.yaml 定義とコンパイル時の機能を使用してアプリケーションを構築するアセンブリレイヤーです。プラグインが MCP (Model Context Protocol) サーバーとして動作するプラグインホストを管理します。
• Drivers & Backends: プロバイダー固有のアダプター（例：OpenAI, Anthropic）や、メモリ (SQLite) およびシークレットストレージのプラットフォーム実装です。
• Runtime: リースされた中断可能なストリーミングセッションを管理し、YAMLドキュメントで定義されたリソースのデプロイを処理します。

対象ユーザー

プロバイダー非依存性、永続的な実行（一時停止/再開）、および機能を拡張するためのプラグインベースのアーキテクチャを必要とする、複雑なAIエージェントやアプリケーションを構築するGo開発者。

ハイライト

• プラグイン可能なメモリ: メモリは、コアコントラクトの背後に登録されたプラグイン可能な実装として扱われます。
• 永続的な実行: 再起動をまたいでエージェントを一時停止・再開するためのチェックポイントをサポートし、構造化されたテレメトリのためにサブジェクトルーティングされたイベントバスを使用します。
• 統合された推論: 複数のプロバイダー（OpenAI, Anthropic, ByteDance, MiniMax）にわたる生成、埋め込み、文字起こしのための単一のランタイム。
• MCP統合: プラグインはMCPサーバーとして動作し、ホストは自身のプリミティブをMCPツールとして公開し、プラグインが呼び出せるようにします。
• サンドボックス実行: エージェントの実行境界を分離するための組み込みサンドボックスバックエンド (bwrap, seatbelt) を含みます。