هل تريد تجربة وكيل ذكاء اصطناعي دون تعقيد أطر العمل الضخمة؟ مشروع tosh (رابط المستودع: tosh/6e91a9dbf08dd630c535e7345ac7f0b5) يقدم وكيلاً حقيقياً في 9 أسطر بايثون فقط. المشكلة أن README غير واضح وقد يحتوي على أخطاء (مثل نموذج GPT-5.6 الوهمي). هذا المقال يقدم دليلاً عربياً عملياً لتشغيل المشروع وتعديله، مع أمثلة حقيقية وحلول للأخطاء الشائعة.

ما هو وكيل AI في 9 أسطر؟

المشروع عبارة عن ملف بايثون واحد اسمه agent.py، يحتوي على 9 أسطر فقط (بدون احتساب الاستيرادات). يستخدم نموذج GPT-4o (افتراضي) مع أدوات بسيطة: تنفيذ أوامر شل وجلب محتوى URL. الفكرة: وكيل حقيقي باستدعاء أدوات، بدون إطار عمل ضخم.

المتطلبات الأساسية

• بايثون 3.8+
• مفتاح API من OpenAI (نموذج GPT-4o أو GPT-3.5-turbo)
• اتصال إنترنت
• المكتبات: openai, requests, python-dotenv

التثبيت خطوة بخطوة

1. استنسخ المستودع: git clone https://github.com/tosh/6e91a9dbf08dd630c535e7345ac7f0b5.git
2. انتقل إلى المجلد: cd 6e91a9dbf08dd630c535e7345ac7f0b5
3. ثبت المكتبات: pip install openai requests python-dotenv
4. أنشئ ملف .env وأضف: OPENAI_API_KEY=sk-... (مفتاحك)
5. شغّل الوكيل: python agent.py 'ما هو الطقس في الرياض؟'

شرح الكود الأساسي (الأسطر التسعة)

الكود الأساسي في agent.py (بعد الاستيرادات):

import openai, os, requests, json

openai.api_key = os.getenv('OPENAI_API_KEY')

def run_command(command):
    return os.popen(command).read()

def fetch_url(url):
    return requests.get(url).text

tools = [{'type': 'function', 'function': {'name': 'run_command', 'parameters': {'command': {'type': 'string'}}}}, {'type': 'function', 'function': {'name': 'fetch_url', 'parameters': {'url': {'type': 'string'}}}}]

response = openai.ChatCompletion.create(model='gpt-4o', messages=[{'role': 'user', 'content': 'ما هو الطقس في الرياض؟'}], tools=tools)

print(response.choices[0].message)

هذا الكود يعرّف أداتين: run_command لتنفيذ أوامر شل، وfetch_url لجلب URLs. ثم يرسل استعلاماً للنموذج مع هذه الأدوات.

كيفية تغيير النموذج والأدوات

لتغيير النموذج، عدّل قيمة model في استدعاء openai.ChatCompletion.create إلى 'gpt-3.5-turbo' أو أي نموذج مدعوم. لإضافة أداة جديدة، أضف دالة جديدة وأضف تعريفها في قائمة tools.

أخطاء شائعة وحلولها

مقارنة مع مشاريع مشابهة

• LangChain: إطار عمل كامل، معقد لكن قوي. مناسب للإنتاج. tosh أبسط بكثير لكنه محدود.
• AutoGPT: وكيل مستقل، لكنه ثقيل ويتطلب موارد. tosh أخف وزناً.
• Superagent: أداة SaaS لبناء وكلاء، سهلة لكنها مدفوعة. tosh مجاني ومفتوح المصدر.

أسئلة شائعة

هل أحتاج خبرة كبيرة في بايثون؟

لا، مستوى متوسط يكفي. تحتاج معرفة أساسية بالمتغيرات والدوال.

هل يعمل على ويندوز؟

نعم، مع بايثون مثبت. قد تحتاج لتعديل أمر run_command لاستخدام subprocess بدلاً من os.popen.

هل يمكن استخدامه تجارياً؟

نظرياً نعم، لكن غير موصى به بسبب محدوديته وعدم استقراره.

كيف أغير النموذج؟

عدّل قيمة model في الكود إلى أي نموذج مدعوم من OpenAI.

هل يدعم نماذج مجانية؟

يدعم نماذج OpenAI فقط، والتي تتطلب اشتراكاً. لا يدعم نماذج مجانية مثل Llama.