Mastra
MarkdownFramework de agentes · OpenAI Chat, OpenAI Responses
Guia completo
| Formato | Onde configurar |
|---|---|
| OpenAI Chat, OpenAI Responses | Em Agent: model: { id: "<fornecedor>/<modelo>", url: "<endereço de base>", apiKey, api?: "chat" | "responses" } |
Configuração
Copie a configuração e substitua sk-... pela sua chave da área pessoal Ailoot. É preferível guardar a chave na variável de ambiente AILOOT_API_KEY, se a aplicação o permitir.
Antes de iniciar, consulte GET /v1/models com a sua chave Ailoot. Escolha um ID exato de modelo cujos métodos incluam POST /v1/chat/completions, POST /v1/responses e use-o na configuração. Para agentes, verifique também as ferramentas e funcionalidades necessárias à sua versão do cliente.
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
id: "ailoot-agent",
name: "Ailoot Agent",
instructions: "Responda em russo",
model: {
id: "ailoot/claude-sonnet-5-5",
url: "https://api.ailoot.ai/v1",
apiKey: process.env.AILOOT_API_KEY
// api: "responses" // apenas para modelos com o método responses
}
});Esta configuração lê a chave da variável AILOOT_API_KEY. Defina-a antes de iniciar a aplicação:
export AILOOT_API_KEY="sk-..." # adicione a ~/.zshrc ou ~/.bashrcsetx AILOOT_API_KEY "sk-..." # depois reinicie o terminalExemplo de modelo: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol. Escolha qualquer outro modelo no catálogo — verifique se suporta o formato necessário.
O que deve saber
Verificação
- Para o formato OpenAI, o endereço é
https://api.ailoot.ai/v1(ou o caminho completo, se a aplicação pedir o endereço completo). - Faça uma pergunta curta. Se receber um erro, consulte o código e o Request ID e compare com a página Erros e limites.
- Um 404 logo após a configuração quase sempre indica um endereço incorreto: um segmento a mais ou em falta,
/v1. - 402 — o saldo não chega para a reserva. Os agentes reservam mais do que um chat: porquê.
Documentação da aplicação: https://mastra.ai/models