> ## 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: TypeScript-фреймворк для ИИ-агентов, workflow и tools

> Практический обзор Mastra AI: агенты на TypeScript, tools, memory, workflows, MCP и подключение SpeShu.AI через AI SDK.

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:

```typescript theme={null} theme={null}
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](https://speshu.ai/profile).

Используйте `baseURL: "https://speshu.ai/api/v1"` и модель из [каталога](/docs/api-reference/models/list).

## Заключение

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

Начните с одного агента и одного tool. Затем добавляйте workflow, memory и MCP.

***

<Card title="Подключить API" icon="plug" type="tip" href="https://speshu.ai/profile">
  Запустите интеграцию через SpeShu.AI: единый доступ к AI-моделям, без VPN и зарубежной карты
</Card>