Si të ndërtoni një plugin ose aplikacion me AI brenda, p.sh. integrimin e Claude API në një plugin WordPress?

Question

Accepted Answer

Ndërtoni AI në aplikacion duke thirrur API-n e modelit **në anën e serverit** dhe trajtoni rezultatin e tij si hyrje e pandershme. Për Claude, kjo do të thotë të thërrisni **Messages API** nga bakendja juaj (PHP, për një plugin WordPress) me çelësin e API-t të ruajtur në server — kurrë në JavaScript-in në anën e klientit, ku dikush mund ta vjedhin.

## Thirrja në anën e serverit

Rregulli kryesor: **çelësi i API-t jeton në server**. Shfletuesi flet me *pikën tuaj* përfundimtare; *pika juaj* përfundimtare flet me Claude-in.

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

## Përtej bazave

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

Gjithmonë **validoni rezultatin e modelit para se ta përdorni**: mos e ekzekutoni si kod, mos e hartoni pa shpëtim, ose mos e shkruani në DB-në tuaj pa kontrolluar. Modeli është një gjenerator teksti i fuqishëm por i pavërsyer, jo një burim i besueshëm.

## Pse është e rëndësishme

Dërgimi i AI në një produkt real është kryesisht inxhinieria e lodhshme por kritike rreth thirrjes, jo vetë thirrja. Ruajtja e çelësit në server parandalon vjedhjen dhe faturat e padallueshme; trajtimi i gabimeve, limiteve të normës dhe kostove e mbuan karakteristikën të sigurta dhe të përballsueshme; dhe validimi i rezultatit para se të vepruani mbi të parandalon gabimet e modelit ose një udhëzim të injektuar nga bëhej një gropë sigurie. Nëse i bëni atë saktë, Messages API bëhet një bllok ndërtimi i besueshëm; nëse i kaloni, një demo madhështor kthehet në një çelës të vjedhur, një faturë të papritur, ose një shfrytëzim.