Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Mastra AI — open-source TypeScript-фреймворк для AI-приложений, агентов, workflow, tools, memory и MCP. Его выбирают команды, которым удобнее строить agentic backend в Node.js/TypeScript, а не в Python. О Mastra говорят потому, что рынок AI-инструментов долго был Python-first. Но многие web-команды живут в TypeScript: Next.js, Hono, Express, serverless, edge, npm-пакеты. Mastra даёт им знакомый стек для агентных приложений. В статье разберём, как устроен Mastra и как подключить модели SpeShu.AI через OpenAI-compatible provider.

​
Что такое mastra ai

Mastra AI — это framework для создания AI-powered applications. В центре находится Agent: он получает instructions, model, tools, memory и может генерировать ответы или работать внутри workflow. Инструмент нужен разработчикам, которые хотят встроить AI-агентов в TypeScript backend, SaaS-продукт, dashboard, internal tool или API. Mastra полезен, если команда уже использует Vercel AI SDK-подход, typed tools и современный Node.js стек.

​
Как работает mastra ai

Типовая архитектура:
  • agent описывает поведение;
  • model отвечает за LLM-вызовы;
  • tools дают агенту действия;
  • memory хранит контекст;
  • workflows делают процесс надёжнее;
  • MCP позволяет подключать внешние инструменты.
Mastra принимает model object. Поэтому можно создать OpenAI-compatible provider через createOpenAI из @ai-sdk/openai и передать его в агента.

​
Что умеет mastra ai

  • создавать TypeScript-агентов;
  • подключать tools;
  • строить workflows;
  • добавлять memory;
  • использовать MCP;
  • запускать локальный dev server;
  • встраиваться в backend-приложения.
Мини-кейсы: AI-ассистент в SaaS, workflow обработки заявок, агент для поиска по базе, внутренний helper для команды продаж, API для генерации контента.

​
mastra ai на практике

Пример агента с моделью SpeShu.AI: 
import { Agent } from "@mastra/core/agent";
import { createOpenAI } from "@ai-sdk/openai";

const speshu = createOpenAI({
  baseURL: "https://speshu.ai/api/v1",
  apiKey: process.env.SPESHU_AI_API_KEY,
});

export const supportAgent = new Agent({
  name: "support-agent",
  instructions:
    "Ты ассистент поддержки. Отвечай кратко, уточняй детали, если данных недостаточно.",
  model: speshu("openai/gpt-5.5"),
});

const result = await supportAgent.generate(
  "Клиент спрашивает, как подключить API к RAG-боту. Что ответить?"
);

console.log(result.text);
Дальше добавьте tools: поиск по базе знаний, создание тикета, запрос в CRM или отправку сообщения. Если workflow критичный, не поручайте всё одному агенту: вынесите шаги в Mastra Workflow и оставьте модели только reasoning.

​
Преимущества и недостатки mastra ai

Плюсы:
  • TypeScript-first подход;
  • удобно для web/backend-команд;
  • agents, tools, memory и workflows в одном стеке;
  • можно использовать OpenAI-compatible provider.
Минусы:
  • экосистема моложе Python-фреймворков;
  • нужно следить за версиями AI SDK и Mastra;
  • для data-heavy RAG может потребоваться отдельная vector DB и ingestion pipeline.

​
mastra ai vs альтернативы

Mastra AI vs CrewAI: CrewAI — Python-first и удобен для ролевых multi-agent процессов. Mastra — TypeScript-first и ближе к web-продуктам. Mastra AI vs LangGraph: LangGraph сильнее в явном графе состояний. Mastra удобнее как Node.js agent application framework. Mastra AI vs n8n: n8n — visual automation. Mastra — кодовый framework для разработчиков.

​
Кому подойдёт mastra ai

Mastra подойдёт TypeScript-разработчикам, SaaS-командам, стартапам, backend-инженерам и тем, кто хочет держать AI-логику рядом с продуктовым кодом. Если ваша команда пишет на Python, проще начать с LangChain, LlamaIndex или CrewAI. Если основной стек TypeScript, Mastra выглядит естественно.

​
Как попробовать mastra ai через SpeShu.AI

SpeShu.AI подключается как OpenAI-compatible endpoint:
  • не нужен VPN;
  • не нужна зарубежная карта;
  • доступ к нескольким моделям;
  • один ключ для backend и agents;
  • быстрый старт через speshu.ai/profile.
Используйте baseURL: "https://speshu.ai/api/v1" и модель из каталога.

​
Заключение

Mastra AI стоит попробовать TypeScript-командам, которые строят AI-агентов как часть продукта. Главный инсайт: агент должен быть обычным backend-компонентом с tools, тестами и ограничениями, а не отдельным экспериментом. Начните с одного агента и одного tool. Затем добавляйте workflow, memory и MCP.

Подключить API

Запустите интеграцию через SpeShu.AI: единый доступ к AI-моделям, без VPN и зарубежной карты