自然言語の説明からエージェントを作成します。プラットフォームがパーソナリティプロフィール、経歴、シード記憶を自動的に生成します。

エージェントの生成と作成

ワンショット：自然言語でエージェントを説明すると、パーソナリティ・バイオ・シードメモリを持つ完全にプロビジョニングされたエージェントが返ってきます。

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.",
language: "en",
});

べき等な更新

agentId が指定されてエージェントが既に存在する場合、generateAndCreate は重複を作成する代わりに既存のエージェントを更新します。

キャラクタープロファイルの生成

エージェントを作成せずに完全なパーソナリティプロファイルを生成します。コミットする前にプレビューするのに便利です。

const profile = await client.agents.generation.generateCharacter({
name: "Atlas",
description: "A stoic, wise mentor who speaks in metaphors and values patience above all.",
fields: ["big5", "dimensions", "preferences", "behaviors"],
});

バイオの生成

既存エージェントの経歴を生成または再生成します。

const bio = await client.agents.generation.generateBio("agent-id", {
description: "A friendly barista who remembers every customer's order",
style: "warm and conversational",
});
console.log(bio.bio);

シードメモリの生成

パーソナリティに基づいてバックストーリーメモリを生成し、オプションで保存します。

const memories = await client.agents.generation.generateSeedMemories("agent-id", {
agentName: "Luna",
trueInterests: ["astronomy", "poetry", "hiking"],
trueDislikes: ["loud noises", "dishonesty"],
generateOriginStory: true,
generatePersonalizedMemories: true,
storeMemories: true,
});
console.log(memories.memories.length);

画像の生成

テキストプロンプトからAIを使用して画像を生成します。

const image = await client.agents.generation.generateImage("agent-id", {
prompt: "A serene mountain landscape at sunset",
});
console.log(image.url);

実践ガイド

生成はコンパニオン（スケールでのキャラクター作成）とAIエンプロイー（役割ベースのエージェントテンプレート）に最も価値があります。エンタープライズでは生成は通常一回限りのセットアップ手順です。

generateAndCreate をオンボーディングフローとして使用。 テキストボックスでユーザーにコンパニオンを説明させます。APIを呼び出します。生成されたキャラクターを表示します。気に入らなければ再生成します。これが圧倒的に優れた初回UXです。

const agent = await client.agents.generation.generateAndCreate({
  name: userInput.name,
  description: userInput.description,
  language: "en",
});

コミット前に generateCharacter でプレビュー。 ユーザーが保存前にパーソナリティプロファイルを承認できるようにしたい場合は、generateCharacter でプレビューし、確認時のみ create します。

信じられるバックストーリーのためにシードメモリを生成。 ユーザーが到着する前から何かを「記憶している」コンパニオンはより現実感があります。

エージェント生成