Skip to main content
Sonzai Docs

エージェント生成

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

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

ワンショット:エージェントを自然言語で説明すると、パーソナリティ、経歴、シード記憶を備えた完全にプロビジョニングされたエージェントが得られます。

import { Sonzai } from "@sonzai-labs/agents";

const client = new Sonzai({ apiKey: "sk-..." });

const agent = await client.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.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.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.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.generation.generateImage("agent-id", {
  prompt: "A serene mountain landscape at sunset",
});
console.log(image.url);