كيف تبني مكونًا إضافيًا أو تطبيقًا بذكاء اصطناعي بداخله، على سبيل المثال دمج Claude API في مكون WordPress إضافي؟

Question

Accepted Answer

تبني الذكاء الاصطناعي في التطبيق من خلال استدعاء API النموذج **من جهة الخادم** ومعاملة مخرجاته كمدخل غير موثوق. بالنسبة لـ Claude، هذا يعني استدعاء **Messages API** من الواجهة الخلفية (PHP، لمكون WordPress) مع الاحتفاظ بمفتاح API على الخادم — لا تضعه أبدًا في JavaScript من جهة العميل، حيث يمكن لأي شخص سرقته.

## استدعاء من جهة الخادم

القاعدة الأساسية: **مفتاح API يعيش على الخادم**. المتصفح يتحدث إلى *نقطة النهاية الخاصة بك*؛ *نقطة النهاية الخاصة بك* تتحدث إلى Claude.

```php
<?php
// In a WordPress plugin: run this in PHP (server-side), never expose the key to JS.
$resp = wp_remote_post( 'https://api.anthropic.com/v1/messages', [
  'headers' => [
    'x-api-key'         => getenv( 'ANTHROPIC_API_KEY' ), // from env/secret store, not code
    'anthropic-version' => '2023-06-01',
    'content-type'      => 'application/json',
  ],
  'timeout' => 30,
  'body' => wp_json_encode( [
    'model'      => 'claude-sonnet-4-5',   // pick a current model id
    'max_tokens' => 1024,                   // cap output → controls cost
    'messages'   => [
      [ 'role' => 'user', 'content' => $user_prompt ],
    ],
  ] ),
] );

if ( is_wp_error( $resp ) ) { /* handle network/timeout errors, maybe retry */ }
$data = json_decode( wp_remote_retrieve_body( $resp ), true );
$text = $data['content'][0]['text'] ?? '';   // validate before trusting/displaying it
```

## ما بعد الأساسيات

```text
- TOOL USE / FUNCTION CALLING → let the model call your functions (search, DB lookup)
- STREAMING                   → stream tokens for a responsive UI on long answers
- PROMPT CACHING              → cache a large static system prompt → cheaper, faster
- STRUCTURED OUTPUT           → ask for JSON, then parse + schema-validate it
- ERRORS & RATE LIMITS        → handle 429/5xx with backoff + retry; show a fallback
- COST                        → cap max_tokens, log token usage, set per-user limits
```

تحقق دائمًا من **مخرجات النموذج قبل استخدامها**: لا تقم بتشغيلها كرمز، أو عرضها بدون escaping، أو كتابتها في قاعدة البيانات الخاصة بك بدون فحص. النموذج هو مولد نصوص قوي لكن معرض للأخطاء، وليس مصدرًا موثوقًا.

## لماذا يهم

شحن الذكاء الاصطناعي داخل منتج حقيقي يتعلق في الغالب بالهندسة الممله لكن الحاسمة حول الاستدعاء، وليس الاستدعاء نفسه. يمنع إبقاء المفتاح على جهة الخادم السرقة والفواتير الجامحة؛ التعامل مع الأخطاء والحدود من معدل الطلبات والتكلفة يحافظ على موثوقية الميزة وتكلفتها؛ والتحقق من المخرجات قبل التصرف بناءً عليها يمنع أخطاء النموذج أو إدراج تعليمات من أن تصبح ثغرة أمان. إذا قمت بذلك بشكل صحيح، يصبح Messages API وحدة بناء موثوقة؛ تخطي هذه الخطوات وعرض توضيحي رائع يتحول إلى مفتاح مسروق، أو فاتورة مفاجئة، أو استغلال.