BroadRouter

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

آخر تحديث

في 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 و@mastra/core 1.83.0.

التثبيت

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

ربط وكيل

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 (صحيح)

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

الأدوات

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 الأدوات والمخرجات المنظَّمة لهذين النموذجين فقط.

البث

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

أسعار كل النماذج. ولاستخدام Vercel AI SDK من دون Mastra، راجع دليل AI SDK.

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

في 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 غير مضبوط في العملية، أو المفتاح خاطئ أو استنفد رصيده.
  • ردود فارغة. استهلك الاستدلال المنطقي ميزانية المخرجات. راجع لماذا تعود الإجابات فارغة.
  • 429 في مسارات العمل ذات الخطوات المتوازية. يسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 قيد التنفيذ؛ وجلسة الخطة تشغّل طلبًا واحدًا في كل مرة. راجع الأخطاء وإعادة المحاولة.

أسئلة شائعة

لماذا يرسل 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. في اختبارنا مع الخادم الوهمي أرسل الوكيل مخطط الأداة، وشغّل الأداة، وأعاد النتيجة.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity