أنشئ أول وكيل ذكاء اصطناعي

في الدرسين السابقين اخترنا نموذجًا محليًّا، وثبّتنا Ollama، وقمنا بتحميل النموذج qwen2.5:0.5b.

في هذا الدرس نكتب أول ملف Python يرسل رسالة إلى النموذج ويعرض ردّه. هذه أول لبنة في الوكيل، ونتوقف عند أول رد كي نفهم كل سطر.

ما الذي نبنيه؟

ملف واحد اسمه agent.py. يفعل ثلاثة أشياء:

1. يجهّز قائمة رسائل: قواعد، ثم رسالتك.
2. يرسلها إلى Ollama، فيمررها إلى النموذج.
3. يستلم الرد ويعرضه.

وسنبني وكيل ملاحظات: هو مساعد يحفظ ما تقوله له. وفي هذا الدرس نرسل إليه أول ملاحظة فقط. وسنرى في الدروس القادمة لماذا لا يكفي هذا الملف، وكيف نجعله يتذكر.

ما تحتاج إليه قبل أن تبدأ

• Python 3 على جهازك. تأكد منه بالأمر python3 --version، فيجب أن يظهر رقم الإصدار.
• Ollama يعمل، والنموذج qwen2.5:0.5b منزَّل. تأكد منه بالأمر ollama list. إن لم تفعل ذلك بعد، فراجع درس تثبيت Ollama.
• محرر نصوص تكتب فيه الملف. في الطرفية يكفي nano. يمكنك استخدام أي محرر من اختيارك.

ولا نحتاج إلى تثبيت أي حزمة. نستخدم أدوات Python المدمجة فقط.

ثم أنشئ مجلدًا للمشروع، لاحظ يمكنك استخدام أدواتك لإنشاء المجلدات، أنا سأقوم بالتطبيق عبر طرفية لينكس:

mkdir ~/my-first-agent
cd ~/my-first-agent

وافتح الملف الجديد:

nano agent.py

nano محرر نصوص بسيط يعمل داخل الطرفية. وagent.py اسم الملف، فإن لم يكن موجودًا أنشأه nano لك.

إن كنتَ تستخدم Windows أو VS Code

لا تحتاج إلى الأوامر السابقة، ولكل أمر منها ما يقابله:

1. أنشئ المجلد بالطريقة المعتادة: في مستكشف الملفات اضغط بزر الفأرة الأيمن، ثم «جديد»، ثم «مجلد»، وسمّه my-first-agent.
2. افتحه في VS Code: من القائمة File اختر Open Folder، ثم اختر المجلد.
3. أنشئ الملف: في لوحة Explorer على اليسار اضغط أيقونة New File، واكتب اسمه agent.py.
4. اكتب الشيفرة في الملف، واحفظه بالضغط على Ctrl+S.
5. افتح الطرفية: من القائمة Terminal اختر New Terminal. وتفتح الطرفية داخل المجلد نفسه، فلا تحتاج إلى cd.

ولم أجرّب هذه الخطوات على Windows، وهي مأخوذة من الاستخدام المعتاد لـ VS Code.

الملف سطرًا سطرًا

نبني الملف على خمس قطع. اكتب كل قطعة تحت التي قبلها.

القطعة الأولى: الأدوات الجاهزة

import json
import urllib.request

القطعة الثانية: الإعدادات

URL = "http://localhost:11434/v1/chat/completions"
MODEL = "qwen2.5:0.5b"

القطعة الثالثة: قائمة الرسائل

messages = [
    {"role": "system", "content": "You are a note keeper, Answer briefly"},
    {"role": "user", "content": "Remember: my meeting is on sunday at 10"},
]

هذه هي القائمة التي سيقرؤها النموذج.

الأدوار ثابتة تقريبًا: الأدوار الأساسية ثلاثة: system وuser وassistant، وتضيف بعض الواجهات أدوارًا أخرى مثل tool. ولا نخترع دورًا جديدًا من عقلنا، لأن النموذج دُرّب على هذه الأسماء.

