AI for Developers Tutorial پروژه عملی پایان دوره پروژه عملی سطح: سخت

پروژه پایانی — دستیار پرسش‌وپاسخ برای سایت خودتان

پروژه پایانی دوره: یک ویجت پرسش‌وپاسخ AI برای سایت (مثلاً «از این دوره سؤال بپرس») که سؤال کاربر را به مدل می‌فرستد، با زمینه از محتوای سایت پاسخ می‌دهد، جریان دارد، خطا و هزینه را مدیریت می‌کند و خروجی را امن رندر می‌کند — تمرین کامل ساخت محصول با AI.

راه‌حل قدم‌به‌قدم پروژه

  1. ۱

    هدف پروژه

    ساخت ویجت پرسش‌وپاسخ با API مدل، streaming، مدیریت خطا، محدودیت نرخ و رندر امن پاسخ.

  2. ۲

    الزامات و موارد موردنیاز

    Node.js یا PHP برای endpoint سمت سرور (کلید API هرگز در فرانت!)؛ آشنایی با fetch و streaming.

  3. ۳

    قدم ۱ — endpoint سمت سرور

    POST /api/ask که سؤال را می‌گیرد، با system prompt ثابت («دستیار آموزشی سایت؛ فقط از محتوای دوره‌ها جواب بده؛ اگر نمی‌دانی صادقانه بگو») و تاریخ کوتاه گفتگو، مدل را صدا می‌زند و پاسخ جریانی به کلاینت می‌فرستد. کلید مدل در .env.

  4. ۴

    قدم ۲ — زمینه از محتوا

    عنوان‌های درس‌های دوره (یا خلاصه هر درس) را در system prompt بگنجانید تا پاسخ بر پایه محتوای شما باشد. برای سایت بزرگ، بازیابی ساده با جستجوی کلیدواژه روی درس‌ها و فرستادن ۳ نتیجه مرتبط.

  5. ۵

    قدم ۳ — فرانت و streaming

    ویجت با input و ناحیه پاسخ؛ fetch با ReadableStream و append تدریجی متن؛ اسکرول خودکار. حالت‌های loading و error با پیام فارسی و دکمه تلاش دوباره.

  6. ۶

    قدم ۴ — امنیت و محدودیت

    خروجی مدل را به‌صورت textContent رندر کنید (ضد XSS)؛ rate limit روی /api/ask (مثلاً ۱۰ در دقیقه هر IP) با 429؛ سقف طول سؤال و پاسخ؛ لاگ توکن مصرفی برای هزینه.

  7. ۷

    قدم ۵ — تست و بهبود پرامپت

    ۱۰ سؤال واقعی بپرسید؛ پاسخ‌های بد را پیدا کنید و system prompt را بهبود دهید (مثال‌های Few-shot از پاسخ‌های خوب). این چرخه بهبود پرامپت، بخش اصلی نگهداری محصول AI است.

نکات مهم

  • ◆ قبل از خواندن راه‌حل، خودتان حداقل ۳۰ دقیقه تلاش کنید؛ یادگیری واقعی در همین تلاش اتفاق می‌افتد.
  • ◆ راه‌حل را بعد از دیدن، عمداً تغییر دهید و دوباره اجرا کنید تا با هر خط آن آشنا شوید.
  • ◆ اگر جایی گیر کردید، فقط بخش مشکل را جستجو کنید، نه کل پروژه را — دامنه جستجوی کوچک یادگیری را عمیق‌تر می‌کند.

کد کامل راه‌حل پروژه

// server.js (Node/Express)
const express = require("express");
const rateLimit = require("express-rate-limit");
const app = express();
app.use(express.json());

app.use("/api/ask", rateLimit({ windowMs: 60_000, max: 10 }));

const SYSTEM = `تو دستیار آموزشی سایت رادیکال وردپرس هستی.
فقط بر اساس محتوای دوره‌های زیر جواب بده؛ خارج از آن صادقانه بگو بلد نیستی.
پاسخ‌ها کوتاه (حداکثر ۸ سطر) و فارسی.
محتوای مرجع:
${courseSummaries}`;

app.post("/api/ask", async (req, res) => {
  const question = String(req.body?.question || "").trim();
  if (question.length < 3 || question.length > 500) {
    return res.status(422).json({ error: "سؤال باید بین ۳ تا ۵۰۰ نویسه باشد" });
  }

  res.setHeader("Content-Type", "text/plain; charset=utf-8");
  try {
    const upstream = await fetch("https://api.example-llm.com/v1/chat", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${process.env.LLM_KEY}`,   // کلید فقط سرور
      },
      body: JSON.stringify({
        model: "glm-4",
        temperature: 0.3,
        messages: [
          { role: "system", content: SYSTEM },
          { role: "user", content: question },
        ],
        stream: true,
      }),
    });
    if (!upstream.ok) throw new Error("upstream " + upstream.status);

    // جریان را مستقیم به کلاینت می‌ریزیم
    upstream.body.pipe(res);
  } catch (e) {
    if (!res.headersSent) res.status(502).json({ error: "سرویس AI موقتاً در دسترس نیست" });
  }
});

app.listen(3000);

// widget.js — فرانت
const box = document.querySelector("#ai-answer");
askForm.addEventListener("submit", async (e) => {
  e.preventDefault();
  const q = input.value.trim();
  if (!q) return;
  box.textContent = "در حال پاسخ…";
  try {
    const res = await fetch("/api/ask", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ question: q }),
    });
    if (!res.ok) throw new Error();
    box.textContent = "";
    const reader = res.body.getReader();
    const dec = new TextDecoder();
    for (;;) {
      const { done, value } = await reader.read();
      if (done) break;
      box.textContent += dec.decode(value);   // textContent = ضد XSS
      box.scrollTop = box.scrollHeight;
    }
  } catch {
    box.textContent = "پاسخ ناموفق بود — چند لحظه بعد دوباره تلاش کنید.";
  }
});

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

خروجی مورد انتظار

نتایج مورد انتظار:
  سؤال «چطور در CSS فلکس وسط‌چین می‌کنم؟» پاسخ جریانی از محتوای دوره CSS می‌گیرد.
  سؤال خارج از محتوا (مثلاً پرسش سیاسی) پاسخ «خارج از تخصص من است» می‌گیرد.
  بعد از ۱۰ سؤال در دقیقه پاسخ 429 با پیام فارسی.
  تلاش تزریق <script> در سؤال فقط به‌صورت متن نمایش داده می‌شود.

چالش اضافه (اختیاری)

حافظه گفتگو اضافه کنید: آخرین ۴ پیام را در system prompt بفرستید و دکمه «شروع تازه» بگذارید.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.