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

[SDK وأطر العمل](https://ailoot.ai/docs/ar/integrations/#sdk) 

# Mastra

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

إطار عمل للوكلاء · OpenAI Chat, OpenAI Responses

| الصيغة | مكان الإعداد |
| --- | --- |
| OpenAI Chat, OpenAI Responses | في Agent: ‏model: { id: "\<المزوّد\>/\<النموذج\>", url: "\<العنوان الأساسي\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/ar/integrations/mastra/#setup)الإعداد

انسخ الإعداد واستبدل `sk-...` بمفتاحك من لوحة حساب Ailoot. يُفضّل حفظ المفتاح في متغير البيئة `AILOOT_API_KEY`إذا كان التطبيق يدعم ذلك.

قبل البدء، استدعِ GET /v1/models بمفتاح Ailoot الخاص بك. اختر معرّف نموذج دقيقًا تتضمن طرقه POST /v1/chat/completions, POST /v1/responses واستخدمه في الإعدادات. للوكلاء، تحقّق أيضًا من دعم الأدوات والميزات المطلوبة لإصدار العميل لديك.

```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/ar/) — وتحقق من دعمه للصيغة المطلوبة.

## [](https://ailoot.ai/docs/ar/integrations/mastra/#notes)معلومات مهمة

يحدد url العنوان الأساسي مع /v1، لا المسار الكامل إلى /chat/completions. تُستخدم Chat Completions افتراضياً، وتحوّل api: "responses" إلى Responses API. ترسل صيغة id "المزوّد/النموذج" إلى البوابة معرّف النموذج وحده. يظهر الحقل apiKey في كائن model في مثال التوثيق مع الترويسات؛ ولا يُشرح مع url بصورة منفصلة.

## [](https://ailoot.ai/docs/ar/integrations/mastra/#check)التحقق

- لصيغة OpenAI، العنوان هو `https://api.ailoot.ai/v1` (أو المسار الكامل إذا طلب التطبيق عنواناً كاملاً).
- اطرح سؤالاً قصيراً. إذا ظهر خطأ، فراجع الرمز وRequest ID وطابقهما مع صفحة [الأخطاء والحدود](https://ailoot.ai/docs/ar/errors/).
- يشير 404 مباشرةً بعد الإعداد غالباً إلى عنوان غير صحيح: وجود لاحقة زائدة أو مفقودة من `/v1`.
- 402 يعني أن الرصيد غير كافٍ للحجز. يحجز الوكلاء أكثر من الدردشة: [لماذا](https://ailoot.ai/docs/ar/billing/reserve/).

توثيق التطبيق: [https://mastra.ai/models](https://mastra.ai/models)

هل لديك أسئلة أخرى؟ أرسل Request ID ووصفاً للمشكلة وسنساعدك على فهمها.[مراسلة الدعم](mailto:support@ailoot.ai)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.