docs
SDK-k és keretrendszerek

Mastra

Markdown

Ügynök-keretrendszer · OpenAI Chat, OpenAI Responses

Teljes útmutató
FormátumHol állítható be?
OpenAI Chat, OpenAI ResponsesAz Agent objektumban: model: { id: "<szolgáltató>/<modell>", url: "<alapcím>", apiKey, api?: "chat" | "responses" }

Beállítás

Másolja le a konfigurációt, és cserélje ki a sk-... értéket a saját Ailoot-fiókkulcsára. Érdemes a kulcsot a következő környezeti AILOOT_API_KEYváltozóban tárolni, ha az alkalmazás támogatja.

Indítás előtt hívd meg a GET /v1/models végpontot az Ailoot-kulcsoddal. Válassz pontos modellazonosítót, amelynek metódusai között szerepel POST /v1/chat/completions, POST /v1/responses, és ezt használd a beállításban. Ügynököknél ellenőrizd az eszközkezelést és a kliensverziódhoz szükséges funkciókat is.

import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Válaszoljon oroszul",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // csak a responses metódust támogató modellekhez
  }
});

Ez a beállítás a kulcsot ebből a változóból olvassa: AILOOT_API_KEY. Az alkalmazás indítása előtt állítsa be:

export AILOOT_API_KEY="sk-..."   # adja hozzá a ~/.zshrc vagy ~/.bashrc fájlhoz

Példamodell: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Más modelleket a katalógusból válasszon — ellenőrizze, hogy támogatják-e a szükséges formátumot.

Fontos tudnivalók

Ellenőrzés

  • OpenAI formátumnál a cím: https://api.ailoot.ai/v1 (vagy a teljes útvonal, ha az alkalmazás teljes címet kér).
  • Tegyen fel egy rövid kérdést. Ha hiba érkezik, nézze meg a kódot és a Request ID-t, majd vesse össze ezzel az oldallal: Hibák és korlátok.
  • A közvetlenül a beállítás után érkező 404-es hiba szinte mindig hibás címet jelent: felesleges vagy hiányzó /v1.
  • 402 — az egyenleg nem fedezi a zárolást. Az ügynökök többet zárolnak, mint a csevegők: miért?.

Az alkalmazás dokumentációja: https://mastra.ai/models

Maradt kérdése? Küldje el a Request ID-t és a probléma leírását — segítünk tisztázni.Írjon a támogatásnak