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

[SDK và framework](https://ailoot.ai/docs/vi/integrations/#sdk) 

# Mastra

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

Framework tác nhân · OpenAI Chat, OpenAI Responses

| Định dạng | Nơi cấu hình |
| --- | --- |
| OpenAI Chat, OpenAI Responses | Trong Agent: model: { id: "\<nhà cung cấp\>/\<mô hình\>", url: "\<địa chỉ cơ sở\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/vi/integrations/mastra/#setup)Cấu hình

Sao chép cấu hình và thay `sk-...` bằng khóa của bạn từ trang quản lý tài khoản Ailoot. Nên lưu khóa trong biến môi trường `AILOOT_API_KEY`, nếu ứng dụng hỗ trợ.

Trước khi chạy, gọi GET /v1/models bằng khóa Ailoot của bạn. Chọn ID mô hình chính xác có các phương thức POST /v1/chat/completions, POST /v1/responses rồi dùng ID đó trong cấu hình. Với tác tử, hãy kiểm tra cả công cụ và tính năng mà phiên bản ứng dụng của bạn cần.

```js
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "Trả lời bằng tiếng Nga",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // chỉ dành cho mô hình có phương thức responses
  }
});
```

Cấu hình này đọc khóa từ biến `AILOOT_API_KEY`. Hãy đặt biến trước khi khởi động ứng dụng:

```bash
export AILOOT_API_KEY="sk-..."   # thêm vào ~/.zshrc hoặc ~/.bashrc
```

```powershell
setx AILOOT_API_KEY "sk-..."   # sau đó khởi động lại terminal
```

Mô hình ví dụ: `ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`. Chọn bất kỳ mô hình khác từ [danh mục](https://ailoot.ai/models/vi/) — kiểm tra xem mô hình đó có định dạng cần thiết hay không.

## [](https://ailoot.ai/docs/vi/integrations/mastra/#notes)Điều cần biết

Trong url, đặt địa chỉ cơ sở có /v1, không phải đường dẫn đầy đủ đến /chat/completions. Mặc định dùng Chat Completions; api: "responses" chuyển sang Responses API. Dạng id "nhà cung cấp/mô hình" gửi đến cổng kết nối id mô hình không kèm tiền tố. Tài liệu minh họa trường apiKey trong đối tượng model bằng ví dụ có tiêu đề; không mô tả riêng cách dùng cùng url.

## [](https://ailoot.ai/docs/vi/integrations/mastra/#check)Kiểm tra

- Với định dạng OpenAI, địa chỉ là `https://api.ailoot.ai/v1` (hoặc đường dẫn đầy đủ nếu ứng dụng yêu cầu địa chỉ đầy đủ).
- Đặt một câu hỏi ngắn. Nếu nhận được lỗi, hãy xem mã lỗi và Request ID rồi đối chiếu với trang [Lỗi và giới hạn](https://ailoot.ai/docs/vi/errors/).
- Lỗi 404 ngay sau khi cấu hình hầu như luôn là do địa chỉ sai: thừa hoặc thiếu `/v1`.
- 402 — số dư không đủ cho khoản giữ trước. Tác nhân giữ trước nhiều tiền hơn ứng dụng trò chuyện: [lý do](https://ailoot.ai/docs/vi/billing/reserve/).

Tài liệu của ứng dụng: [https://mastra.ai/models](https://mastra.ai/models)

Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.