Kif tibni plugin jew app b'AI ġo fih, pereżempju l-integrazzjoni tal-Claude API f'plugin WordPress?

Question

Accepted Answer

Tibni AI f'app billi taħħidx l-API tal-mudell **min-naħa tas-server** u ttratta l-output tiegħu bħala input mhux fiduċjuż. Għal Claude, dan ifisser taħħidx l-**Messages API** mill-backend tiegħek (PHP, għal plugin WordPress) bl-API key miżmuwa fuq is-server — qatt mhux f'JavaScript tal-klijent, fejn xi ħadd jista' juqru.

## Il-ħajta min-naħa tas-server

Ir-regola ewlenija: **l-API key jinsab fuq is-server**. Il-browser itkellim ma' *l-endpoint* tiegħek; *l-endpoint* tiegħek jtkellim ma' 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
```

## Biegħed mill-bażikċi

```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
```

Dawl **ivalidar l-output tal-mudell qabel ma tuġħu**: qatt ma t-ġiegħled bħala kod, ma render mingħajr escaping, jew ma tikteb fl-DB tiegħek mingħajr kontroll. Il-mudell huwa ġeneratur tista ġodda but mhux affidabbli, mhux sors fiduċjuż.

## Għaliex dan importanti

It-tiegħ tal-AI ġo prodott reali huwa l-aktar l-inġiniera memboring-imma-kritika madwar il-ħajta, mhux il-ħajta nnifisha. Iż-żamm tal-key min-naħa tas-server jipprevjeni ż-żift u fatturi misjuqa; l-immaniġġar tal-iżbalji, limiti tar-rate, u spiża iżomm il-feature affidabbli u affordable; u l-validazzjoni tal-output qabel it-taġġ fuqu tipprevjeni l-iżbalji tal-mudell jew struzzjoni injettata milli ssir toqba ta' sigurtà. Iżżomm dan it-tajjeb u l-Messages API issir blokk tal-kostruzzjoni dipendabbli; aqbad u demo impresjonanti ssir keyed mijtiba, invoice sorpresa, jew exploit.