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

إنشاء أدوات Python

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

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

1. التثبيت

ثبّت Python بالإصدار 3.11 أو أحدث، ثم ثبّت SDK:

python -m pip install syraio-ai-connect

اسم الحزمة هو syraio-ai-connect، ويُستخدم الاسم ai_connect عند الاستيراد في الشفرة.

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

أنشئ مشروعك وافتح مجلده:

python -m ai_connect create my-python-tools
cd my-python-tools

اكتب شفرتك في src/tool.py. يتضمن المشروع أيضاً tool.json وREADME.md وrequirements.txt.

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

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

from ai_connect import create_ai_tools

myTools = create_ai_tools(name="my-python-tools", version="0.1.0")

myTools.add_tool("hello", "Return a greeting.", lambda args: "Hello from AI Connect!")

if __name__ == "__main__":
    myTools.run()

يضيف هذا المثال أداة hello دون معاملات وتُرجع رسالة ترحيب. أبقِ الكتلة الأخيرة if __name__ == "__main__" لكي يتمكن AI Connect من تشغيل أداتك.

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

أضف ما يلي فوق الكتلة if __name__ == "__main__":

myTools.add_tool(
    "greet",
    "Greet someone by name.",
    lambda args: f"Hello, {args['name']}!",
    {
        "type": "object",
        "properties": {"name": {"type": "string", "minLength": 1}},
        "required": ["name"],
        "additionalProperties": False,
    },
)

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

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

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

ضع هذا المثال فوق الكتلة if __name__ == "__main__".

myTools.add_tool(
    "add",
    "Add two numbers.",
    lambda args: {"sum": args["a"] + args["b"]},
    {
        "type": "object",
        "properties": {"a": {"type": "number"}, "b": {"type": "number"}},
        "required": ["a", "b"],
        "additionalProperties": False,
    },
)

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

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

أنشئ preview.py بجانب tool.json:

import asyncio
import runpy

myTools = runpy.run_path("src/tool.py")["myTools"]
result = asyncio.run(myTools.call_tool("hello"))
print(result["content"][0]["text"])

شغّله من مجلد المشروع:

python preview.py

يجب أن ترى Hello from AI Connect!.

إذا أضفت greet، استبدل سطر call_tool بالتالي لتجربتها:

result = asyncio.run(myTools.call_tool("greet", {"name": "Ada"}))

شغّل python preview.py مجدداً. يجب أن ترى Hello, Ada!.

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

في preview.py، استبدل سطر call_tool بالتالي:

result = asyncio.run(myTools.call_tool("add", {"a": 20, "b": 22}))

شغّل python preview.py.

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

{ "sum": 42 }

5. بناء ZIP

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

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

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

python -m ai_connect package

الناتج هو my-python-tools.zip. يتضمن tool.json وREADME.md وملف التشغيل المولّد dist/main.py ومصدرك واعتماديات Python.

ابنِ حزمة Python على نظام التشغيل والمعمارية والإصدار الفرعي المستهدف من Python. مثلاً تحتاج حزمة Windows x64 / Python 3.13 إلى البيئة نفسها لدى المستخدم. دوّن هدف البناء الذي تطبعه الأداة في README. لا يثبّت المستخدم حزمة SDK بواسطة pip.

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

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

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

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

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

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

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

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

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