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

# TaskSignalProvider

내장된 작업 Tool을 번들로 제공합니다(`task_write`, `task_update`, `task_complete`, `task_check`) 그리고`TaskStateProcessor`단일 Agent 등록 뒤에. Tool와 프로세서를 별도로 연결하지 않고도 구조화되고 내구성 있는 작업 목록을 Agent에 추가하는 데 사용됩니다.

[`SignalProvider`](https://mastra.zisheng.pro/ko/reference/signals/signal-provider)를 확장합니다. 작업 목록은 스레드 범위의 `tasks` 저장소 도메인(신뢰할 수 있는 원본)에 저장되고 프로세서에 의해 Agent 상태 신호 레인에 투영되므로, Prompt 캐시를 무효화하지 않으면서 관찰 Memory가 잘린 후에도 유지됩니다.

## 사용예

`Memory`와 Mastra `storage`가 있는 Agent에 Provider를 등록하세요.

```typescript
import { Agent } from '@mastra/core/agent'
import { TaskSignalProvider } from '@mastra/core/signals'

const agent = new Agent({
  id: 'coder',
  name: 'coder',
  instructions: '...',
  model,
  memory,
  signals: [new TaskSignalProvider()],
})
```

Agent는 자동으로 네 가지 작업 Tool을 Tool 세트에 병합하고 입력 프로세서 체인에 프로세서를 등록합니다. 다른 배선은 필요하지 않습니다.

작업 추적에는 Memory가 지원하는 스레드(`threadId` + `resourceId`)가 필요합니다. Memory가 없으면 작업 Tool은 아무 작업도 하지 않고, 작업 추적에 Agent Memory가 필요하다는 설명이 담긴 결과를 반환합니다. `tasks` 저장소 도메인은 기본적으로 메모리 내 저장소에 연결되므로 저장소 백엔드를 구성하지 않아도 작업 추적이 작동합니다.

## 생성자 매개변수

`TaskSignalProvider`생성자 인수를 사용하지 않습니다.

## 속성

**id** (`'task-signals'`): Provider 인스턴스의 안정적인 식별자입니다.

## 행동 양식

### Agent 통합

이 메서드들은 Provider가 `signals`에 전달될 때 Agent에 의해 자동으로 호출됩니다. 일반적으로 직접 호출하지 않습니다.

#### `getTools()`

Tool ID가 지정된 네 개의 작업 Tool(`task_write`, `task_update`, `task_complete`, `task_check`)을 반환합니다. Agent는 이를 자체 Tool 집합에 병합합니다.

```typescript
const tools = new TaskSignalProvider().getTools()
// { task_write, task_update, task_complete, task_check }
```

보고:`Record<string, Tool>`

#### `getInputProcessors()`

Provider의 `TaskStateProcessor` 인스턴스를 반환합니다. Agent는 이를 입력 프로세서 체인에 등록합니다. 이 체인은 Mastra 인스턴스를 전파하여 프로세서가 `tasks` 저장소를 확인할 수 있게 합니다.

```typescript
const [processor] = new TaskSignalProvider().getInputProcessors()
// processor instanceof TaskStateProcessor
```

보고:`InputProcessorOrWorkflow[]`