마스트라

이 게이트웨이는 Observational Memory가 내장된 OpenAI 호환 API 프록시입니다. HTTP 클라이언트, SDK 또는 프레임워크가 게이트웨이를 가리키도록 설정하면 Memory 관리 코드를 작성하지 않아도 모든 대화를 자동으로 기억합니다. 자세한 내용은 다음에서 확인하세요.Gateway documentation.

API 키 받기

gateway.mastra.ai로 이동하여 Mastra 계정에 가입하세요. 온보딩 과정에서 요청 인증에 사용할 개인 API 키를 받게 됩니다.

용법

API 키를 환경 변수로 정의합니다.

.env

MASTRA_GATEWAY_API_KEY=your-gateway-key

게이트웨이 Model ID를 설정합니다.

src/mastra/agents/my-agent.ts

import { Agent } from "@mastra/core/agent";

const agent = new Agent({
  id: "my-agent",
  name: "My Agent",
  instructions: "You are a helpful assistant",
  model: "mastra/openai/gpt-5-mini"
});

게이트웨이를 통해 실행되어야 하는 내장 Model에 동일한 접두사를 사용합니다.

src/mastra/rag/embed.ts

import { ModelRouterEmbeddingModel } from "@mastra/core/llm";

const embedder = new ModelRouterEmbeddingModel("mastra/openai/text-embedding-3-small");

응답을 생성하거나 스트리밍할 때 memory.thread와 memory.resource를 전달하여 Observational Memory를 활성화하세요.

src/mastra/run.ts

import { weatherAgent } from "./agents/weather-agent";

const memory = {
  thread: "assistant-thread-1",
  resource: "user-42",
};

const result = await weatherAgent.stream("My name is Alex and I prefer concise answers.", {
  memory,
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

구성

# Use gateway API key
MASTRA_GATEWAY_API_KEY=your-gateway-key

자세히 알아보기

• 특징
• Model
• 제한
• API 참조
• 예