AI Building Generator
概要
自然言語プロンプトから BuildingData (v5.5.0 スキーマ準拠) を AI が生成 するコンポーネントです。LLM プロバイダ (OpenAI / Anthropic / Google Gemini) のいずれかを選択し、.mbpkey で管理する API キーを使って呼び出します。
- グループ: 1. Import and Generate
- ニックネーム:
AIGen - Exposure: Secondary
- v5.5.0 新規
重要 (Must Read)
⚠️ AI は誤りを犯す可能性があります。設計内容は必ず設計者自身が確認してください。
本コンポーネントは
Comp_I09 Diff & Approvalと組み合わせて使うことを前提に設計されています。AI 出力を直接Comp_S01 BuildModel等に渡すことは推奨されません。
詳細: AI 機能 利用規約
機能
- 3 プロバイダ対応 (OpenAI / Anthropic / Google Gemini)
- v5.5.0 schema 全面対応プロンプト (Justification / Revit_Family_Type / Design_Phase / Slab_On_Beam)
- 構造化出力 (
response_format=json_object等) - コスト見積もり (入力プロンプト文字数ベース、表示は概算値)
- Rate Limiter (連続呼出抑制)
- Response Cache (同じプロンプトの再実行で API 呼出抑制)
- Prompt Sanitizer (プロジェクト名等の機密情報自動除去)
- 初回利用時に
PrivacyNoticeFormで同意取得 - セキュリティ監査 R-001 / R-002 / R-006 / R-014 対応済
入力パラメータ (主要)
| パラメータ名 | 型 | 説明 |
|---|---|---|
| Prompt | String | 自然言語プロンプト |
| Provider | Integer | 0=OpenAI / 1=Anthropic / 2=Gemini |
| Model | String | (任意) モデル名 override |
| KeyFile | String | .mbpkey パス (空ならデフォルト位置) |
| MaxTokens | Integer | 出力上限トークン |
| Temperature | Number | 0.0〜1.0 |
| CacheTTL | Integer | キャッシュ有効秒数 |
| UseCache | Boolean | キャッシュ使用 |
| Generate | Boolean | false→true のエッジで生成実行 |
出力パラメータ
| パラメータ名 | 型 | 説明 |
|---|---|---|
| BuildingData | Generic | 生成された建物データ (v5.5.0 schema) |
| Cost | Number | 推定コスト (USD) |
| Notes | String | 警告・モデルからの補足説明 |
| Success | Boolean | 生成成功 |
v5.5.0 schema 出力ルール
PromptBuilder が LLM に指示する v5.5.0 ルール:
- JSON object のみ出力 (説明文等は混入禁止)
$schemaはhttps://makebuildingpro.com/schema/v5.5.0を使用versionフィールドは"5.5.0"- ユーザーが明示要求しない場合、新規 optional フィールド (
Justification,Revit_Family_Type等) は省略 (default に従う) - Justification は
Top/Center/Bottom、Design_Phase は 4 enum 内、を厳守 Instance_ID命名規約に従う (C_1F_X1_Y1等)
セキュリティ機構
| Layer | 内容 |
|---|---|
| PromptSanitizer | 機密候補 (プロジェクト名・氏名・住所・電話・メール・URL) を [REDACTED] で抹消 |
| RateLimiter | 同一プロバイダへの連続呼出を抑制 |
| ResponseCache | 同一プロンプトに対する重複呼出を抑制 |
| ResponseValidator | 戻り値の JSON parse + v5.5.0 schema 必須項目チェック |
| LogMasker | API キー / Bearer トークンを log 出力前に必ずマスク |
Grasshopper メニュー連携
GH メインメニュー → MakeBuildingPro → AI Setup... から API キー設定 UI を直接開けます。
関連
Comp_D10_ApiKeyManager— API キー管理Comp_I09_DiffApproval— 必須の承認ゲートComp_I04_GenerateBuildingInformation— 決定論的生成 (AI ではない、無料・高速)- AI 機能 利用規約
- MCP 連携について — Claude Desktop 等から
add_*ツールで建物編集する別経路