SDK 与框架
Mastra
在 Mastra Agent 框架中通过 OpenAI 兼容 provider 使用 AsterMesh。
Mastra 是 TypeScript 开发者常用的 Agent 框架。它基于 AI SDK 的模型接口，所以只要用 @ai-sdk/openai-compatible 创建一个指向 AsterMesh 的 provider，Agent、Workflow、RAG 都能直接用。
安装依赖
npm install @mastra/core @ai-sdk/openai-compatible配置环境变量
创建 .env：
ASTERMESH_API_KEY=sk-...创建 Agent
import { Agent } from '@mastra/core/agent';
import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
const provider = createOpenAICompatible({
name: 'astermesh',
baseURL: 'https://console.astermesh.cn/v1',
apiKey: process.env.ASTERMESH_API_KEY!,
});
export const assistant = new Agent({
name: 'assistant',
instructions: '你是一个乐于助人的中文助手。',
model: provider.chatModel('MODEL_ID'),
});把 MODEL_ID 换成控制台模型列表里的完整模型 ID。
调用
const result = await assistant.generate('用一句话介绍 AsterMesh。');
console.log(result.text);注意事项
- Mastra 的工具调用（tools）依赖模型的 function calling 能力，建议选择 Claude、GPT 等支持工具调用的模型。
- 一个 provider 实例可以创建多个模型，例如给不同 Agent 分配不同的
chatModel('...')。 - 如果想让整个团队共享 provider 配置，也可以实现 Mastra 的自定义网关（
MastraModelGateway），见 Mastra Custom Gateways。