dokumentacija
SDK in ogrodja

Mastra

Markdown

Ogrodje agentov · OpenAI Chat, OpenAI Responses

Celoten vodnik
FormatKje nastaviti
OpenAI Chat, OpenAI ResponsesV Agent: model: { id: "<ponudnik>/<model>", url: "<osnovni naslov>", apiKey, api?: "chat" | "responses" }

Konfiguracija

Kopirajte konfiguracijo in zamenjajte sk-... s svojim ključem iz nadzorne plošče Ailoot. Ključ je bolje shraniti v okoljsko spremenljivko AILOOT_API_KEY, če aplikacija to omogoča.

Pred zagonom pokličite GET /v1/models s svojim ključem Ailoot. Izberite točen ID modela, katerega metode vključujejo POST /v1/chat/completions, POST /v1/responses, in ga uporabite v nastavitvah. Pri agentih preverite tudi podporo orodjem in funkcije, ki jih potrebuje vaša različica odjemalca.

import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Odgovarjaj v ruščini",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // samo za modele z metodo responses
  }
});

Ta konfiguracija ključ prebere iz spremenljivke AILOOT_API_KEY. Nastavite jo pred zagonom aplikacije:

export AILOOT_API_KEY="sk-..."   # dodajte v ~/.zshrc ali ~/.bashrc

Primer modela: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Drug model izberite iz kataloga – preverite, ali podpira zahtevani format.

Kaj morate vedeti

Preverjanje

  • Pri formatu OpenAI je naslov https://api.ailoot.ai/v1 (ali celotna pot, če aplikacija zahteva celotni naslov).
  • Zastavite kratko vprašanje. Če prejmete napako, preverite kodo in Request ID ter si oglejte stran Napake in omejitve.
  • 404 takoj po konfiguraciji skoraj vedno pomeni napačen naslov: odvečen ali manjkajoč /v1.
  • 402 – stanje ne zadošča za rezervacijo. Agenti rezervirajo več kot klepet: zakaj.

Dokumentacija aplikacije: https://mastra.ai/models

Imate še vprašanja? Pošljite Request ID in opis – pomagali vam bomo razjasniti težavo.Pišite podpori