AI và kho file
Khoảng 10 phút. Làm xong, app của bạn gợi ý câu trả lời bằng AI và lưu được file đính kèm, không cần API key nào.
manh.run giữ thông tin xác thực của các dịch vụ có sẵn. Code app chỉ import module; app không thấy key và không đọc được file của app khác. Các module này chỉ dùng trong file .ts (server). Email và Telegram có trang riêng: Gửi và nhận email, Bot Telegram.
Gọi AI
new OpenAI() từ manh/openai gọi giống SDK openai chính thức. Ghi tên model OpenAI quen thuộc, manh.run chuyển sang model mã nguồn mở gpt-oss.
import { OpenAI } from "manh/openai";
const openai = new OpenAI();
export async function suggestReply(ticket: { subject: string; body: string }) {
try {
const r = await openai.chat.completions.create({
model: "gpt-4o-mini",
messages: [
{ role: "system", content: "Bạn là nhân viên chăm sóc khách hàng. Trả lời ngắn, lịch sự, bằng tiếng Việt." },
{ role: "user", content: `${ticket.subject}\n\n${ticket.body}` },
],
max_tokens: 400,
});
return r.choices[0].message.content || null; // nội dung rỗng = thất bại
} catch {
return null; // tính năng vẫn dùng được khi AI lỗi
}
}gpt-4o-mini,gpt-4.1-mini,gpt-5-minidùng model nhanh; têngpt-*khác (nhưgpt-4o) dùng model suy luận mạnh hơn. Tên model khác bị từ chối.- Có chat (kể cả stream và
tools) và embeddings (text-embedding-*, đọc được tiếng Việt).max_tokenstối đa 4096. - Không có tạo ảnh, giọng nói, đọc ảnh. Đừng làm tính năng dựa trên chúng.
Lưu và chia sẻ file
Mỗi app có một thư mục riêng trong kho file. Khoá là đường dẫn tương đối, không có / đầu và không có ...
import { blob } from "manh/blob";
// trong một hàm async của repository; `bytes` là nội dung file
await blob.set("invoices/42.pdf", bytes, { contentType: "application/pdf" });
const res = await blob.get("invoices/42.pdf"); // Response
const files = await blob.list("invoices/"); // mọi file dưới tiền tố
await blob.delete("invoices/42.pdf");
blob.getUrl("public/products/ao-thun.jpg"); // link công khai cố định
await blob.presignGet("contracts/7.pdf", { expiresIn: 3600 }); // link ký có hạnCông khai hay riêng tư do khoá quyết định. File dưới public/ (ảnh sản phẩm, ảnh đại diện) có link cố định; mọi file khác chỉ mở được qua link ký có hạn. Lưu khoá vào bản ghi, tạo link khi trả về.
Cho trình duyệt tải file lên
Server cấp một link tải lên đã ký bằng blob.presignPut(key). Trình duyệt gửi file thẳng tới kho, rồi gửi khoá kèm form.
import { z } from "@hono/zod-openapi";
import { blob } from "manh/blob";
export const schema = { body: z.object({ name: z.string().max(200), type: z.string() }) };
export default async (c, { body }) => {
const key = `uploads/${crypto.randomUUID()}-${body.name.replace(/[^\w.-]/g, "_")}`;
return { key, url: await blob.presignPut(key) };
};// trong hàm xử lý khi người dùng chọn `file`; `api` = useApiClient()
const { key, url } = await api.uploads.sign({ name: file.name, type: file.type });
await fetch(url, { method: "PUT", body: file }); // gửi tới kho file, không qua API của appCần biết
- Số token AI mỗi tháng và dung lượng kho file tính theo gói. Xem Hạn mức theo gói.
- Một file gửi qua
blob.settối đa 100 MB. Kiểmfile.sizeở giao diện và ghi rõ giới hạn. blob.getUrltrên khoá không nằm dướipublic/sẽ ném lỗi.blob.head(key)trả kích thước, kiểu, ngày sửa, hoặcnull.- Chủ app xem và quản lý file ở tab File của project.
- Cần xuất PDF (phiếu, hoá đơn có tiếng Việt) thì dùng
manh/pdf, không dùngpdf-lib. - Cần dịch vụ ngoài có key riêng: xem Gọi API bên ngoài.
Bước tiếp theo
- Gửi và nhận email — gửi thư xác nhận đơn và nhận thư vào app.
- std/openai — mọi tuỳ chọn khi gọi AI.
- std/blob — mọi hàm của kho file.