마스트라 수업

최상위 수준 가져오기를 제한하고 직접 속성 액세스를 getter 메서드로 대체하도록 Mastra 클래스가 재구성되었습니다.

변경됨

하위 경로 가져오기로의 최상위 가져오기

이제 기본 @mastra/core 인덱스 파일은 Mastra와 Config만 내보냅니다. 다른 모든 내보내기는 하위 경로 가져오기로 이동되었습니다. 이 변경으로 번들러가 사용되지 않는 코드를 제거할 수 있어 트리 셰이킹이 개선되고 번들 크기가 줄어듭니다. 마이그레이션하려면 @mastra/core의 모든 가져오기를 적절한 하위 경로를 사용하도록 업데이트하세요.

- import { Mastra, Agent, Workflow, createTool } from '@mastra/core';
+ import { Mastra, type Config } from '@mastra/core';
+ import { Agent } from '@mastra/core/agent';
+ import { Workflow } from '@mastra/core/workflows';
+ import { createTool } from '@mastra/core/tools';

:::tip[코드모드]

Mastra의 codemod CLI를 사용하여 코드를 자동으로 업데이트할 수 있습니다.

npx @mastra/codemod@latest v1/mastra-core-imports .

:::

experimental_auth에게auth

실험적 인증 구성이 안정 구성으로 승격되었습니다. 이 변경 사항은 인증 API가 이제 안정적이고 프로덕션 준비가 되었음을 반영합니다.

마이그레이션하려면 Mastra 구성에서 experimental_auth 키의 이름을 auth로 변경하세요.

  const mastra = new Mastra({
-   experimental_auth: {
+   auth: {
      provider: workos,
    },
  });

:::tip[코드모드]

Mastra의 codemod CLI를 사용하여 코드를 자동으로 업데이트할 수 있습니다.

npx @mastra/codemod@latest v1/experimental-auth .

:::

모든 Mastra 기본 요소에 필수인 id 매개변수

이제 모든 스토리지, 벡터 저장소, Agent, Workflow, mcpServer, 프로세서, 채점기 및 Tool은 초기화할 때 id 매개변수가 필요합니다. 이를 통해 표준화된 Mastra API를 지원하고 ID 충돌을 방지합니다. 이제 이러한 모든 기본 요소에는 get, list, add 함수도 있습니다. 마이그레이션하려면 모든 스토리지 및 벡터 저장소 인스턴스화에 id 매개변수를 추가하세요. 동일한 스토리지/벡터 클래스를 여러 번 사용할 때는 각 인스턴스에 고유한 ID가 있는지 확인하세요.

- const storage = new LibSQLStore({
-   url: ':memory:',
- });
+ const storage = new LibSQLStore({
+   id: 'my-app-storage',
+   url: ':memory:',
+ });

- const vector = new PgVector({
-   connectionString: process.env.DATABASE_URL,
- });
+ const vector = new PgVector({
+   id: 'my-app-vector',
+   connectionString: process.env.DATABASE_URL,
+ });

다양한 목적으로 별도의 인스턴스를 사용하는 경우 설명이 포함된 고유 ID를 사용하세요.

  const agentMemory = new Memory({
    storage: new LibSQLStore({
-     url: 'file:./agent.db',
+     id: 'weather-agent-memory-storage',
+     url: 'file:./agent.db',
    }),
  });

  const mastra = new Mastra({
    storage: new LibSQLStore({
+     id: 'mastra-storage',
      url: ':memory:',
    }),
  });

기본 요소 복수형 API를 get<primitives>에서 list<primitive>로 변경

기본 요소의 모든 인스턴스를 반환하는 get* 함수는 목적을 더 잘 나타내도록 list*로 이름이 변경되었습니다.

- const agents = mastra.getAgents();
+ const agents = mastra.listAgents();
- const vectors = mastra.getVectors();
+ const vectors = mastra.listVectors();
- const workflows = mastra.getWorkflows();
+ const workflows = mastra.listWorkflows();
- const scorers = mastra.getScorers();
+ const scorers = mastra.listScorers();
- const mcpServers = mastra.getMCPServers();
+ const mcpServers = mastra.listMCPServers();
- const logsByRunId = await mastra.getLogsByRunId({ runId: 'id', transportId: 'id' });
+ const logsByRunId = await mastra.listLogsByRunId({ runId: 'id', transportId: 'id' });
- const logs = await mastra.getLogs('transportId');
+ const logs = await mastra.listLogs('transportId');

:::tip[코드모드]

Mastra의 codemod CLI를 사용하여 코드를 자동으로 업데이트할 수 있습니다.

npx @mastra/codemod@latest v1/mastra-plural-apis .

:::

각 기본 요소에 getById 및 get 함수 제공

mastra.getMCPServer('myServer') // Works (registry key)
mastra.getMCPServerById('my-mcp-server') // Works (intrinsic ID)

Tool 등록은 이제 고유 ID를 사용합니다.

Tool이 Agent 또는 MCP 서버에서 Mastra 인스턴스로 자동 등록되면 이제 구성 객체 키 대신 Tool 고유의 id를 사용합니다. 이를 통해 여러 Agent/MCP 서버에 구성 키가 같은 Tool이 있을 때 발생하는 충돌을 방지합니다. 마이그레이션하려면 구성 키로 Tool을 참조하는 코드를 업데이트하여 대신 Tool의 고유 ID를 사용하세요.

  const agent = new Agent({
    id: 'agent1',
    tools: {
      searchTool: weatherSearchTool,
    },
  });

- mastra.getTool('searchTool');
+ mastra.getTool(weatherSearchTool.id);