AI-ს აგებთ აპლიკაციაში მოდელის API-ის სერვერ-მხარეს გამოძახებით და მისი output-ის არასანდო შეყვანად აღრიცხვით. Claude-სთვის ეს ნიშნავს Messages API-ის გამოძახებას თქვენი backend-დან (PHP, WordPress plugin-ისთვის) API key-ი სერვერზე დაცული — არასდროს client-side JavaScript-ში, სადაც ვინმეს შეუძლია იგი გაპარტაკოს.
მთავარი წესი: API key ცხოვრობს სერვერზე. ბრაუზერი კথავს თქვენი endpoint-ისთან; თქვენი endpoint კთავს Claude-ისთან.
<?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
- 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
ყოველთვის გადაამოწმეთ მოდელის გამომავალი გამოყენებამდე: არასდროს დაუშვათ მისი შესრულება კოდის სახით, არ render მოახდინოთ escaping-ის გარეშე, ან არ ჩაწერეთ თქვენ DB-ში შემოწმების გარეშე. მოდელი არის მძლავრი მაგრამ ჯერ არ დადასტურებული ტექსტის გენერატორი, არა სანდო წყარო.
AI-ის რეალურ პროდუქტში გატანა ძირითადად მოსაბეზრებელი მაგრამ კრიტიკული ინჟინერია გამოძახების გარშემო, არა თავად გამოძახება. key-ი სერვერ-მხარეს უსაფრთხოებას ხელს უწყობს ქურდობისა და მოულოდო ბილიკებისგან; შეცდომების, rate limits-ისა და cost-ის დამუშავება ფუნქციას აკეთებს საიმედო და ხელმისაწვდომი; და output-ის გადამოწმება მის გამოყენებამდე აკავებს მოდელის შეცდომებს ან ჩაშენებული ინსტრუქციის პრობლემაში გადაქცევას. თუ ეს სწორად შესრულდა, Messages API ხდება საიმედო სამშენებლო ბლოკი; თუ გამოტოვით, მხნადელი დემო ხდება ფუჟი key, წინაუნდელი ინვოისი, ან აკვე.