dokumentace
SDK a frameworky

Mastra

Markdown

Framework pro agenty · OpenAI Chat, OpenAI Responses

Úplný průvodce
FormátKde nastavit
OpenAI Chat, OpenAI ResponsesV Agent: model: { id: "<poskytovatel>/<model>", url: "<základní adresa>", apiKey, api?: "chat" | "responses" }

Nastavení

Zkopírujte konfiguraci a nahraďte sk-... svým klíčem z účtu Ailoot. Klíč je lepší uložit do proměnné prostředí AILOOT_API_KEY, pokud to aplikace umožňuje.

Před spuštěním zavolejte GET /v1/models se svým klíčem Ailoot. Vyberte přesné ID modelu, jehož metody zahrnují POST /v1/chat/completions, POST /v1/responses, a použijte je v konfiguraci. U agentů ověřte také podporu nástrojů a funkce potřebné pro vaši verzi klienta.

import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Odpovídej rusky",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // pouze pro modely s metodou responses
  }
});

Toto nastavení načítá klíč z proměnné AILOOT_API_KEY. Nastavte ji před spuštěním aplikace:

export AILOOT_API_KEY="sk-..."   # přidejte do ~/.zshrc nebo ~/.bashrc

Příklad modelu: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Jakýkoli jiný model vyberte z katalogu – ověřte, že podporuje požadovaný formát.

Co je dobré vědět

Ověření

  • Adresa pro formát OpenAI je https://api.ailoot.ai/v1 (nebo úplná cesta, pokud aplikace vyžaduje úplnou adresu).
  • Položte krátkou otázku. Pokud se objeví chyba, podívejte se na kód a Request ID a porovnejte je s informacemi na stránce Chyby a limity.
  • Chyba 404 hned po nastavení téměř vždy znamená nesprávnou adresu: nadbytečné nebo chybějící /v1.
  • Chyba 402 – zůstatek nestačí na rezervu. Agenti rezervují více než chat: proč.

Dokumentace aplikace: https://mastra.ai/models

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.Napsat podpoře