Mastra
在 Mastra Agent 框架中通过 @ai-sdk/openai-compatible 提供商模块接入 AnyStarX。
Mastra 是面向 TypeScript 生态的自主智能体开发框架。其底层模型层基于 Vercel AI SDK 构建,可以通过 @ai-sdk/openai-compatible 扩展包快速接入 AnyStarX,使项目中的智能体(Agent)、工作流(Workflow)和检索管道无缝使用平台上的大模型。
安装依赖模块
npm install @mastra/core @ai-sdk/openai-compatible配置环境变量
在本地运行环境或项目根目录下的 .env 中声明密钥:
ANYSTARX_API_KEY=sk-...创建 Agent 实例
通过 createOpenAICompatible 创建提供商实例,并在定义 Agent 时指定对应的模型标识符:
import { Agent } from '@mastra/core/agent';
import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
const provider = createOpenAICompatible({
name: 'anystarx',
baseURL: 'https://console.anystarx.com/v1',
apiKey: process.env.ANYSTARX_API_KEY!,
});
export const assistant = new Agent({
name: 'assistant',
instructions: '你是一个专注解决技术问题的工程文档助手。',
model: provider.chatModel('MODEL_ID'),
});将参数中的 MODEL_ID 替换为控制台模型列表中复制的完整标识符。
发起调用测试
const result = await assistant.generate('请用一句话介绍 AnyStarX。');
console.log(result.text);工程集成说明
- Mastra 的智能体工具调用(Tools)依赖底层模型对函数调用(Function Calling)特性的支持,建议在控制台中选择 Claude 或 OpenAI 系列中具备良好代码与工具执行能力的模型。
- 单一 provider 实例支持声明多个模型对象,可以根据具体任务类型分别为不同的 Agent 绑定不同规格的模型(例如轻量路由模型与主力生成模型)。
- 在微服务或大型工程架构中,也可以通过实现 Mastra 的模型网关规范(
MastraModelGateway)进行统一的流量分发,实现参考 Mastra Custom Gateways。