Sonzai Docs

アーキテクチャ

マインドレイヤープラットフォームがアプリケーションアーキテクチャにどのように組み込まれるか。

システム概要

マインドレイヤーは、エージェントのインテリジェンス（パーソナリティ、記憶、ムード）を アプリケーションロジックから分離するスタンドアロンプラットフォームです。 どのバックエンドもREST APIまたは公式SDKを通じて統合できます。

Your Backend                  Mind Layer Platform
     |                                  |
     |--- Create Agent ---------------->|
     |<-- Agent ID + Profile -----------|
     |                                  |
     |--- Chat (SSE streaming) -------->|
     |    (messages + app context)      |-- Build context
     |<-- Streaming AI response --------|-- Stream AI response
     |                                  |-- Update memory, mood, personality
     |<-- Proactive notifications -------|   (automatic, no extra calls)

3サービスアーキテクチャ

一般的なデプロイメントには、連携する3つのレイヤーがあります：

あなたのバックエンド

認証、アプリケーション状態、ユーザーセッション、ビジネスロジックを処理します。すべてのアプリケーションデータを管理します。AIインタラクションにはSDKまたはREST APIを介してマインドレイヤーを呼び出します。

Express、Django、カスタムバックエンド

マインドレイヤープラットフォーム

エージェントのインテリジェンスを管理：パーソナリティ、記憶、ムード、習慣、目標、関係性。1回のチャット呼び出しでコンテキストの組み立て、AIストリーミング、チャット後の学習を処理します。

Sonzai マインドレイヤープラットフォーム

AIサービス

ステートレスなLLMレイヤー。エンリッチされたコンテキストを受け取り、AI応答、画像、動画、音声を生成します。

Sonzai AIサービス

プラットフォームが管理するもの

各チャット呼び出しにおいて、プラットフォームはAI応答を生成する前に、 パーソナリティ、記憶、ムード、関係性データから関連するコンテキストを 自動的に組み立てます。チャット後の状態更新は自動的に行われ、 追加のAPI呼び出しは不要です。

コンテキスト組み立てパーソナリティ、ムード、記憶、関係性ナラティブ、アプリケーション状態 — すべてリクエストごとに組み立てられます。
記憶抽出事実、イベント、コミットメントが各会話から抽出され、自動的に保存されます。
ムード＆パーソナリティ進化ムードとビッグファイブパーソナリティがインタラクションパターンに基づいて自然に変化します。
プロアクティブ通知エージェントはセッション間でプロアクティブなアウトリーチをスケジュールできます。ポーリングまたはWebhookで配信します。

データ所有権

マインドレイヤーとあなたのバックエンドはそれぞれ異なるデータを管理します：

マインドレイヤーが管理

  • • エージェントのパーソナリティプロファイル
  • • 記憶の事実とサマリー
  • • ムード状態（幸福度、エネルギー、穏やかさ、愛情）
  • • パーソナリティ進化履歴
  • • 習慣と目標
  • • 関係性ナラティブ
  • • ナレッジベースのエンティティとグラフ
  • • カスタムエージェント状態

あなたのバックエンドが管理

  • • ユーザー認証
  • • ビジネスロジックとワークフロー
  • • ユーザープロファイルと設定
  • • アプリケーションデータと状態
  • • 課金とサブスクリプション
  • • 権限とアクセス制御
  • • セッション管理

セッションライフサイクル

1. User opens chat
   Your Backend prepares application context (user data, preferences...)

2. Chat happens
   Your Backend ---> Chat SDK call (context + messages)
   User <--- Streaming AI response tokens

3. Chat ends
   Platform updates: memory, mood, personality, habits, relationships

4. Between sessions
   Platform runs: background consolidation, mood decay, proactive wakeups

SDK統合ポイント

公式SDKを使用して、プラットフォームのすべての部分とやり取りします：

Agentscreate, get, list, update
Chatchat, chatStream (SSE)
Memoryseed, search, list, browse, timeline, listFacts, reset
Personalityget, update, history
Moodget, history, aggregate
Knowledge BasecreateSchema, insertFacts, bulkUpdate, search, recommendations, trends
Custom Statescreate, get, upsert, list, delete
Custom Toolscreate, list, delete (agent-level and session-level)
Notificationslist, consume, history
User PrimingprimeUser, batchImport, getMetadata, updateMetadata
← クイックスタート統合ガイド→