마스트라.getAgentById()

그만큼.getAgentById()메소드는 등록된 Agent를 검색합니다.id. 먼저 등록된 Agent를 검색합니다.agent.id. 일치하는 Agent가 없으면 다음으로 대체됩니다.Mastra.getAgent()제공된 값을 Agent 레지스트리 키로 처리합니다.

코드에 정의된 Agent를 가져오려면 mastra.getAgentById(id)를 사용합니다. 버전이 지정된 Agent를 가져오려면 await mastra.getAgentById(id, version)을 사용합니다.

사용예

다음 예에서는 Agent를 등록하고 ID로 검색한 후 반환된 Agent를 사용합니다.

src/mastra/index.ts

import { Agent } from '@mastra/core/agent'
import { Mastra } from '@mastra/core/mastra'

const supportAgent = new Agent({
  id: 'support-agent-id',
  name: 'Support Agent',
  instructions: 'Answer support questions clearly and concisely.',
  model: 'openai/gpt-5.6-sol',
})

export const mastra = new Mastra({
  agents: {
    supportAgent,
  },
})

const agent = mastra.getAgentById('support-agent-id')

const response = await agent.generate('How can I reset my password?')

매개변수

id:

string

가져올 Agent의 ID입니다. Mastra는 먼저 등록된 Agent에서 agent.id를 검색합니다. 일치하는 항목이 없으면 이 값을 Agent 레지스트리 키로 사용하여 getAgent()를 호출합니다.

version?:

{ versionId: string } | { status?: 'draft' | 'published' }

버전이 지정된 Agent를 가져오기 위한 선택적 버전 선택기입니다. 제공하면 메서드가 프로미스를 반환합니다.

VersionSelector

versionId:

string

가져올 특정 Agent 버전의 ID입니다.

status?:

'draft' | 'published'

이 게시 상태에 해당하는 최신 Agent 버전을 선택합니다.

보고

agent:

TAgents[TAgentName]

version을 생략했을 때 지정된 ID에 해당하는 Agent 인스턴스입니다.

agent:

Promise<TAgents[TAgentName]>

version을 제공했을 때 버전이 지정된 Agent 인스턴스로 해석되는 프로미스입니다.

ID나 레지스트리 키로 Agent를 찾지 못하면 MastraError가 발생합니다.

관련된

• 마스트라.getAgent()
• Agent 개요