クイックスタート
マインドレイヤーで最初のAIエージェントを起動しましょう。
1. プロジェクトを作成
プロジェクトにアクセスして新しいプロジェクトを作成します。プロジェクトはエージェントをグループ化し、認証用のAPIキーを提供します。
2. APIキーを取得
プロジェクト設定でAPIキーを生成します。このキーはマインドレイヤーへのすべてのREST API呼び出しを認証します。
# すべてのリクエストにはBearer認証が必要
Authorization: Bearer YOUR_API_KEY3. SDK をインストール（スキップしてもOK）
スタックに合わせて経路を選んでください。どの経路も同じホスト型 API に接続するので、組み合わせて使えます（例：バックエンドは Python、運用は Claude Desktop からの MCP 接続）。
pip install sonzai- Python 3.11+。同期（
Sonzai）と非同期（AsyncSonzai）クライアントを同梱。 - TypeScript は Node.js >=18、Bun、Deno に対応。ランタイム依存ゼロ。
- Go 1.25+。標準ライブラリのみ。
- OpenClaw 経由で利用する場合は OpenClaw 本体のインストールが必要です — openclaw.ai（Getting Started）を参照。
- 詳細ガイド：MCP · OpenClaw · REST API リファレンス。
API キーの扱い
TypeScript・Python・Go の各 SDK はデフォルトで環境変数 SONZAI_API_KEY を読み込みます。自分で管理したい場合のみ明示的に渡してください（例：new Sonzai({ apiKey: "sk-..." })）。OpenClaw プラグインはキーを openclaw.json に保存します。MCP サーバーはクライアント設定経由で渡された SONZAI_API_KEY 環境変数を読み込みます。
4. エージェントを作成
エージェントを作成する方法は2つあります：ビッグファイブスコアでパーソナリティ特性を明示的に定義するか、自然言語プロンプトから生成します。
オプションA：プロンプトから生成
エージェントを平易な言葉で説明すると、プラットフォームがパーソナリティ・バイオ・シードメモリを自動生成します。
import { Sonzai } from "@sonzai-labs/agents";
const client = new Sonzai({ apiKey: "sk-..." });
const agent = await client.agents.generation.generateAndCreate({
name: "Luna",
description: "A cheerful and curious AI assistant who loves helping developers debug code. She's patient, witty, and always encouraging.",
language: "en",
});
console.log(agent.agent_id); // 自動生成されたUUID
console.log(agent.personality); // 説明から導出されたフルビッグファイブプロファイルオプションB：ビッグファイブスコアで定義
正確な制御のために、明示的なビッグファイブスコアでエージェントを作成します。プラットフォームはスコアから完全なパーソナリティプロファイル・発話パターン・感情的傾向を導出します。
import { Sonzai } from "@sonzai-labs/agents";
import { v5 as uuidv5 } from "uuid";
const client = new Sonzai({ apiKey: "sk-..." });
// 独自のエンティティIDから安定したUUIDを導出
const MY_NAMESPACE = "your-uuid-namespace-here";
const agentId = uuidv5("support-agent-001", MY_NAMESPACE);
const agent = await client.agents.create({
agentId, // 独自のUUIDを渡す——繰り返し呼び出しも安全
name: "Luna",
gender: "female",
big5: {
openness: 0.75,
conscientiousness: 0.60,
extraversion: 0.80,
agreeableness: 0.70,
neuroticism: 0.30,
},
language: "en",
});
console.log(agent.agent_id); // 毎回同じUUID設計上のべき等性
エージェント作成は常に作成または更新です。同じIDで2回呼び出すと既存のエージェントが更新されます——エラーになったり重複が作成されたりしません。つまり、スタートアップコード・CIパイプライン・プロビジョニングスクリプトから agents.create() を無条件に呼び出せます。
- agentIdあり: サーバーが直接あなたのUUIDを使用します。推奨——エージェントを独自のエンティティID（エージェント・アシスタント・従業員）に紐付けて、あなたが管理する確定的なマッピングを実現します。
- agentIdなし: サーバーがプロジェクトID＋エージェント名からUUIDを導出します。同じ名前はプロジェクト内で常に同じエージェントにマッピングされます。
5. エージェントとチャット
ストリーミングチャットを使用してリアルタイムのAI応答を取得します。プラットフォームはコンテキスト・メモリ・状態更新を自動処理します。
for await (const event of client.agents.chatStream({
agent: "agent-id",
messages: [{ role: "user", content: "I had a great day hiking!" }],
userId: "user-123",
})) {
process.stdout.write(event.choices?.[0]?.delta?.content ?? "");
}サーバーサイドのみ
SDKはサーバーサイドのみの使用を想定しています。クライアントサイドのコードにAPIキーを公開しないでください。Webアプリの場合はバックエンド経由でプロキシします。例については統合ガイドを参照してください。
6. 時間をかけて追跡
ダッシュボードにはパーソナリティシフト・メモリの成長・ムードパターン・関係性のダイナミクスが表示されます。すべてのシステムはユーザーがインタラクションするにつれて自動更新されます。