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

# Agent.getMetadata()

그만큼`.getMetadata()`메서드는 Agent에 대해 구성된 메타데이터를 검색하여 함수인 경우 이를 확인합니다. Agent ID 또는 이름에 해당 데이터를 인코딩하지 않고 메타데이터를 사용하여 클라이언트의 Agent를 분류합니다.

## 사용예

```typescript
await agent.getMetadata()
```

## 매개변수

**options** (`{ requestContext?: RequestContext }`): 요청 컨텍스트가 포함된 선택적 구성 객체입니다. (Default: `{}`)

**options.requestContext** (`RequestContext`): 동적 메타데이터 함수에 전달되는 Request Context입니다. 메타데이터가 정적이면 무시됩니다.

## 보고

**metadata** (`Record<string, unknown> | Promise<Record<string, unknown>>`): Agent에 구성된 메타데이터입니다. 메타데이터가 구성되지 않은 경우 undefined입니다. 직접 반환되거나 함수로 정의된 경우 메타데이터로 해석되는 프로미스로 반환됩니다.

## 확장된 사용 예

정적 메타데이터:

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

export const supportAgent = new Agent({
  id: 'support-agent',
  name: 'Support Agent',
  instructions: 'You help customers with support requests.',
  model: 'openai/gpt-5.6-sol',
  metadata: { type: 'support' },
})

const metadata = supportAgent.getMetadata()
```

요청 컨텍스트에서 확인된 동적 메타데이터:

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

export const supportAgent = new Agent({
  id: 'support-agent',
  name: 'Support Agent',
  instructions: 'You help customers with support requests.',
  model: 'openai/gpt-5.6-sol',
  metadata: ({ requestContext }) => ({
    type: 'support',
    tenant: requestContext.get('tenant'),
  }),
})

const metadata = await supportAgent.getMetadata({ requestContext })
```

## 관련된

- [Agent 개요](https://mastra.zisheng.pro/ko/docs/agents/overview)
- [요청 컨텍스트](https://mastra.zisheng.pro/ko/docs/server/request-context)