跳到主要内容

Memory.createThread()

.createThread() 方法在内存系统中创建新的对话线程。每个线程代表一个独立的对话或上下文,并且可以包含多条消息。

用法示例
用法示例的直接链接

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

参数
参数的直接链接

resourceId:

string
此线程所属资源的标识符(例如用户 ID、项目 ID)

threadId?:

string
线程的可选自定义 ID。如果未提供,则会自动生成。

title?:

string
线程的可选标题

metadata?:

Record<string, unknown>
与线程关联的可选元数据

返回值
返回值的直接链接

id:

string
所创建线程的唯一标识符

resourceId:

string
与线程关联的资源 ID

title:

string
线程标题(如果提供)

createdAt:

Date
线程的创建时间戳

updatedAt:

Date
线程最后更新的时间戳

metadata:

Record<string, unknown>
与线程关联的其他元数据

扩展用法示例
扩展用法示例的直接链接

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)