Skip to Content

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.

app/tickets/repository.ts
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-mini dùng model nhanh; tên gpt-* 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_tokens tố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ó ...

app/invoices/repository.ts
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ạn

Cô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.

app/uploads/sign/post.ts
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) }; };
app/orders/attach.tsx
// 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 app

Cầ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.set tối đa 100 MB. Kiểm file.size ở giao diện và ghi rõ giới hạn.
  • blob.getUrl trên khoá không nằm dưới public/ sẽ ném lỗi. blob.head(key) trả kích thước, kiểu, ngày sửa, hoặc null.
  • 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ùng pdf-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

Cập nhật