BroadRouter

Mastra ajanlarını BroadNet Inference ile kullanın

Güncellendi

Bir Mastra Agent'ta model değerini şu nesne yapın: url https://inference.broadnet.ai/v1, apiKey BROADNET_API_KEY'den ve id broadnet/broadnet/glm-5.3. Mastra id'nin ilk bölümünü sağlayıcı adı sayıp atar; çift önek sayesinde BroadNet'e broadnet/glm-5.3 gider. Özel URL'ler varsayılan olarak chat completions kullanır. Araçlar için GLM 5.3 veya Qwen3.8 27B kullanın.

Mastra, yapay zekâ ajanları ve iş akışları (workflow) için bir TypeScript framework’üdür. Yerleşik sağlayıcılarının yanı sıra bir ajanın model değeri, id ve url içeren bir nesne olarak verilen herhangi bir OpenAI uyumlu uç nokta olabilir. BroadNet Inference standart chat completions isteklerini https://inference.broadnet.ai/v1 adresinde sunduğu için bu yolla çalışır; model kimliğinde yalnızca bir püf noktası var. BroadRouter, BroadNet’in kendi sitesidir; bu rehber Mastra’nın model belgelerini ve @mastra/core 1.83.0’ı izler.

Kurulum

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

Bir ajan bağlayın

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);

Neden çift önek

Mastra belgelerine göre provider/model biçiminde yazılan bir id, uzak sunucuya yalın model adını gönderir; gateway/provider/model biçimi ise sağlayıcıyı adda tutar. BroadNet kimlikleri eğik çizgi içerdiği için daha uzun biçime ihtiyaç duyar. Testimizde:

Mastra id BroadNet’e ulaşan model kimliği
broadnet/glm-5.3 glm-5.3 (yanlış)
broadnet/broadnet/glm-5.3 broadnet/glm-5.3 (doğru)

Yukarıdaki yardımcı fonksiyon fazladan bölümü sizin yerinize ekler.

Araçlar

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"),
});

Araç kullanan ajanlar için broadnet/glm-5.3 veya broadnet/qwen3.8-27b kullanın. BroadNet’in belgeleri araçları ve yapılandırılmış çıktıyı yalnızca bu iki model için listeler.

Akış (streaming)

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

Önemli ayarlar

  • url base URL’dir ve /v1 ile biter. Mastra /chat/completions yolunu ekler.
  • api: "responses" eklemeyin. Mastra belgelerine göre bu ayar /v1/responses uç noktasına geçirir. BroadNet Responses API’yi listelemez.
  • Çıktı sınırı. DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B yanıt vermeden önce akıl yürütür ve akıl yürütme çıktı sınırına dahildir. Çıktı token’larını sınırlıyorsanız 2.000 veya daha fazla bırakın.

Hangi modeli seçmeli

Ajan Model
Araçlar, yapılandırılmış çıktı, iş akışları broadnet/glm-5.3
Araçlar artı görsel girdi veya Arapça metin broadnet/qwen3.8-27b
Sabit fiyatlı planda yalnızca metin adımları broadnet/deepseek-v4.1-flash

Tüm modellerin fiyatları. Mastra olmadan Vercel AI SDK için AI SDK rehberine bakın.

Bunu nasıl test ettik

2026-11-15’te Node 24 ile @mastra/core 1.83.0’ı kurduk ve generate, stream ile araç kullanan bir ajanı, BroadNet’in chat completions yapısını konuşan ve araç çağrıları döndüren yerel bir mock sunucuya karşı çalıştırdık. Kaydedilen istekleri okuduk. Her çağrı /v1/chat/completions adresine, apiKey değerinden gelen bir Bearer anahtarıyla gitti. Yukarıdaki tablodaki önek kuralını da böyle bulduk. Elimizde bir BroadNet anahtarı yoktu; bu yüzden gerçek model çıktısını test etmedik.

Sorun giderme

  • 404 veya model bulunamadı. Model kimliği büyük olasılıkla önekini kaybetti. id değerini broadnet/broadnet/glm-5.3 olarak yazın. Ardından url değerinin /v1 ile bittiğini kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızca broadnet/gemma-4-26b-a4b modelini ve iki Transcribe modelini kapsar.
  • 401. BROADNET_API_KEY süreçte tanımlı değil ya da anahtar yanlış veya kullanım hakkı tükenmiş.
  • Boş yanıtlar. Akıl yürütme çıktı bütçesini tüketti. Yanıtlar neden boş geliyor.
  • Paralel adımlı iş akışlarında 429. Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 işlemdeki isteğe izin verir; bir plan oturumu ise istekleri tek tek çalıştırır. Hatalar ve yeniden denemeler rehberine bakın.

Sık sorulan sorular

Mastra neden broadnet/glm-5.3 yerine glm-5.3 gönderiyor?

Mastra model id'sini sağlayıcı/model olarak okur ve yalnızca ilk eğik çizgiden sonraki kısmı gönderir. Testimizde broadnet/glm-5.3 id'siyle glm-5.3 gönderdi; BroadNet bunu tanımaz. id'yi broadnet/broadnet/glm-5.3 olarak yazın.

Mastra url değeri base URL mi olmalı, chat completions URL'si mi?

Base URL. Mastra belgeleri OpenAI uyumlu uç noktanın base URL'sinin kullanılmasını söyler; yani /chat/completions olmadan https://inference.broadnet.ai/v1 kullanın.

Mastra özel bir URL ile Responses API'yi mi kullanır?

Varsayılan olarak hayır. Mastra belgelerine göre api değerini responses olarak eklemediğiniz sürece özel uç noktalar chat completions kullanır. Chat completions sunan BroadNet için bunu eklemeyin.

Mastra araçları BroadNet'te çalışıyor mu?

Evet; BroadNet'in araç desteğiyle listelediği bir modelde, yani GLM 5.3 veya Qwen3.8 27B'de. Mock testimizde ajan araç şemasını gönderdi, aracı çalıştırdı ve sonucu döndürdü.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor