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

[SDK a frameworky](https://ailoot.ai/docs/cs/integrations/#sdk) 

# Mastra

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

Framework pro agenty · OpenAI Chat, OpenAI Responses

| Formát | Kde nastavit |
| --- | --- |
| OpenAI Chat, OpenAI Responses | V Agent: model: { id: "\<poskytovatel\>/\<model\>", url: "\<základní adresa\>", apiKey, api?: "chat" \| "responses" } |

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

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

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

```powershell
setx AILOOT_API_KEY "sk-..."   # poté restartujte terminál
```

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

## [](https://ailoot.ai/docs/cs/integrations/mastra/#notes)Co je dobré vědět

V url se uvádí základní adresa s /v1, nikoli úplná cesta k /chat/completions. Ve výchozím nastavení se používá Chat Completions, api: "responses" přepíná na Responses API. Tvar id "poskytovatel/model" odesílá do brány samotné id modelu. Pole apiKey v objektu model je v dokumentaci ukázáno na příkladu s hlavičkami; společně s url není samostatně popsáno.

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

Dokumentace aplikace: [https://mastra.ai/models](https://mastra.ai/models)

Máte další dotazy? Pošlete Request ID a popis – pomůžeme situaci objasnit.[Napsat podpoře](mailto:support@ailoot.ai)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.