الإصدار Alpha من IaGenify SDK: عميل واحد أينما تعمل شيفرتك.

بدأت حزمة IaGenify SDK كغلاف HTTP صغير حول واجهتنا. وفي إصدارها Alpha أصبحت الأداة التي نبني بها منتجاتنا: عميل JavaScript واحد يعمل على Node.js والمتصفح وCloudflare Workers ويخفي المصادقة والجلسات وضوابط الفوترة خلف واجهة كائنية صغيرة.

هذا ليس دليلاً مرجعياً، بل جولة في الأفكار التي نعتمدها والصياغة التي ستكتبها فعلاً واتجاه الحزمة مستقبلاً.

عميل واحد أينما تعمل شيفرتك

يكتشف العميل بيئة التشغيل عند البدء ويدير المصادقة والجلسات وضوابط الفوترة كي يركز تطبيقك على مهمته.

import { IaGenify } from "iagenify";

const api = new IaGenify({
  apiKey: process.env.IAGENIFY_API_KEY,
  appName: "release-notes-bot",
});

في Node.js تُحفظ الجلسة في ملف خاص تحت ~/.iagenify/، وفي المتصفح في localStorage، وعلى edge تبقى في الذاكرة. يُستبدل مفتاح API برمز قصير العمر يتجدد بصمت، وتُحمّل وحدات Node.js عند الحاجة كي لا تتعطل عمليات webpack أو Vite أو Gatsby.

المساعدون جلسات، لا prompts

بدلاً من إعادة بناء prompt لكل طلب، تنشئ جلسة واحدة تضم النموذج والدور والتعليمات وJSON Schema اختيارياً والذاكرة. بعدها يستخدم generate() مدخلات ومخرجات معرّفة النوع للنص والصور والصوت والفيديو والمستندات.

const assistant = await api.models.create({ model: "gemini-3.5-flash", settings: { role: "Senior release engineer", instructions: "Answer in three short bullet points." }, schema: { type: "object", properties: { summary: { type: "string" } } }, memory: true });
const first = await assistant.generate({ inputs: [{ type: "text", content: "Summarise the changes shipped in v2.4.0." }] });
const followUp = await assistant.generate({ inputs: [{ type: "text", content: "Which risk should we fix first?" }] });

ينشر الخادم قائمة أسعاره وتقرأها api.catalogue()، فيعرض التطبيق التكلفة من دون نسخ جدول قد يتقادم.

وكيل بميزانية واضحة

يجب ألا يتحول عمل الوكيل إلى تكلفة مفتوحة. تحمل كل عملية الميزانية التي تحددها وسجلاً للأدوات والقرارات والنتائج.

يتكون الوكيل من جلسات نماذج وأدوات للبحث وقراءة الصفحات واللقطات وتحويل المستندات وتوليد الوسائط. تحد maxSteps الحلقة وتحد budget الأرصدة، وتُفحص الميزانية قبل كل أداة وفق تكاليف مقاسة فعلياً.

const agent = api.agents.create({ model: { main, image }, tools: { search: api.tools.search, openPage: api.tools.fetch, createImage: api.tools.image }, maxSteps: 8, budget: 100 });
const result = await agent.run({ inputs: [{ type: "text", content: "Find the latest Node.js LTS release and draw a cover image for it." }] });

تحافظ الأخطاء على نوعها أثناء البث، لذلك تعمل instanceof NotEnoughCredits بالطريقة نفسها في الطلب البسيط والتشغيل الطويل.

المخرجات المنظمة هي المسار الطبيعي

تحتاج التطبيقات إلى بيانات موثوقة لا فقرة يجب تحليلها. يجعل SDK النتائج المنظمة والأخطاء المعرّفة المسار الطبيعي في المتصفح وworker والخادم.

هذا إصدار Alpha. نبقي الواجهة صغيرة عمداً بينما نتعلم من تطبيقات حقيقية ونثبت الأجزاء التي ستدوم.

الحزمة بداية تجربة المطور وليست بديلاً عنها. ستنمو الوثائق وموقع المطورين حول الأجزاء التي تثبت فائدتها.

ما الذي يأتي لاحقاً

يعد إصدار Alpha باتجاه لا بمواعيد: تكاملات تفهم الأطر، تغذية مباشرة، تخزين يصبح ذاكرة للوكلاء، ونماذج خاصة بنا عبر استدعاء models.create() نفسه.

نشارك الإصدار مع فرق الوصول المبكر بينما تستقر الواجهة وقد تتغير بعض الأسماء. تواصل معنا وتابع وثائق IaGenify المتنامية.