Source: https://ailoot.ai/docs/kk/integrations/mastra/
Canonical: https://ailoot.ai/docs/kk/integrations/mastra/
Language: kk

[SDK мен фреймворктер](https://ailoot.ai/docs/kk/integrations/#sdk) 

# Mastra

[Markdown](https://ailoot.ai/docs/kk/integrations/mastra/index.md)

Агенттер фреймворкі · OpenAI Chat, OpenAI Responses

| Формат | Қайда баптау керек |
| --- | --- |
| OpenAI Chat, OpenAI Responses | Agent ішінде: model: { id: "\<provider\>/\<model\>", url: "\<базалық мекенжай\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/kk/integrations/mastra/#setup)Баптау

Конфигурацияны көшіріп, мынаны ауыстырыңыз: `sk-...` Ailoot жеке кабинетіңіздегі кілтке. Кілтті мына орта айнымалысында сақтаған дұрыс: `AILOOT_API_KEY`, қолданба мұны қолдаса.

Іске қоспас бұрын Ailoot кілтіңізбен GET /v1/models сұрауын жіберіңіз. Әдістері POST /v1/chat/completions, POST /v1/responses қамтитын нақты модель ID мәнін таңдап, баптауда қолданыңыз. Агенттер үшін клиент нұсқасына қажетті құралдар мен мүмкіндіктердің қолдауын да тексеріңіз.

```js
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Орыс тілінде жауап бер",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // responses әдісі бар модельдер үшін ғана
  }
});
```

Бұл баптау кілтті мына айнымалыдан оқиды: `AILOOT_API_KEY`. Оны қолданбаны іске қоспас бұрын орнатыңыз:

```bash
export AILOOT_API_KEY="sk-..."   # ~/.zshrc немесе ~/.bashrc файлына қосыңыз
```

```powershell
setx AILOOT_API_KEY "sk-..."   # содан кейін терминалды қайта іске қосыңыз
```

Модель мысалы: `ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`. Кез келген басқа модельді мына жерден алыңыз: [каталогтан](https://ailoot.ai/models/kk/) — оның қажетті форматты қолдайтынын тексеріңіз.

## [](https://ailoot.ai/docs/kk/integrations/mastra/#notes)Білу маңызды

url ішінде /chat/completions толық жолы емес, /v1 бөлігі бар базалық мекенжай көрсетіледі. Әдепкіде Chat Completions қолданылады, api: "responses" Responses API-іне ауыстырады. id мәнінің "провайдер/модель" пішімі шлюзге модельдің жалаң id мәнін жібереді. model нысанындағы apiKey өрісі құжаттамада тақырыптары бар мысалда көрсетілген; url-мен бірге қолданылуы бөлек сипатталмаған.

## [](https://ailoot.ai/docs/kk/integrations/mastra/#check)Тексеру

- OpenAI форматы үшін мекенжай — `https://api.ailoot.ai/v1` (немесе қолданба толық мекенжай сұраса, толық жол).
- Қысқа сұрақ қойыңыз. Қате келсе, код пен Request ID-ді қарап, мына бетпен салыстырыңыз: [Қателер және лимиттер](https://ailoot.ai/docs/kk/errors/).
- Баптаудан кейін бірден шыққан 404 әрдайым дерлік мекенжайдың қате екенін білдіреді: артық немесе жетіспейтін `/v1`.
- 402 — резервке баланс жетпейді. Агенттер чатқа қарағанда көбірек резервтейді: [неге](https://ailoot.ai/docs/kk/billing/reserve/).

Қолданба құжаттамасы: [https://mastra.ai/models](https://mastra.ai/models)

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.