المحتوى يختلف: في content نكتب ما نشاء. فنغيّر القواعد في رسالة system، ونغيّر السؤال في رسالة user، متى أردنا، ويبقى الدور كما هو.

وهنا قاعدتان: «You are a note keeper» أي أنت تحفظ الملاحظات، و«Answer briefly» أي أجب باختصار. ورسالتك: «تذكّر أن اجتماعي يوم الأحد في العاشرة».

القطعة الرابعة: الدالة التي تسأل النموذج

def ask_model(messages):
    body = json.dumps({"model": MODEL, "messages": messages}).encode()
    request = urllib.request.Request(URL, body, {"Content-Type": "application/json"})
    with urllib.request.urlopen(request) as response:
        data = json.load(response)
        return data["choices"][0]["message"]["content"]

نضع كود السؤال في دالة، لنستطيع أن نستدعيها مرات كثيرة لاحقًا. والأسطر التي تحت def مزاحة بأربع مسافات، وهذا يعني أنها داخل الدالة.

والسطر الأخير يسير في الرد هكذا:

data
 └─ "choices"
     └─ [0]
         └─ "message"
             └─ "content"

• "choices": قائمة الإجابات الممكنة.
• [0]: أول إجابة فيها.
• "message": رسالة الرد، ودورها assistant.
• "content": النص الذي نريده.

وهو المسار الذي رأيناه في ناتج curl حين جرّبنا النموذج يدويًّا.

القطعة الخامسة: التشغيل

reply = ask_model(messages)
print(reply)

وهذان السطران في أقصى اليسار بلا إزاحة، لأنهما خارج الدالة.

الملف كاملًا

import json
import urllib.request

URL = "http://localhost:11434/v1/chat/completions"
MODEL = "qwen2.5:0.5b"

messages = [
    {"role": "system", "content": "You are a note keeper, Answer briefly"},
    {"role": "user", "content": "Remember: my meeting is on sunday at 10"},
]


def ask_model(messages):
    body = json.dumps({"model": MODEL, "messages": messages}).encode()
    request = urllib.request.Request(URL, body, {"Content-Type": "application/json"})
    with urllib.request.urlopen(request) as response:
        data = json.load(response)
        return data["choices"][0]["message"]["content"]


reply = ask_model(messages)
print(reply)

احفظ الملف.

شغّله واقرأ الرد

في الطرفية، داخل مجلد المشروع:

python3 agent.py

وفي Windows اكتب python agent.py، فإن لم يعمل فاكتب py agent.py.

قد يتأخر أول رد بضع ثوانٍ، لأن النموذج يُحمَّل في الذاكرة. فإن صار الجهاز بطيئًا، فاضغط Ctrl+C لإيقاف الملف.

$ python3 agent.py
the meeting on Sunday at 10:00 am?

هذا هو أول رد: النموذج أعاد جملتي على هيئة سؤال. وهذا ليس رد جيد من وكيل ملاحظات، فالمفروض أن يقول «حسنًا، سجّلتُ». السبب أن qwen2.5:0.5b أصغر أحجام Qwen2.5، فهو يخطئ أحيانًا في فهم التعليمات. وهو أخف على جهازك، وهذا ما اخترناه.

وهناك شيء أهم: لا شيء حُفظ فعلًا. النموذج كتب نصًّا فقط، ولو سألته بعد قليل عن اجتماعك فلن يعرف. وسنرى هذا في الدرس القادم.

هل Python هي اللغة الوحيدة؟

لا. ما فعله ملفنا هو إرسال طلب ويب إلى Ollama وقراءة الرد. وأي لغة تستطيع ذلك، تصلح لإنشاء وكيل:

• JavaScript وPHP وغيرهما: كلٌّ منها يرسل طلب ويب.
• الأمر curl في الطرفية: استخدمناه في بداية المسار دون أي لغة برمجة.

اخترنا Python لأنها سهلة القراءة، وكل سطر فيها قصير. وإن كنتَ تعرف لغة أخرى، فأعد كتابة الملف بها بالخطوات نفسها.