Memory.createThread()

.createThread() メソッドは、Memory システムに新しい会話 Thread を作成します。各 Thread は個別の会話またはコンテキストを表し、複数のメッセージを含めることができます。

使用例

await memory?.createThread({ resourceId: 'user-123' })

パラメーター

resourceId:

string

この Thread が属するリソースの識別子（例：ユーザー ID、プロジェクト ID）

threadId?:

string

Thread に使用する省略可能なカスタム ID。指定しない場合は生成されます。

title?:

string

Thread の省略可能なタイトル

metadata?:

Record<string, unknown>

Thread に関連付ける省略可能なメタデータ

戻り値

id:

string

作成された Thread の一意の識別子

resourceId:

string

Thread に関連付けられたリソース ID

title:

string

Thread のタイトル（指定した場合）

createdAt:

Date

Thread が作成された日時

updatedAt:

Date

Thread が最後に更新された日時

metadata:

Record<string, unknown>

Thread に関連付けられた追加のメタデータ

詳細な使用例

src/test-memory.ts

import { mastra } from './mastra'

const agent = mastra.getAgent('agent')
const memory = await agent.getMemory()

const thread = await memory?.createThread({
  resourceId: 'user-123',
  title: 'Memory Test Thread',
  metadata: {
    source: 'test-script',
    purpose: 'memory-testing',
  },
})

const response = await agent.generate('message for agent', {
  memory: {
    thread: thread!.id,
    resource: thread!.resourceId,
  },
})

console.log(response.text)

関連情報

• Memory クラスのリファレンス
• Memory の概要（Thread の概念について説明します）
• getThreadById
• listThreads
• recall