Як самостійно створити чат-бот на PHP з використанням OpenAI API

автор Illia Haidar 10 Кві, 2023

У цій статті ми розглянемо, як створити простий, але функціональний чат-бот на PHP, використовуючи OpenAI API. Ми пройдемо через усі етапи — від налаштування середовища до отримання відповіді від OpenAI та інтеграції з веб-інтерфейсом. У кінці статті ви зможете отримати готовий до використання чат-бот, який відповідає на ваші запити.

Вимоги перед початком роботи

Перш ніж розпочати, переконайтеся, що у вас є:

PHP (версія 7.4 або вище).
Встановлений Composer для управління залежностями.
Доступ до OpenAI API. Ви можете створити обліковий запис на офіційному сайті OpenAI і отримати API-ключ.
Сервер для локальної розробки (наприклад, XAMPP або OpenServer).

1. Налаштування середовища

Установка PHP і Composer

Переконайтеся, що PHP і Composer встановлені. Щоб перевірити, введіть у терміналі:

php -v

composer -v

Якщо інструменти встановлені, ви побачите їх версії.

Ініціалізація проекту

Створіть нову папку для проекту:

mkdir openai-chatbot

cd openai-chatbot

Ініціалізуйте Composer:

composer init

На запитання відповідайте стандартними значеннями.

2. Встановлення бібліотеки для роботи з OpenAI API

Щоб взаємодіяти з OpenAI API, використаємо бібліотеку guzzlehttp/guzzle для виконання HTTP-запитів. Встановіть її через Composer:

composer require guzzlehttp/guzzle

3. Отримання API-ключа OpenAI

Зайдіть у свій обліковий запис OpenAI.
Перейдіть у розділ “API Keys” і створіть новий ключ.
Скопіюйте цей ключ — він знадобиться для подальшої роботи.

4. Створення базового файлу PHP

Створіть файл index.php у кореневій папці проекту.

Базова структура

<?php

require 'vendor/autoload.php';

use GuzzleHttp\\Client;

// Ініціалізація клієнта
$client = new Client([
    'base_uri' => '<https://api.openai.com/v1/>',
]);

// Ваш API-ключ OpenAI
$apiKey = 'ваш_ключ_API';

// Функція для запиту до OpenAI API
function getChatResponse($prompt) {
    global $client, $apiKey;

    try {
        $response = $client->post('chat/completions', [
            'headers' => [
                'Authorization' => "Bearer {$apiKey}",
                'Content-Type' => 'application/json',
            ],
            'json' => [
                'model' => 'gpt-3.5-turbo',
                'messages' => [
                    ['role' => 'user', 'content' => $prompt],
                ],
                'max_tokens' => 150,
                'temperature' => 0.7,
            ],
        ]);

        $data = json_decode($response->getBody(), true);
        return $data['choices'][0]['message']['content'];
    } catch (Exception $e) {
        return 'Помилка: ' . $e->getMessage();
    }
}

// Тестовий виклик
$input = 'Привіт! Розкажи мені про PHP.';
$response = getChatResponse($input);
echo "Відповідь бота: " . $response;

Розбір коду:

• Бібліотека Guzzle використовується для виконання POST-запитів.

• Функція getChatResponse приймає текст користувача ($prompt) і викликає OpenAI API для отримання відповіді.

• Параметри, такі як model, max_tokens і temperature, визначають поведінку моделі.

5. Налаштування веб-інтерфейсу

Додамо простий HTML-файл для інтерактивної роботи з чат-ботом.

Створення файлу index.html

<!DOCTYPE html>
<html lang="uk">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Чат-бот з OpenAI</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            margin: 0;
            padding: 20px;
            background-color: #f9f9f9;
        }
        .chat-container {
            max-width: 600px;
            margin: 0 auto;
            background: #fff;
            padding: 20px;
            border-radius: 8px;
            box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
        }
        .messages {
            margin-bottom: 20px;
        }
        .message {
            margin: 5px 0;
        }
        .user {
            color: #007BFF;
        }
        .bot {
            color: #28A745;
        }
        form {
            display: flex;
            gap: 10px;
        }
        input {
            flex: 1;
            padding: 10px;
            border: 1px solid #ccc;
            border-radius: 4px;
        }
        button {
            padding: 10px 20px;
            border: none;
            background-color: #007BFF;
            color: #fff;
            border-radius: 4px;
            cursor: pointer;
        }
        button:hover {
            background-color: #0056b3;
        }
    </style>
