Actionpackd AI SDK: Phép màu AI chỉ với 2 dòng mã

AI đang ở khắp mọi nơi — nhưng nếu bạn đã từng cố gắng xây dựng một ứng dụng AI, bạn sẽ hiểu được nỗi đau:

• Đầu ra gần như là JSON nhưng lại làm hỏng bộ phân tích của bạn.
• Các prompt được sao chép và dán rải rác khắp nơi.
• Việc đổi nhà cung cấp đồng nghĩa với việc viết lại toàn bộ ứng dụng của bạn.
• Các bản demo trông rất ấn tượng trên Twitter nhưng lại gặp lỗi trong môi trường sản xuất.

Chúng tôi đã xây dựng Actionpackd AI SDK để khắc phục điều này. Nó nhỏ gọn, dựa trên schema và thân thiện với lập trình viên — được thiết kế để làm cho việc xây dựng các ứng dụng AI trở nên thú vị trở lại.

🚀 Actionpackd AI SDK là gì?

Actionpackd AI SDK là một bộ công cụ mã nguồn mở để làm việc với các mô hình ngôn ngữ lớn (LLMs). Nó cung cấp cho bạn:

• serverCompose → các cuộc gọi AI an toàn, được xác thực theo schema (tạm biệt việc phân tích JSON dễ vỡ).
• useCompose → truyền token vào giao diện người dùng của bạn, với các sự kiện có cấu trúc giữa dòng chảy.
• flowBuilder → tổ chức các quy trình nhiều bước với khả năng thử lại và đầu ra có kiểu dữ liệu.
• Bao gồm các mô hình giả lập → demo ngay lập tức, không cần khóa API.

👉 Và điều tuyệt vời nhất: bạn có thể bắt đầu chỉ với 2 dòng mã.

⚡ Hướng dẫn nhanh (2 dòng để tạo phép màu)

Cài đặt:

npm install @actionpackd/sdk-core zod

Sử dụng nó:

import { createProvider, serverCompose } from '@actionpackd/sdk-core';
import { z } from 'zod';

const openai = createProvider({ id: 'openai', apiKey: process.env.OPENAI_KEY });

const ProductSchema = z.object({ title: z.string(), bullets: z.array(z.string()) });

const product = await serverCompose({
  provider: openai,
  prompt: 'Write product JSON for {{name}}',
  inputs: { name: 'Cord Jacket' },
  schema: ProductSchema
});

console.log(product.title); // ✅ đã xác thực, có kiểu dữ liệu

Không có phân tích dễ vỡ, không có thủ thuật — chỉ có JSON có kiểu dữ liệu, có thể streaming nếu bạn muốn.

🎨 Demo Streaming (Giao diện trong 5 dòng)

'use client';
import { useCompose } from '@actionpackd/sdk-core';

export default function Demo() {
  const { stream } = useCompose({ provider: openai, prompt: 'Tell a story about lighthouses' });
  return <div>{[...stream]}</div>;
}

Vậy là xong. Bạn đã có streaming token theo từng token trong thành phần React của mình.

🔄 Quy trình nhiều bước

Khi logic ứng dụng của bạn cần nhiều hơn một bước AI:

import { flowBuilder } from '@actionpackd/sdk-core';

const flow = flowBuilder()
  .step('extract', { prompt: 'Extract bullets from {{text}}', schema: BulletsSchema })
  .step('rewrite', { prompt: 'Write ad copy for {{extract.bullets}}', schema: CopySchema });

const result = await flow.run({ provider: openai, inputs: { text: 'Long product description...' } });

console.log(result.rewrite.copy);

Các quy trình là đối tượng hàng đầu ở đây — bao gồm khả năng thử lại và xác thực.

🎯 Tại sao chọn Actionpackd?

So với các SDK khác, Actionpackd:

• Dựa trên schema → mọi đầu ra đều có kiểu dữ liệu và đã được xác thực.
• Không phụ thuộc nhà cung cấp → OpenAI, Anthropic, Gemini, hoặc các mô hình giả lập.
• Thân thiện với demo → chạy mà không cần khóa API trong chưa đầy một phút.
• An toàn theo mặc định → an toàn cho việc chèn, xóa thông tin cá nhân, và thu thập telemetry tùy chọn.

Hãy nghĩ về nó giống như TypeScript cho các đầu ra AI: một chút khó khăn ban đầu, nhưng ít đau khổ hơn sau này.

🌍 Mã nguồn mở, Xây dựng cùng nhau

Đây là đóng góp của chúng tôi cho cộng đồng mã nguồn mở. SDK đã có trên npm và GitHub:

• 📦 npm: @actionpackd/sdk-core
• 💻 GitHub: Actionpackd AI SDK

Chúng tôi rất mong nhận được phản hồi, ý tưởng và đóng góp của bạn — cho dù đó là sửa lỗi, cải thiện tài liệu hay một trình điều hợp nhà cung cấp mới.

✨ Kết luận

Nếu bạn đã từng thất vọng bởi việc phân tích JSON dễ vỡ hoặc các bản demo AI cồng kềnh, hãy thử Actionpackd.
Nó là 2 dòng để tạo phép màu AI có kiểu dữ liệu, streaming — và chúng tôi không thể chờ đợi để xem bạn sẽ xây dựng những gì.