> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-TW/llms.txt

# Memory.createThread()

`.createThread()` 方法會在記憶體系統中建立新的對話執行緒。每個執行緒代表不同的對話或情境，並可包含多則訊息。

## 使用範例

```typescript
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>`): 與執行緒相關聯的其他中繼資料

## 延伸使用範例

```typescript
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 類別參考](https://mastra.zisheng.pro/zh-TW/reference/memory/memory-class)
- [Memory 入門](https://mastra.zisheng.pro/zh-TW/docs/memory/overview)（涵蓋執行緒概念）
- [getThreadById](https://mastra.zisheng.pro/zh-TW/reference/memory/getThreadById)
- [listThreads](https://mastra.zisheng.pro/zh-TW/reference/memory/listThreads)
- [recall](https://mastra.zisheng.pro/zh-TW/reference/memory/recall)