dokumentaatio
SDK:t ja ohjelmistokehykset

Mastra

Markdown

Agenttikehys · OpenAI Chat, OpenAI Responses

Koko opas
MuotoMissä asetetaan
OpenAI Chat, OpenAI ResponsesKohdassa Agent: model: { id: "<tarjoaja>/<malli>", url: "<perusosoite>", apiKey, api?: "chat" | "responses" }

Asetukset

Kopioi konfiguraatio ja korvaa sk-... omalla Ailootin hallintapaneelin avaimellasi. Avain kannattaa säilyttää ympäristömuuttujassa AILOOT_API_KEY, jos sovellus tukee sitä.

Kutsu ennen käynnistystä GET /v1/models omalla Ailoot-avaimellasi. Valitse tarkka mallitunnus, jonka menetelmiin kuuluu POST /v1/chat/completions, POST /v1/responses, ja käytä sitä asetuksissa. Tarkista agentteja varten myös työkalutuki ja asiakasversiosi tarvitsemat ominaisuudet.

import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Vastaa venäjäksi",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // vain malleille, joilla on responses-menetelmä
  }
});

Tämä asetus lukee avaimen muuttujasta AILOOT_API_KEY. Määritä se ennen sovelluksen käynnistämistä:

export AILOOT_API_KEY="sk-..."   # lisää tiedostoon ~/.zshrc tai ~/.bashrc

Esimerkkimalli: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Valitse muut mallit luettelosta — tarkista, että malli tukee tarvittavaa muotoa.

Hyvä tietää

Tarkistus

  • OpenAI-muodon osoite on https://api.ailoot.ai/v1 (tai koko polku, jos sovellus pyytää koko osoitetta).
  • Esitä lyhyt kysymys. Jos saat virheen, katso koodi ja Request ID ja tarkista ohjeet sivulta Virheet ja rajoitukset.
  • 404 heti asetusten jälkeen tarkoittaa lähes aina väärää osoitetta: ylimääräinen tai puuttuva /v1.
  • 402 — saldo ei riitä varaukseen. Agentit varaavat chatia enemmän: miksi.

Sovelluksen dokumentaatio: https://mastra.ai/models

Onko vielä kysyttävää? Lähetä Request ID ja kuvaus — autamme selvittämään asian.Ota yhteyttä tukeen