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

[SDK dan rangka kerja](https://ailoot.ai/docs/ms/integrations/#sdk) 

# Mastra

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

Rangka kerja ejen · OpenAI Chat, OpenAI Responses

| Format | Tempat membuat tetapan |
| --- | --- |
| OpenAI Chat, OpenAI Responses | Dalam Agent: model: { id: "\<penyedia\>/\<model\>", url: "\<alamat asas\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/ms/integrations/mastra/#setup)Konfigurasi

Salin konfigurasi dan gantikan `sk-...` dengan kunci anda daripada panel pengguna Ailoot. Sebaiknya simpan kunci dalam pemboleh ubah persekitaran `AILOOT_API_KEY`, jika aplikasi menyokongnya.

Sebelum bermula, panggil GET /v1/models dengan kunci Ailoot anda. Pilih ID model tepat yang kaedahnya merangkumi POST /v1/chat/completions, POST /v1/responses, kemudian gunakannya dalam konfigurasi. Untuk ejen, semak juga sokongan alat dan ciri yang diperlukan oleh versi klien anda.

```js
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Jawab dalam bahasa Rusia",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // hanya untuk model dengan kaedah responses
  }
});
```

Konfigurasi ini membaca kunci daripada pemboleh ubah `AILOOT_API_KEY`. Tetapkannya sebelum menjalankan aplikasi:

```bash
export AILOOT_API_KEY="sk-..."   # tambahkan pada ~/.zshrc atau ~/.bashrc
```

```powershell
setx AILOOT_API_KEY "sk-..."   # kemudian mulakan semula terminal
```

Contoh model: `ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`. Ambil mana-mana model lain daripada [katalog](https://ailoot.ai/models/ms/) — pastikan model mempunyai format yang diperlukan.

## [](https://ailoot.ai/docs/ms/integrations/mastra/#notes)Perkara yang perlu diketahui

url menetapkan alamat asas dengan /v1, bukan laluan penuh ke /chat/completions. Secara lalai, Chat Completions digunakan; api: "responses" menukar kepada Responses API. Bentuk id "penyedia/model" menghantar id model tanpa awalan kepada gerbang. Medan apiKey dalam objek model ditunjukkan dalam dokumentasi melalui contoh dengan pengepala; penggunaannya bersama url tidak diterangkan secara berasingan.

## [](https://ailoot.ai/docs/ms/integrations/mastra/#check)Semakan

- Alamat untuk format OpenAI ialah `https://api.ailoot.ai/v1` (atau laluan penuh, jika aplikasi meminta alamat penuh).
- Ajukan soalan ringkas. Jika ralat diterima, semak kod dan Request ID serta rujuk halaman [Ralat dan had](https://ailoot.ai/docs/ms/errors/).
- 404 sejurus selepas konfigurasi hampir selalu bermaksud alamat tidak betul: terdapat lebihan atau kekurangan `/v1`.
- 402 — baki tidak mencukupi untuk rizab. Ejen merizabkan lebih banyak daripada sembang: [sebabnya](https://ailoot.ai/docs/ms/billing/reserve/).

Dokumentasi aplikasi: [https://mastra.ai/models](https://mastra.ai/models)

Masih ada soalan? Hantar Request ID dan penerangannya — kami akan membantu menyiasatnya.[Hubungi sokongan](mailto:support@ailoot.ai)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.