フレームワークのAI統合アーキテクチャ

CodeSpiritは.NET 10とAspireを基盤とするAIファースト設計の低コード開発フレームワークです。大規模言語モデルを基盤コンポーネントからアプリケーション層まで深く統合し、開発プロセス全体をAIで強化します。

AI機能レイヤー構成

基盤インフラストラクチャ

• CodeSpirit.LLM - 統一LLM統合層（OpenAI、阿里雲、DeepSeekなど複数モデル対応）
• CodeSpirit.LLM.Audit - 完全な監査システム（プロンプト、レスポンス、トークン使用量、コスト記録）

機能コンポーネント

• AIフォーム自動入力 - 設定不要でAIエンドポイントを自動生成
• AIインポートウィザード - 非構造化テキストの解析と自動フォーマット修正
• スマートチャート生成 - データ特性分析による最適可視化提案
• AIカードシステム - インテリジェントなコンテンツ管理

アプリケーションシナリオ

• AIアシスタントシステム - シナリオ特化型AI（試験分析官、問題作成官など）
• Pathfinderインテリジェントツール - AI駆動のタスク自動評価
• AI Form長タスク処理 - 非同期生成、進捗追跡、ストリーミング対応

阿里雲通義千問の利点

無料枠の充実

新規ユーザー登録で500万トークンの無料利用枠を提供。開発・テスト段階では十分な容量です。

モデル性能比較

モデル	応答速度	推論能力	推奨用途
qwen-turbo	高速	標準	日常開発、高頻度呼び出し
qwen-plus	中速	高精度	複雑な業務ロジック
qwen-max	標準	最高精度	基幹機能、本番環境

国内サービス優位性

• 国内サーバーによる低遅延アクセス
• コンプライアンス要件への適合
• 安定した接続品質

設定手順

APIキーの取得

1. 阿里雲プラットフォームにアクセス
2. アカウント登録/ログイン（新規ユーザーは無料枠付与）
3. キー管理コンソールでAPIキーを生成

フレームワーク設定

User Secretsを使用した安全な設定管理：

dotnet user-secrets set "llm-service:base-url" "https://dashscope.aliyuncs.com/compatible-mode/v1"
dotnet user-secrets set "llm-service:model" "qwen-turbo"  
dotnet user-secrets set "llm-service:api-key" "YOUR_API_KEY_HERE"

設定検証

アプリケーション起動：

aspire run

AI機能テストケース

フォーム自動入力

1. 試験システム → 問題管理 → 新規作成
2. 「主題」フィールドに「データベース索引最適化」と入力
3. AI入力ボタンをクリック
4. 自動生成された内容を確認

AIインポート処理

1. バッチインポート機能を選択
2. Word形式の問題テキストを貼り付け
3. 「AI解析と審査」を実行
4. 修正後のプレビューを確認してインポート

AIアシスタント対話

1. AIアシスタントシステムにアクセス
2. 「試験分析官」ロールを選択
3. 「今日の試験スケジュールは？」と質問
4. 構造化レポートの生成を確認

コスト管理

利用シナリオ別予測

利用規模	1日あたり呼び出し	月間トークン消費	費用見積もり
個人学習	10-50回	約50万	無料枠内
小規模プロジェクト	100-500回	約200万	無料枠内
中規模アプリ	1000回以上	約800万	10-30元/月

コスト最適化戦略

• インテリジェントキャッシュ機構の活用（フレームワーク標準）
• 用途に応じた適切なモデル選択
• バッチ処理の効率化
• 監査ログによる使用状況モニタリング

技術的注意点

モデル互換性

CodeSpiritはOpenAI互換APIをサポートしており、他のLLMサービスへの切替が可能：

dotnet user-secrets set "llm-service:base-url" "https://api.openai.com/v1"
dotnet user-secrets set "llm-service:model" "gpt-3.5-turbo"

セキュリティ設定

APIキーはUser Secretsまたは環境変数で管理し、コードリポジトリにはコミットしないでください。