---
title: "Mastra مع نقطة نهاية مخصّصة متوافقة مع OpenAI (url) | BroadRouter"
description: "شغّل وكلاء Mastra على BroadNet Inference بكائن model يضبط id وurl وapiKey، مع البادئة broadnet/ المضاعفة التي يحتاجها معرّف النموذج."
url: https://broadrouter.com/ar/guides/mastra-openai-compatible/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/mastra-openai-compatible/) (حُدّث في 2026-11-16).

# استخدام وكلاء Mastra مع BroadNet Inference

آخر تحديث 2026-11-16

في Agent من Mastra، اضبط model على كائن فيه url بقيمة https://inference.broadnet.ai/v1، وapiKey من BROADNET\_API\_KEY، وid بقيمة broadnet/broadnet/glm-5.3. يعامل Mastra الجزء الأول من id كاسم مزوّد ويحذفه، فتُرسَل البادئة المضاعفة إلى BroadNet بصيغة broadnet/glm-5.3. وتستخدم العناوين المخصّصة chat completions افتراضيًا. استخدم GLM 5.3 أو Qwen3.8 27B للأدوات.

Mastra إطار عمل بلغة TypeScript لوكلاء الذكاء الاصطناعي ومسارات العمل (workflows). وإلى جانب المزوّدين المدمجين فيه، يمكن أن يكون `model` في الوكيل أي نقطة نهاية متوافقة مع OpenAI، تُعطى ككائن فيه `id` و`url`. وبما أن BroadNet Inference تقدّم chat completions القياسية على `https://inference.broadnet.ai/v1`، فهي تعمل بهذه الطريقة، مع ملاحظة واحدة في معرّف النموذج. BroadRouter هو موقع BroadNet نفسها؛ وتتبع الخطوات [توثيق النماذج في Mastra](https://mastra.ai/models) و@mastra/core 1.83.0.

## التثبيت

```bash
npm install @mastra/core zod
export BROADNET_API_KEY='your-broadnet-key'
```

## ربط وكيل

```ts
import { Agent } from "@mastra/core/agent";

const broadnet = (model: string) => ({
  id: `broadnet/${model}`,              // Mastra strips the first segment
  url: "https://inference.broadnet.ai/v1",
  apiKey: process.env.BROADNET_API_KEY,
});

export const assistant = new Agent({
  id: "assistant",
  name: "Assistant",
  instructions: "You are a concise assistant.",
  model: broadnet("broadnet/glm-5.3"),     // sends broadnet/glm-5.3
});

const res = await assistant.generate("Give me three names for a Go linting tool.");
console.log(res.text);
```

### لماذا البادئة المضاعفة

يقول توثيق Mastra إن `id` المكتوب بصيغة `provider/model` يرسل اسم النموذج وحده إلى الخادم البعيد، بينما تُبقي الصيغة `gateway/provider/model` اسم المزوّد ضمن الاسم. ومعرّفات BroadNet تحتوي على شرطة مائلة، فتحتاج إلى الصيغة الأطول. في اختبارنا:

| قيمة `id` في Mastra | معرّف النموذج الذي استلمته BroadNet |
| --- | --- |
| `broadnet/glm-5.3` | `glm-5.3` (خطأ) |
| `broadnet/broadnet/glm-5.3` | `broadnet/glm-5.3` (صحيح) |

الدالة المساعدة أعلاه تضيف الجزء الإضافي نيابةً عنك.

## الأدوات

```ts
import { createTool } from "@mastra/core/tools";
import { z } from "zod";

const weather = createTool({
  id: "get_weather",
  description: "Get the weather for a city",
  inputSchema: z.object({ city: z.string() }),
  execute: async (input) => ({ city: input.city, tempC: 21 }),
});

const agent = new Agent({
  id: "weather",
  name: "Weather",
  instructions: "Use the weather tool to answer.",
  tools: { weather },
  model: broadnet("broadnet/glm-5.3"),
});
```

استخدم `broadnet/glm-5.3` أو `broadnet/qwen3.8-27b` للوكلاء الذين يستخدمون الأدوات. يُدرج توثيق BroadNet الأدوات والمخرجات المنظَّمة لهذين النموذجين فقط.

## البث

```ts
const stream = await assistant.stream("Explain vector search in two sentences.");
for await (const chunk of stream.textStream) process.stdout.write(chunk);
```

## إعدادات مهمة

-   **`url`** هو العنوان الأساسي، وينتهي بـ `/v1`. ويضيف Mastra المسار `/chat/completions`.
-   **لا تضف `api: "responses"`.** يقول توثيق Mastra إن هذا الخيار ينقل الطلبات إلى `/v1/responses`، وBroadNet لا تُدرج Responses API.
-   **حد المخرجات.** نماذج DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B تستدل قبل أن تجيب، والاستدلال المنطقي يُحتسب ضمن حد المخرجات. إذا حدّدت سقفًا لرموز المخرجات، فاترك 2,000 أو أكثر.

## أي نموذج تختار

| الوكيل | النموذج |
| --- | --- |
| الأدوات، والمخرجات المنظَّمة، ومسارات العمل | `broadnet/glm-5.3` |
| أدوات مع مدخلات صور أو نصوص عربية | `broadnet/qwen3.8-27b` |
| خطوات نصية فقط على خطة بسعر ثابت | `broadnet/deepseek-v4.1-flash` |

[أسعار كل النماذج](https://broadrouter.com/ar/pricing/). ولاستخدام Vercel AI SDK من دون Mastra، راجع [دليل AI SDK](https://broadrouter.com/ar/guides/vercel-ai-sdk-openai-compatible/).

## كيف اختبرنا هذا

في 2026-11-15 ثبّتنا @mastra/core 1.83.0 مع Node 24، وشغّلنا `generate` و`stream` ووكيلًا يستخدم أداة مقابل خادم وهمي (mock) محلي يتحدث بنية chat completions الخاصة بـ BroadNet ويعيد استدعاءات أدوات. ثم قرأنا الطلبات المسجّلة: ذهب كل استدعاء إلى `/v1/chat/completions` بمفتاح Bearer مأخوذ من `apiKey`. وهكذا اكتشفنا قاعدة البادئة الواردة في الجدول أعلاه. لم يكن لدينا مفتاح BroadNet، لذا لم نختبر مخرجات نموذج حقيقية.

## حل المشكلات

-   **404 أو النموذج غير موجود.** الأرجح أن معرّف النموذج فقد بادئته. اكتب `id` بصيغة `broadnet/broadnet/glm-5.3`. ثم تحقق من أن `url` ينتهي بـ `/v1`. النماذج المدفوعة تحتاج إلى شحن الرصيد؛ والرصيد البالغ $5 يغطي `broadnet/gemma-4-26b-a4b` ونموذجَي Transcribe فقط.
-   **401.** المتغير `BROADNET_API_KEY` غير مضبوط في العملية، أو المفتاح خاطئ أو استنفد رصيده.
-   **ردود فارغة.** استهلك الاستدلال المنطقي ميزانية المخرجات. راجع [لماذا تعود الإجابات فارغة](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/).
-   **429 في مسارات العمل ذات الخطوات المتوازية.** يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ؛ وجلسة الخطة تشغّل طلبًا واحدًا في كل مرة. راجع [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

## مصطلحات في هذا الدليل

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[Chat Completions API (واجهة إكمال المحادثة)](https://broadrouter.com/ar/glossary/chat-completions-api/)

Chat Completions API هي نقطة نهاية HTTP لدى OpenAI، أي POST /v1/chat/completions، تستقبل اسم نموذج وقائمة رسائل موسومة بأدوارها وتُرجع الرسالة التالية من النموذج. وصارت بنية طلبها واستجابتها الصيغة المشتركة التي يعيد استخدامها المزوّدون المتوافقون مع OpenAI وحزم SDK.

[الرصيد المدفوع مسبقًا (Prepaid credit)](https://broadrouter.com/ar/glossary/prepaid-credit/)

الرصيد المدفوع مسبقًا هو مال يُضاف إلى حساب API قبل الاستخدام. يُخصم من الرصيد ثمن كل طلب، وعندما ينفد الرصيد تتوقف الطلبات المحتسبة بالاستهلاك حتى تشحن رصيدك. وهو يحصر الإنفاق في حدود ما دفعته.

[حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/)

حد المعدل هو سقف تفرضه واجهة API على مقدار استخدام العميل لها خلال فترة زمنية، مثل عدد الطلبات في الدقيقة أو الرموز في الدقيقة. وتُرفض الطلبات التي تتجاوزه، غالبًا بالخطأ HTTP 429 Too Many Requests، إلى أن يعود الاستخدام تحت الحد.

## أسئلة شائعة

### لماذا يرسل Mastra القيمة glm-5.3 بدلًا من broadnet/glm-5.3؟

يقرأ Mastra قيمة id للنموذج بصيغة provider/model ولا يرسل إلا الجزء الذي بعد الشرطة المائلة الأولى. ومع id بقيمة broadnet/glm-5.3 أرسل glm-5.3 في اختبارنا، وهو ما لن تتعرّف عليه BroadNet. اكتب id بصيغة broadnet/broadnet/glm-5.3.

### هل يكون url في Mastra العنوانَ الأساسي أم عنوان chat completions؟

العنوان الأساسي. يقول توثيق Mastra أن تستخدم العنوان الأساسي لنقطة النهاية المتوافقة مع OpenAI، فاستخدم https://inference.broadnet.ai/v1 من دون /chat/completions.

### هل يستخدم Mastra واجهة Responses API مع عنوان مخصّص؟

ليس افتراضيًا. يقول توثيق Mastra إن نقاط النهاية المخصّصة تستخدم chat completions ما لم تضف api بقيمة responses. لا تضفه مع BroadNet، فهي تقدّم chat completions.

### هل تعمل أدوات Mastra على BroadNet؟

نعم، على نموذج تُدرج له BroadNet الأدوات: GLM 5.3 أو Qwen3.8 27B. في اختبارنا مع الخادم الوهمي أرسل الوكيل مخطط الأداة، وشغّل الأداة، وأعاد النتيجة.

## أدلة ذات صلة

-   [استخدام Vercel AI SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/vercel-ai-sdk-openai-compatible/)
-   [استخدام OpenAI Node.js SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-node-sdk/)
-   [لماذا يعيد نموذج الاستدلال إجابة فارغة؟](https://broadrouter.com/ar/guides/reasoning-tokens-empty-response/)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [كل الأدوات التي تعمل مع BroadNet Inference (بالإنجليزية)](https://broadrouter.com/integrations/): حِزم SDK ووكلاء البرمجة وواجهات الدردشة وأدوات الأتمتة، مع الإعدادات الدقيقة لكل منها

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-mastra-openai-compatible&utm_content=page-cta) ·

**المصادر**

-   [توثيق Mastra، النماذج (نقاط نهاية مخصّصة متوافقة مع OpenAI) (رُوجع في 2026-11-15)](https://mastra.ai/models)
-   [Mastra على GitHub، إصدار @mastra/core 1.83.0، بتاريخ 2026-11-13 (رُوجع في 2026-11-15)](https://github.com/mastra-ai/mastra/releases/tag/%40mastra%2Fcore%401.83.0)
-   [المرجع التقني لـ BroadNet Inference API (رُوجع في 2026-11-15) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-mastra-openai-compatible&utm_content=sources)
