Mastra

Gateway 是內置 Observational Memory、與 OpenAI 相容的 API 代理。只需將任何 HTTP 用戶端、SDK 或框架指向 Gateway，每段對話便會自動記錄，毋須編寫任何記憶管理程式碼。

詳情請參閱Gateway 文件。

取得 API 金鑰

前往 gateway.mastra.ai 註冊 Mastra 帳戶。完成啟用流程時，你會取得個人 API 金鑰，用於驗證請求。

用法

將 API 金鑰定義為環境變數：

.env

MASTRA_GATEWAY_API_KEY=your-gateway-key

設定 Gateway 模型 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',
})

對於需要經 Gateway 運行的嵌入模型，請使用相同前綴：

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

延伸閱讀

• 功能
• 模型
• 限制
• API 參考
• 範例