docs
SDK мен фреймворктер

Mastra

Markdown

Агенттер фреймворкі · OpenAI Chat, OpenAI Responses

Толық нұсқаулық
ФорматҚайда баптау керек
OpenAI Chat, OpenAI ResponsesAgent ішінде: model: { id: "<provider>/<model>", url: "<базалық мекенжай>", apiKey, api?: "chat" | "responses" }

Баптау

Конфигурацияны көшіріп, мынаны ауыстырыңыз: sk-... Ailoot жеке кабинетіңіздегі кілтке. Кілтті мына орта айнымалысында сақтаған дұрыс: AILOOT_API_KEY, қолданба мұны қолдаса.

Іске қоспас бұрын Ailoot кілтіңізбен GET /v1/models сұрауын жіберіңіз. Әдістері POST /v1/chat/completions, POST /v1/responses қамтитын нақты модель ID мәнін таңдап, баптауда қолданыңыз. Агенттер үшін клиент нұсқасына қажетті құралдар мен мүмкіндіктердің қолдауын да тексеріңіз.

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. Оны қолданбаны іске қоспас бұрын орнатыңыз:

export AILOOT_API_KEY="sk-..."   # ~/.zshrc немесе ~/.bashrc файлына қосыңыз

Модель мысалы: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Кез келген басқа модельді мына жерден алыңыз: каталогтан — оның қажетті форматты қолдайтынын тексеріңіз.

Білу маңызды

Тексеру

  • OpenAI форматы үшін мекенжай — https://api.ailoot.ai/v1 (немесе қолданба толық мекенжай сұраса, толық жол).
  • Қысқа сұрақ қойыңыз. Қате келсе, код пен Request ID-ді қарап, мына бетпен салыстырыңыз: Қателер және лимиттер.
  • Баптаудан кейін бірден шыққан 404 әрдайым дерлік мекенжайдың қате екенін білдіреді: артық немесе жетіспейтін /v1.
  • 402 — резервке баланс жетпейді. Агенттер чатқа қарағанда көбірек резервтейді: неге.

Қолданба құжаттамасы: https://mastra.ai/models

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.Қолдау қызметіне жазу