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
urlbase URL’dir ve/v1ile biter. Mastra/chat/completionsyolunu ekler.api: "responses"eklemeyin. Mastra belgelerine göre bu ayar/v1/responsesuç 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.
iddeğerinibroadnet/broadnet/glm-5.3olarak yazın. Ardındanurldeğerinin/v1ile bittiğini kontrol edin. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızcabroadnet/gemma-4-26b-a4bmodelini ve iki Transcribe modelini kapsar. - 401.
BROADNET_API_KEYsü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.
