AI Connect / مطورو أدوات الذكاء الاصطناعي

إنشاء أدوات JavaScript

ثبّت SDK واكتب أدواتك واختبرها، ثم ابنِ الحزمة وانشرها.

أنشئ أداة ذكاء اصطناعي بلغة JavaScript وانشرها في ست خطوات. لا تحتاج إلى حساب سحابي حتى ترفع ZIP.

1. التثبيت

ثبّت Node.js بالإصدار 22 أو أحدث؛ يتضمن npm. تحقق من الطرفية:

node --version
npm --version

يثبّت مولّد المشروع في الخطوة 2 الحزمة @syraio/ai-connect ضمن اعتماديات المشروع. لا تحتاج إلى تثبيتها على مستوى النظام.

2. إنشاء المشروع

npm create @syraio/ai-connect@latest my-js-tools
cd my-js-tools
npm install

ستجد src/tool.js وtool.json وREADME.md وpreview.mjs وpackage.json. تتولى أوامر npm المولّدة بناء الشفرة وإنشاء الحزمة.

3. كتابة الأدوات

استبدل محتوى src/tool.js بهذا المثال:

import { createAiTools } from '@syraio/ai-connect';

const myTools = createAiTools({ name: 'my-js-tools', version: '0.1.0' });

myTools.add_tool('hello', 'Return a greeting.', () => {
  return 'Hello from AI Connect!';
});

export default myTools;

يضيف هذا المثال أداة hello دون معاملات وتُرجع رسالة ترحيب.

مثال آخر: استخدام معامل

أضف ما يلي قبل export default myTools في الملف نفسه:

myTools.add_tool(
  'greet',
  'Greet someone by name.',
  ({ name }) => `Hello, ${name}!`,
  {
    type: 'object',
    properties: { name: { type: 'string', minLength: 1 } },
    required: ['name'],
    additionalProperties: false,
  },
);

تستقبل greet المعامل الإلزامي name. مثلاً تُرجع { "name": "Ada" } النتيجة Hello, Ada!.

مثال عملي: جمع رقمين

أضف أداة add لحساب مجموع رقمين. يستدعي عميل الذكاء الاصطناعي شفرتك بالقيم المطلوبة ويستخدم النتيجة في رده.

ضع هذا المثال قبل export default myTools.

myTools.add_tool(
  'add',
  'Add two numbers.',
  ({ a, b }) => ({ sum: a + b }),
  {
    type: 'object',
    properties: { a: { type: 'number' }, b: { type: 'number' } },
    required: ['a', 'b'],
    additionalProperties: false,
  },
);

مثلاً يرسل العميل { "a": 20, "b": 22 }، وتُرجع أداتك { "sum": 42 }. يمكنك استخدام الفكرة نفسها لتنفيذ حسابات خاصة بعملك أو قراءة بيانات من نظامك.

4. تجربة الأمثلة

من مجلد المشروع، ابنِ الشفرة وشغّل المعاينة:

npm run build
npm start

تعرض المعاينة أدواتك وتستدعي hello. يجب أن ترى Hello from AI Connect!.

إذا أضفت greet، أضف هذا السطر إلى preview.mjs لتجربتها:

console.log(await myTools.callTool('greet', { name: 'Ada' }));

يجب أن تتضمن النتيجة Hello, Ada!.

تجربة أداة الجمع

أضف هذا السطر إلى preview.mjs:

console.log(await myTools.callTool('add', { a: 20, b: 22 }));

أعد تنفيذ npm run build ثم npm start.

يجب أن تحتوي النتيجة على:

{ "sum": 42 }

5. بناء ZIP

حدّث README.md بوظيفة الأداة وتعليمات الإعداد ومتطلبات التشغيل؛ سيظهر هذا الملف في صفحة أداتك العامة.

راجع tool.json: استخدم id ثابتاً وفريداً، وحدد name وdescription، وأبقِ إصدار الأداة 0.1.0 لهذا الإصدار الأول. إصدار SDK مستقل عن إصدار أداتك.

من داخل my-js-tools:

npm run package

الناتج هو my-js-tools.zip. يحتوي على tool.json وREADME.md والشفرة المبنية داخل dist/، ونقطة الدخول هي dist/tool.mjs. يحتاج المستخدم إلى Node.js 22 أو أحدث، ولا يحتاج إلى ملفات مصدرك أو node_modules.

6. الرفع والنشر

  1. أنشئ حساباً سحابياً أو سجّل الدخول.
  2. افتح بوابة المطور.
  3. اختر Upload AI Tool ZIP وحدد my-js-tools.zip.
  4. انتظر المعالجة ثم افتح القائمة الجديدة. تبدأ القوائم بحالة Private draft، أي مسودة خاصة.
  5. راجع الاسم والوصف والإصدار وREADME، واحفظ أي تعديل على بيانات القائمة.
  6. اختر Publish وأكّد النشر. ابحث عن أداتك في المتجر العام، وافتح صفحتها وتحقق من README وتنزيل ZIP.

ارفع حزمة الأداة ZIP، وليس ملف SDK بصيغة .whl أو حزمة npm بصيغة .tgz. إذا استخدم مطور آخر معرّف أداتك، اختر معرّفاً فريداً في tool.json وأعد البناء قبل الرفع.

للتحديثات، احتفظ بالمعرّف وزد رقم الإصدار في tool.json وتعريف خدمتك، وحدّث package.json أيضاً لمشاريع JavaScript. أعد البناء وارفع ZIP الجديد. لا يمكن استبدال إصدار موجود. يصبح الإصدار الجديد عاماً فور رفعه إلى قائمة منشورة مسبقاً.

يتابع المستخدم الخطوة 7 لتثبيت الأداة، ثم الخطوة 8 لربط عميل الذكاء الاصطناعي. لا يحتاج إلى حساب سحابي لتصفح إصدارك العام أو تنزيله أو استخدامه.

استخدام الجمع من عميل ذكاء اصطناعي

بعد تثبيت الحزمة وتفعيلها وربط العميل باتباع دليل المستخدم، اطلب:

استخدم my-js-tools__add لحساب 20 + 22 واعرض النتيجة.

يجب أن يستدعي العميل أداتك بالقيم a: 20 وb: 22 ثم يعرض 42. هنا ينفّذ AI Connect شفرتك على جهازك ويعيد نتيجتها إلى العميل.