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

本页内容