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

# WorkingMemory

`WorkingMemory` は、working memory のデータを system message として挿入する **input processor** です。ストレージから永続的な情報を取得して LLM 向けの instruction に整形し、Agent が会話をまたいでユーザーのコンテキストを維持できるようにします。

## 使用例

```typescript
import { WorkingMemory } from '@mastra/core/processors'

const processor = new WorkingMemory({
  storage: memoryStorage,
  scope: 'resource',
  template: {
    format: 'markdown',
    content: `# User Profile
- **Name**:
- **Preferences**:
- **Goals**:
`,
  },
})
```

## コンストラクターパラメーター

**options** (`Options`): working memory processor の設定オプション

**options.storage** (`MemoryStorage`): working memory のデータを取得するストレージインスタンス

**options.template** (`WorkingMemoryTemplate`): working memory の形式と構造を定義するテンプレート

**options.template.format** (`'markdown' | 'json'`): working memory コンテンツの形式

**options.template.content** (`string`): working memory データの構造を定義するテンプレートの内容

**options.scope** (`'thread' | 'resource'`): working memory のスコープ。'thread' は現在の thread に限定し、'resource' はその resource のすべての thread で共有します

**options.useVNext** (`boolean`): ガイドラインを改善した次世代の instruction 形式を使用します

**options.readOnly** (`boolean`): true の場合、working memory を読み取り専用のコンテキストとして提供します。データは会話に挿入されますが、updateWorkingMemory Tool や更新用 instruction は含まれません。working memory を変更せず参照する必要がある Agent に適しています。

**options.templateProvider** (`{ getWorkingMemoryTemplate(args: { memoryConfig?: MemoryConfig }): Promise<WorkingMemoryTemplate | null> }`): 実行時にテンプレートを解決する動的なテンプレート Provider

**options.logger** (`IMastraLogger`): 構造化ログに使用する任意の logger インスタンス

## 戻り値

**id** (`string`): 'working-memory' に設定された processor の識別子

**name** (`string`): 'WorkingMemory' に設定された processor の表示名

**defaultWorkingMemoryTemplate** (`string`): カスタムテンプレートが指定されていない場合に使用するデフォルトの Markdown テンプレート

**processInput** (`(args: { messages: MastraDBMessage[]; messageList: MessageList; abort: (reason?: string) => never; requestContext?: RequestContext }) => Promise<MessageList | MastraDBMessage[]>`): working memory を取得し、system message としてメッセージリストに追加します

## 詳細な使用例

```typescript
import { Agent } from '@mastra/core/agent'
import { WorkingMemory, MessageHistory } from '@mastra/core/processors'
import { PostgresStorage } from '@mastra/pg'

const storage = new PostgresStorage({
  connectionString: process.env.DATABASE_URL,
})

export const agent = new Agent({
  id: 'personalized-agent',
  name: 'personalized-agent',
  instructions: 'You are a helpful assistant that remembers user preferences',
  model: 'openai/gpt-5.6-sol',
  inputProcessors: [
    new WorkingMemory({
      storage,
      scope: 'resource',
      template: {
        format: 'markdown',
        content: `# User Information
- **Name**:
- **Location**:
- **Preferences**:
- **Communication Style**:
- **Current Projects**:
`,
      },
    }),
    new MessageHistory({ storage, lastMessages: 50 }),
  ],
  outputProcessors: [new MessageHistory({ storage })],
})
```

## JSON 形式の例

```typescript
import { WorkingMemory } from '@mastra/core/processors'

const processor = new WorkingMemory({
  storage: memoryStorage,
  scope: 'resource',
  template: {
    format: 'json',
    content: JSON.stringify({
      user: {
        name: { type: 'string' },
        preferences: { type: 'object' },
        goals: { type: 'array' },
      },
    }),
  },
})
```

## 動作

### 入力処理

1. request context から `threadId` と `resourceId` を取得する

2. scope に基づき、次のいずれかから working memory を取得する

   - thread のメタデータ（`scope: 'thread'`）
   - resource レコード（`scope: 'resource'`）

3. Provider、オプション、またはデフォルトからテンプレートを解決する

4. モードに基づいて system instruction を生成する

   - **通常モード**: 情報の保存／更新に関するガイドライン、テンプレート構造、現在のデータを含める
   - **読み取り専用モード**（`readOnly: true`）: 更新用 instruction を含めず、現在のデータだけをコンテキストとして含める

5. `source: 'memory'` タグを付けた system message として instruction を追加する

### Working memory の更新

working memory の更新は、この processor ではなく Memory class が提供する `updateWorkingMemory` Tool を通じて行われます。この processor は、現在の working memory の状態を会話へ挿入する処理だけを担います。

### デフォルトテンプレート

テンプレートを指定しない場合、processor は次のフィールドを持つデフォルトの Markdown テンプレートを使用します。

- 名、姓
- 所在地、職業
- 興味、目標
- イベント、事実、プロジェクト

## 関連情報

- [Guardrails](https://mastra.zisheng.pro/ja/docs/agents/guardrails)