أنشئ وكيل AI الأول لك مع الوصول الآمن إلى API
وكيل عامل في 7 دقائق بدون خدمات مدفوعة - فقط كود محلي و API مجاني
- 1.ثبت Node.js (إذا لم يكن لديك). افتح المحطة الطرفية وقم بتشغيل: node --version. إذا لم يظهر شيء - حمّل من nodejs.org وثبته.
Node.js مجاني. اختر إصدار LTS.
Node.js ↗ - 2.أنشئ مجلد المشروع. في المحطة الطرفية قم بتشغيل: mkdir ai-agent && cd ai-agent && npm init -y
الأوامر تعمل على Windows (PowerShell) و macOS و Linux بنفس الطريقة.
- 3.ثبت الحزم المطلوبة: npm install axios dotenv. سيعطي هذا الوكيل القدرة على إرسال طلبات إلى API وتخزين المفاتيح بأمان.
جميع الحزم مجانية. يتم تحميلها من مستودع npm.
npm ↗ - 4.أنشئ ملف .env في جذر مجلد ai-agent وأضف فيه أحد مفاتيح API المجانية. الخيار 1 (موصى به للمبتدئين): استخدم Open-Meteo (API طقس مجاني، لا يتطلب تسجيل). الخيار 2: احصل على مفتاح API مجاني من OpenWeather (يتطلب تسجيل، لكن طبقة مجانية موجودة). محتوى ملف .env لـ Open-Meteo: WEATHER_API=https://api.open-meteo.com/v1/forecast
⚠️ لا تنشر ملف .env على Git أو الإنترنت. Open-Meteo لا يتطلب مفتاح وهو مثالي للوكيل الأول.
Text Editor (VS Code) ↗ - 5.أنشئ ملف agent.js في مجلد ai-agent وانسخ الكود أدناه فيه. هذا الوكيل سيطلب الطقس حسب الإحداثيات ويعرض النتيجة في المحطة الطرفية.
استخدم نفس محرر النصوص.
Text Editor (VS Code) ↗البرومبتrequire('dotenv').config(); const axios = require('axios'); async function weatherAgent(latitude, longitude) { try { const apiUrl = `${process.env.WEATHER_API}?latitude=${latitude}&longitude=${longitude}¤t_weather=true`; const response = await axios.get(apiUrl); const weather = response.data.current_weather; console.log(`درجة الحرارة: ${weather.temperature}°C`); console.log(`سرعة الريح: ${weather.windspeed} كم/س`); return weather; } catch (error) { console.error('خطأ في الطلب:', error.message); } } weatherAgent(55.7558, 37.6173);ماذا يفعل هذا البرومبتالكود ينشئ وكيل يأخذ خط العرض [latitude] وخط الطول [longitude]، ويرسل طلب إلى API الطقس ويعرض درجة الحرارة والريح. في المثال إحداثيات موسكو (55.7558, 37.6173) - غيّرها بإحداثياتك، أو اترك كما هي للاختبار. - 6.شغّل الوكيل في المحطة الطرفية: node agent.js. ستشاهد درجة الحرارة والريح الحالية للإحداثيات المحددة.
إذا حدث خطأ في 'require' - تأكد أنك في مجلد ai-agent (أمر pwd يظهر المجلد الحالي).
- 7.أضف الأمان: أنشئ ملف security.js يتحقق من البيانات المدخلة قبل إرسالها إلى API. انسخ السطر أدناه في الوكيل قبل الطلب للتحقق من صحة الإحداثيات:
هذه الخطوة تمنع إرسال بيانات غير صحيحة وتحمي من الحقن المحتمل.
Text Editor (VS Code) ↗البرومبتif (latitude < -90 || latitude > 90 || longitude < -180 || longitude > 180) { throw new Error('الإحداثيات خارج النطاق المسموح'); }ماذا يفعل هذا البرومبتأضف هذا التحقق في بداية دالة weatherAgent() قبل طلب API. يتأكد من أن خط العرض بين -90 و 90، وخط الطول بين -180 و 180، مما يحمي الوكيل من البيانات المدخلة الخاطئة.
💰 كم يكلف تطبيقهالأسعار حتى 2026-07
- مجاناNode.jsمجاني تماماً، مفتوح المصدر.
- مجاناحزم npm (axios, dotenv)جميع الحزم مجانية ومفتوحة المصدر.
- مجاناOpen-Meteo APIAPI مجاني بدون حدود لعدد الطلبات للاستخدام الشخصي، التسجيل غير مطلوب.
- مجاناالوصفة بأكملهاالمسار الكامل مجاني - لا يتطلب بطاقة ائتمان أو اشتراكات مدفوعة أو رصيد API.
جربها وكن أول من يسجل إنجازه
لماذا اليوم
وصفة الأسبوع على بريدك
خدمات الذكاء الاصطناعي تتغير بسرعة - قد تختلف الواجهات والحدود المجانية عما هو موصوف.