Cheez API
Cheez APIは、DNM（Dynamic Narrative Map）エンジンを基盤に動作するマルチテナントAI対話プラットフォームです。 Express + TypeScript + Firebase Firestoreで構成された安定的なインフラの上に、 B2Bクライアントが実際に導入するAI Feature Layerが実装されています。
Express + TypeScript
型安全なREST API。マルチテナント構造により、顧客企業ごとに独立した環境を保証
Firebase Firestore
テナント・キャラクター・セッション・メッセージを階層別に分離して保存。Admin Dashboardと連携
Gemini / Claude
Narrative OS方式により、必要なコンテキストのみを正確に伝達
18 Plugins
優先度ベースの実行パイプライン。各プラグインが独立してコンテキストを拡張
DNMエンジンの動作原理
DNMエンジンは、ユーザーの現在地・時間・感情など本当に必要な情報だけを選び抜いてAIに伝達します。
これにより、AIが辻褄の合わない発言をすることなく、世界観に沿った正確な応答を返します。
AIの記憶力に依存せず、データに基づいて世界を維持します
設計原則
Cheez APIを支える3つの核心的な設計思想です。
Composable
すべての機能は独立したモジュールとして設計されています。クライアントは必要な機能だけを選んで組み合わせることができます。
Persona(full) + Style(live) + Sensor(live-6)
Progressive
systemPromptひとつから始めて、段階的に機能を追加できます。Tier 1からTier 3まで。
Tier 1 → 2 → 3 段階的導入
Backward Compatible
既存のパラメータのみを送信すれば、従来どおりに動作します。新規パラメータはすべてoptionalとして設計されています。
新規フィールドは常にoptional
ティア比較表
Cheez APIは3つのティアで機能を提供します。導入目的と複雑度に応じたティアをお選びください。
Basic
flatプロンプトまたは構造化ペルソナ。シンプルなチャットボットから個性豊かなAIキャラクターまで
Pro
Sensor/Tags + Stats + Lorebook。感情トラッキングと動的な世界観が求められるサービス向け
Enterprise
長期記憶 + Realtime Hooks + Full DNM。没入型インタラクティブストーリープラットフォーム向け
| 機能モジュール | Tier 1 Basic |
Tier 2 Pro |
Tier 3 Enterprise |
|---|---|---|---|
| Persona Engine | flat / 構造化ペルソナ 13フィールド |
Full Fields | OptimizedPersona 長期チューニング |
| Style System | normal / romance | 7種類全体 live含む |
7種類 + カスタム |
| Sensor / Tags | — | スタイル別タグ Live-6センサー |
全タグ サーバーサイドパース |
| Stats Engine | — | 基本ステータス 好感度、信頼度 |
動的ステータス カスタム指標 |
| Lorebook / World | — | キーワードトリガー Lorebook基本 |
Living World DNM全体 |
| Memory / Context | セッション内 + L1 短期記憶 |
L1 + L2 中期要約 |
L3長期記憶 GraphContext |
| Realtime Hooks | — | — | ✓ beforeAI afterAI hooks |
| Ability System | ✓ 単一 | ✓ 複数 | ✓ 全機能 |
| Admin Dashboard | キャラクターCRUD | キャラクター + モニタリング | エンタープライズ リアルタイム管理 |
| 18 Plugin System | 基本〜拡張 5〜10種 |
Full（18種） | Full + カスタム |
| サービス例 | OZO タロット・占い・キャラクター |
Fanup AIアバターチャット |
Cheez インタラクティブストーリー |
Persona Engine
Cheez内部の構造化キャラクターシステムをAPIとして公開するレイヤーです。 プレーンテキストのsystemPromptの代わりに、構造化ペルソナフィールドを組み合わせて一貫性のあるAIキャラクターを定義できます。
| ティア | 方式 | 対応フィールド | 活用例 |
|---|---|---|---|
| Tier 1 | flatまたは構造化 |
systemPrompt（flat）または
corePersona, personality, personalityKeywords,
speechPattern, speechExamples, background,
secret, motivation, dialogueStyle,
forbiddenBehaviors, age, gender, appearance
|
占いボット〜個性豊かなAIキャラクター |
| Tier 2 | Full Fields | Tier 1全体 + 関係設定、配信スタイル、ファンとのインタラクションルール | AIアバターチャット（Fanup） |
| Tier 3 | OptimizedPersona |
optimizedPersona.coreTraits,
speechPatterns,
emotionalShifts,
reactionSets,
relationshipMilestones
|
長期チューニングキャラクター（Cheez） |
Style System
Cheez内部の7つのストーリースタイルをAPIパラメータとして選択できるレイヤーです。 各スタイルは専用のプロンプトレイヤーとタグセットを同時に有効化します。
| Style ID | スタイル名 | コアタグ／特性 | ティア |
|---|---|---|---|
normal |
基本 | 好感度タグのみ有効化。タグのないシンプルな会話 | Tier 1+ |
romance |
ロマンス | ときめき度、関係温度、心拍数、距離感、感情爆発、決定的瞬間、ケミストリー反応 | Tier 1+ |
bl |
BL | 執着度、嫉妬心、駆け引き指数、独占宣言、危険信号、関係温度 | Tier 2+ |
system |
システムウィンドウ | 能力発動、スキャン、ステータスウィンドウ、経験値、スキル習得、クエスト、好感度 | Tier 2+ |
guideverse |
ガイドバース | 暴走指数、同調率、刻印状態、ゾーンドロップリスク、共鳴、ガイディング効果 | Tier 2+ |
omegaverse |
オメガバース | フェロモン濃度、発情期、刻印、抑制剤、マーキング衝動、縄張り本能 | Tier 2+ |
live |
ライブ配信 | 好感度、本音、駆け引き指数、疲労度、体力、放送事故、PM_DM | Tier 2+ |
B2Bテナント制御
TenantConfigのallowedStyles, allowedGenres,
defaultStyle, defaultGenreにより、テナントごとに利用可能なスタイルとジャンルを制限します。
FanupはallowedStyles: ["live"]、OZOはallowedStyles: ["normal"]に設定されています。
Sensor / Tag System
各スタイル固有のタグセットをAI応答に含め、クライアント側でパースしてUIとしてレンダリングできるレイヤーです。 Tier 2から有効化されます。
タグフォーマット
【カテゴリ : 内容】 または
【カテゴリ : 内容 | 追加情報 | 追加情報2】 の形式でAI応答に含まれます。
例: 【好感度 : +3 | ベルベットキス | 温かい挨拶への反応】
| スタイル | コアタグ（Core） | サブタグ（Sub） |
|---|---|---|
normal |
好感度 | — |
romance |
好感度、ときめき度、心拍数、関係温度 | 距離感、内面独白、フラグ、感情爆発、決定的瞬間、ケミストリー反応 |
bl |
執着度、嫉妬心、駆け引き指数、心拍数 | 関係温度、距離感、内面独白、感情爆発、独占宣言、危険信号 |
system |
能力発動、スキャン、ステータスウィンドウ、経験値、スキル習得、クエスト、好感度 | — |
guideverse |
暴走指数、同調率、刻印状態 | 感覚過負荷、ゾーンドロップリスク、精神体反応、ガイディング効果、感覚拡張、共鳴 |
omegaverse |
フェロモン濃度、発情期、刻印 | 本能衝動、フェロモン感知、抑制剤、番反応、発熱前兆、マーキング衝動、うなじ反応、縄張り本能 |
live |
好感度、本音、駆け引き指数 | 距離感、嫉妬隠蔽、放送事故、PM_DM、疲労度、体力、空腹度、配信アイデア |
API応答のparsedTagsおよびparsedSegmentsフィールドを通じて、サーバーサイドでのパース結果を任意で受信できます。
Stats Engine
AI対話の流れに応じてリアルタイムに変化する数値指標を追跡・管理するモジュールです。 Tier 2から有効化され、タグシステムと連携して動作します。
好感度、信頼度
会話内容に応じて±値で自動変化。Sensorタグと連携
カスタム指標
疲労度、体力、駆け引き指数など、サービスごとにカスタムステータスを定義可能
StateChangeProcessor
AI応答後、StateChangeProcessorがステータスを更新しセッションに永続化
AIの口調を自動調整
好感度の閾値に応じて、AIの口調や反応の仕方が自動的に変化
Lorebook / World
キーワードトリガーに基づく世界観データをAIコンテキストへ動的に注入するモジュールです。 Tier 2ではLorebook基本機能、Tier 3ではDNM Living World全体が有効化されます。
Lorebook (Tier 2)
キーワードが会話に登場すると、関連する世界観項目が自動的にAIコンテキストへ挿入されます。世界観の一貫性をAIが独自に判断する必要がなくなります。
Living World (Tier 3)
DNMの全機能が有効化されます。場所ごとの世界観、天候・時間シミュレーション、リアルタイムマップ拡張、NPCの行動パターンまでAIに伝達されます。
Narrative OS
会話履歴全体を読み込む代わりに、現在の状況に必要な世界観データのみを正確にAIへ伝達します。応答速度と一貫性の両方が向上します。
Memory / Context
AIが過去の会話を記憶し、一貫したキャラクター性を維持するための多層メモリシステムです。
| レベル | 名称 | ティア | 説明 |
|---|---|---|---|
| Session | セッション内記憶 | Tier 1+ | 現在の対話セッション内のコンテキストを維持。セッション終了時に初期化 |
| L1 | 短期記憶 | Tier 1+ | 直近N件のセッションの主要イベントを保存。キャラクターとの関係継続性を維持 |
| L2 | 中期要約 | Tier 2+ | 長期間の対話を要約圧縮して保存。ステータス変化の記録を含む |
| L3 | GraphContext | Tier 3 | 関係グラフに基づく長期記憶。キャラクター間の関係性や世界観イベント履歴を永続的に保存 |
Realtime Hooks
AI応答の前後処理パイプラインにカスタムロジックを挿入できる、Tier 3専用の機能です。 プラグインオーケストレーターと連携して動作します。
プロンプト注入
AIリクエスト前にコンテキストへデータを追加、またはプロンプトを動的に修正
応答後処理
AI応答のパース、タグ抽出、状態更新をカスタムロジックで処理
優先度キュー
Travel(100)、Time(110)、Affinity(120)、Location(130)の順で実行を制御
リアルタイムイベント
外部API連携、通知送信、マップ拡張トリガーなど、サービスごとのカスタムイベント
Ability System
AIキャラクターに特殊能力を付与するモジュールです。タロット、四柱推命など、ドメイン特化型の能力を独立モジュールとして分離し組み合わせます。
tarot Ability
78枚のタロットカードに基づく占いロジック。ability: "tarot"で有効化。OZOのタロットキャラクターに使用
saju Ability
四柱推命に基づく占いロジック。生年月日を入力すると、今日の運勢や注意点をキャラクターの口調で伝達
カスタムAbility
Tier 2+では複数のAbilityを組み合わせ可能。サービスごとのドメインロジックを独立した能力モジュールとして定義・適用
| Ability | ティア | 実装方式 | サービス例 |
|---|---|---|---|
ability: "tarot" |
Tier 1+ | タロット専用AIロジック + 応答体系 | OZOタロットキャラクター |
ability: "saju" |
Tier 1+ | 四柱推命専用データパイプライン | OZO四柱推命キャラクター |
| カスタム（複数） | Tier 2+ | 独立能力モジュールの組み合わせ | サービスごとに定義 |
Engine Architecture
Cheez APIはDDD（Domain-Driven Design）の4層アーキテクチャで設計されています。 各レイヤーが明確に分離されており、テナントの独立性と拡張性を保証します。
Presentation Layer
アイソメトリックビューとユーザーインターフェースを通じて、没入感のある視覚表現を提供します。
Application Layer
ユーザーの対話とイベントをオーケストレーションし、物語の流れを制御します。
Infrastructure Layer
データの永続化、外部AIサービスとの連携、および気象シミュレーションを処理します。
Domain Layer
エンティティとドメインサービスを通じて、世界観の中核ルールと因果律を保証します。
実行フロー
ユーザーメッセージが処理される全体の流れ — 入力から応答まで6ステップ。
ユーザー入力
メッセージの入力・送信。B2BクライアントアプリがREST APIを呼び出し
コンテキスト収集
Repositoryを通じてキャラクター・セッション・対話履歴・世界観データをロード
プラグイン実行
優先度に従い18個のプラグインを実行。Persona・Style・Sensor・Lorebookを適用
AI応答生成
Narrative OS方式で構成されたプロンプトをAIモデル（Gemini/Claude）に伝達
状態変更処理
StateChangeProcessorが好感度・ステータス・世界観状態を更新し永続化
応答返却
更新された世界の状態 + parsedTags + parsedSegmentsとともにクライアントへ返却
プロンプトセクション優先順位
| セクション | Priority | 内容 |
|---|---|---|
| CORE_IDENTITY | 100 | キャラクターの中核的アイデンティティ（Persona Engineの出力） |
| CHARACTER_INFO | 90 | 外見、背景、口調などの構造化フィールド |
| CONTEXT | 80 | 現在のセッション状態、ステータス、感情状態 |
| LOCATION | 70 | 現在地、Lorebookトリガーの結果 |
| RELATIONSHIPS | 60 | キャラクター関係図、メモリ要約 |
| RULES | 50 | 禁止行動、スタイルガイド、安全フィルター |
導入のお問い合わせ
Cheez APIの導入に関するお問い合わせ、PoC、お見積りのご依頼は、下記のメールアドレスまでご連絡ください。
ティア別の機能相談、カスタムAbility開発、エンタープライズ契約まで幅広く対応いたします。