</head>
<body>
    <div class="chat-container">
        <div class="messages" id="messages"></div>
        <form id="chat-form">
            <input type="text" id="user-input" placeholder="Введіть повідомлення..." required>
            <button type="submit">Відправити</button>
        </form>
    </div>

    <script>
        const form = document.getElementById('chat-form');
        const messagesDiv = document.getElementById('messages');

        form.addEventListener('submit', async (e) => {
            e.preventDefault();
            const userInput = document.getElementById('user-input').value;

            // Додати повідомлення користувача
            const userMessage = document.createElement('div');
            userMessage.textContent = "Користувач: " + userInput;
            userMessage.className = 'message user';
            messagesDiv.appendChild(userMessage);

            // Відправка запиту до PHP
            const response = await fetch('chat.php', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                },
                body: JSON.stringify({ message: userInput }),
            });

            const data = await response.json();

            // Додати повідомлення бота
            const botMessage = document.createElement('div');
            botMessage.textContent = "Бот: " + data.response;
            botMessage.className = 'message bot';
            messagesDiv.appendChild(botMessage);

            // Очистити поле вводу
            document.getElementById('user-input').value = '';
        });
    </script>
</body>
</html>

6. Обробка запитів у PHP

Створіть файл chat.php для обробки запитів від клієнтської сторони:

<?php

require 'vendor/autoload.php';

use GuzzleHttp\\Client;

$client = new Client([
    'base_uri' => '<https://api.openai.com/v1/>',
]);

$apiKey = 'ваш_ключ_API';

function getChatResponse($prompt) {
    global $client, $apiKey;

    try {
        $response = $client->post('chat/completions', [
            'headers' => [
                'Authorization' => "Bearer {$apiKey}",
                'Content-Type' => 'application/json',
            ],
            'json' => [
                'model' => 'gpt-3.5-turbo',
                'messages' => [
                    ['role' => 'user', 'content' => $prompt],
                ],
                'max_tokens' => 150,
                'temperature' => 0.7,
            ],
        ]);

        $data = json_decode($response->getBody(), true);
        return $data['choices'][0]['message']['content'];
    } catch (Exception $e) {
        return 'Помилка: ' . $e->getMessage();
    }
}

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $input = json_decode(file_get_contents('php://input'), true);
    $userMessage = $input['message'] ?? '';

    $response = getChatResponse($userMessage);

    echo json_encode(['response' => $response]);
}

Чому цей підхід ефективний і як його розвивати

Розробка чат-бота на PHP з використанням OpenAI API — це не лише практичне завдання, але й чудова можливість вивчити сучасні інструменти та методи інтеграції. Використання API OpenAI дозволяє швидко створити функціональний продукт без необхідності самостійної розробки складних моделей машинного навчання. У цьому полягає його головна перевага.

З точки зору розробника, PHP — це один із найпоширеніших мов для створення веб-додатків. Його універсальність і легкість використання роблять його ідеальним для швидкої реалізації MVP (minimum viable product). Наприклад, якщо ви працюєте над прототипом чат-бота для бізнесу, який хоче автоматизувати взаємодію з клієнтами, PHP і OpenAI API дозволяють вам це зробити за кілька годин.

Що стосується архітектури, то використання Guzzle для HTTP-запитів забезпечує гнучкість і стабільність. Цей підхід можна легко масштабувати. Наприклад, якщо ви плануєте обробляти тисячі запитів на годину, ви можете налаштувати чергу завдань через RabbitMQ або Redis для асинхронної обробки. Це значно знизить навантаження на сервер і дозволить уникнути помилок через перевищення лімітів API.

Окремо варто зазначити важливість безпеки. API-ключ — це ваш основний спосіб доступу до OpenAI, тому слід зберігати його в конфігураційних файлах, недоступних через веб. Наприклад, у config.php, або ще краще — у змінних середовища (environment variables). Також можна реалізувати механізм rate-limiting для обмеження запитів від одного користувача, щоб уникнути перевантаження.

Цей проєкт можна масштабувати в різних напрямах. Наприклад, ви можете додати більше логіки для обробки спеціалізованих запитів. Якщо бот призначений для технічної підтримки, ви можете підключити базу знань або FAQ. Якщо це комерційний продукт, інтеграція з CRM-системами, такими як Salesforce або HubSpot, значно підвищить його корисність для бізнесу.

У перспективі також варто розглянути інтеграцію інших моделей OpenAI, таких як DALL·E для генерації зображень або Codex для написання коду. Це відкриває величезні можливості для створення комплексних рішень, які поєднують текстову, візуальну та функціональну взаємодію.

На завершення, важливо постійно розвивати ваш чат-бот, аналізуючи, як він взаємодіє з користувачами, і налаштовуючи його відповіді відповідно до їхніх потреб. Це дозволить зробити продукт не лише функціональним, але й максимально корисним для кінцевого користувача. Інтеграція OpenAI API — це лише перший крок до створення складніших і інноваційніших систем, і ваше бачення як розробника визначить, наскільки далеко ви готові зайти у цій захопливій подорожі.