Πώς δημιουργείτε ένα plugin ή μια εφαρμογή με AI μέσα της, για παράδειγμα ενσωματώνοντας το Claude API σε ένα WordPress plugin;

Question

Accepted Answer

Δημιουργείτε AI σε μια εφαρμογή καλώντας το API του μοντέλου **από την πλευρά του διακομιστή** και αντιμετωπίζοντας την έξοδό του ως μη αξιόπιστη είσοδο. Για το Claude, αυτό σημαίνει κλήση του **Messages API** από το backend (PHP, για ένα WordPress plugin) με το κλειδί API να παραμένει στον διακομιστή — ποτέ στο JavaScript της πλευράς του πελάτη, όπου οποιοσδήποτε θα μπορούσε να το κλέψει.

## Η κλήση από την πλευρά του διακομιστή

Ο βασικός κανόνας: **το κλειδί API ζει στον διακομιστή**. Ο περιηγητής μιλά στο *δικό σας* endpoint; το *δικό σας* endpoint μιλά στο 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 ή μην την γράψετε στη βάση δεδομένων σας χωρίς έλεγχο. Το μοντέλο είναι ένας ισχυρός αλλά αποτυχής γεννήτρια κειμένου, όχι μια αξιόπιστη πηγή.

## Γιατί έχει σημασία

Η αποστολή AI μέσα σε ένα πραγματικό προϊόν αφορά κυρίως τη βαρετή αλλά κρίσιμη μηχανική γύρω από την κλήση, όχι την ίδια την κλήση. Το να κρατήσετε το κλειδί στην πλευρά του διακομιστή αποτρέπει την κλοπή και τα άγρια ​​λογιστικά; η χειrist σφαλμάτων, ορίων ρυθμού και κόστους διατηρεί τη δυνατότητα αξιόπιστη και προσιτή; και η επικύρωση της εξόδου πριν τη δράση σε αυτήν αποτρέπει τα σφάλματα του μοντέλου ή την ένεση εντολής από το να γίνουν κενό ασφαλείας. Κάντε το σωστά και το Messages API γίνεται ένα αξιόπιστο δομικό στοιχείο· παραλείψτε το και μια εντυπωσιακή επίδειξη γίνεται κλεμμένο κλειδί, έκπληκτο τιμολόγιο ή εκμετάλλευση.