Agent.getMetadata()

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

사용예

await agent.getMetadata()

매개변수

options?:

{ requestContext?: RequestContext }

= {}

요청 컨텍스트가 포함된 선택적 구성 객체입니다.

{ requestContext?: RequestContext }

requestContext?:

RequestContext

동적 메타데이터 함수에 전달되는 Request Context입니다. 메타데이터가 정적이면 무시됩니다.

보고

metadata:

Record<string, unknown> | Promise<Record<string, unknown>>

Agent에 구성된 메타데이터입니다. 메타데이터가 구성되지 않은 경우 undefined입니다. 직접 반환되거나 함수로 정의된 경우 메타데이터로 해석되는 프로미스로 반환됩니다.

확장된 사용 예

정적 메타데이터:

src/mastra/agents/support-agent.ts

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()

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

src/mastra/agents/support-agent.ts

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 개요
• 요청 컨텍스트