المتطلبات الأساسية وإعداد API

قبل بناء وكلاء استخدام الحاسوب، تحتاج إلى إعداد بيئة التطوير الخاصة بك بالأدوات الصحيحة والوصول إلى API.

البرامج المطلوبة

البرنامج	الإصدار	الغرض
Python	3.10+	SDK والنصوص البرمجية
Docker	الأحدث	بيئة معزولة
Anthropic SDK	0.40+	عميل API

الحصول على مفتاح API الخاص بك

1. اذهب إلى console.anthropic.com
2. انتقل إلى API Keys
3. أنشئ مفتاحاً جديداً باسم وصفي
4. خزّنه بأمان (لا تودعه في git أبداً)

# تعيين مفتاح API كمتغير بيئة
export ANTHROPIC_API_KEY="sk-ant-..."

تثبيت حزمة Anthropic SDK

# إنشاء بيئة افتراضية
python -m venv venv
source venv/bin/activate  # على Windows: venv\Scripts\activate

# تثبيت SDK
pip install anthropic>=0.40.0

التحقق من التثبيت

from anthropic import Anthropic

client = Anthropic()

# اختبار اتصال API
response = client.messages.create(
    model="claude-sonnet-4-5-20250514",
    max_tokens=100,
    messages=[{"role": "user", "content": "مرحبا!"}]
)

print(response.content[0].text)

الوصول إلى بيتا استخدام الحاسوب

يتطلب استخدام الحاسوب ترويسة بيتا:

response = client.messages.create(
    model="claude-sonnet-4-5-20250514",
    max_tokens=4096,
    betas=["computer-use-2025-01-24"],
    # ... باقي المعاملات
)

اعتبارات التكلفة

المكون	عامل التكلفة
لقطات الشاشة	رموز الصور (تتغير حسب الدقة)
استدعاءات الأدوات	رموز الإخراج القياسية
الجلسات الطويلة	استخدام نافذة السياق

نصيحة: استخدم دقة 1024x768 أثناء التطوير لتقليل التكاليف. قم بالترقية للإنتاج.

بعد ذلك، سنقوم بإعداد Docker لبيئة تطوير معزولة. :::