Source: https://ailoot.ai/docs/fi/integrations/mastra/
Canonical: https://ailoot.ai/docs/fi/integrations/mastra/
Language: fi

[SDK:t ja ohjelmistokehykset](https://ailoot.ai/docs/fi/integrations/#sdk) 

# Mastra

[Markdown](https://ailoot.ai/docs/fi/integrations/mastra/index.md)

Agenttikehys · OpenAI Chat, OpenAI Responses

| Muoto | Missä asetetaan |
| --- | --- |
| OpenAI Chat, OpenAI Responses | Kohdassa Agent: model: { id: "\<tarjoaja\>/\<malli\>", url: "\<perusosoite\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/fi/integrations/mastra/#setup)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.

```js
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ä:

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

```powershell
setx AILOOT_API_KEY "sk-..."   # käynnistä sitten terminaali uudelleen
```

Esimerkkimalli: `ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`. Valitse muut mallit [luettelosta](https://ailoot.ai/models/fi/) — tarkista, että malli tukee tarvittavaa muotoa.

## [](https://ailoot.ai/docs/fi/integrations/mastra/#notes)Hyvä tietää

url-kenttään annetaan perusosoite, jossa on /v1, ei koko polkua /chat/completions. Oletuksena käytetään Chat Completionsia; api: "responses" vaihtaa Responses APIin. id muodossa "tarjoaja/malli" lähettää mallin id:n ilman etuliitettä yhdyskäytävään. Dokumentaatio näyttää model-objektin apiKey-kentän otsakkeita käyttävässä esimerkissä; sitä ei kuvata erikseen yhdessä url-kentän kanssa.

## [](https://ailoot.ai/docs/fi/integrations/mastra/#check)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](https://ailoot.ai/docs/fi/errors/).
- 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](https://ailoot.ai/docs/fi/billing/reserve/).

Sovelluksen dokumentaatio: [https://mastra.ai/models](https://mastra.ai/models)

Onko vielä kysyttävää? Lähetä Request ID ja kuvaus — autamme selvittämään asian.[Ota yhteyttä tukeen](mailto:support@ailoot.ai)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.