Handling AI Interactions with the Chat Service Layer in PHP

In the previous lesson, we explored the ChatManager class, which plays a crucial role in managing chat data within our application. Now, we will take the next step in our journey by building the chat service layer. This layer is essential for integrating the language model with chat sessions, allowing us to process user messages and generate AI responses. By the end of this lesson, you will understand how to set up the ChatService class, create chat sessions, and process messages using OpenAI's PHP client.

The service layer acts as a bridge between the model layer, where data is managed, and the AI model, which generates responses. It is responsible for orchestrating the flow of data and ensuring that user interactions are handled smoothly. Let's dive into the details of setting up this important component.

The ChatService class is the heart of our service layer. It is responsible for managing chat sessions and interacting with OpenAI’s API to generate AI responses. To begin, we need to set up the class and its components.

First, we import the necessary classes, including the ChatManager from our previous lesson and OpenAI's PHP client. Here's how the class is initialized:

<?php

namespace App\Services;

use App\Models\ChatManager;
use OpenAI;

class ChatService {
    private ChatManager $chatManager;
    private OpenAI\Client $openai;
    private string $systemPrompt;

    public function __construct() {
        $this->chatManager = new ChatManager();

        // Load OpenAI API key from environment variables
        $apiKey = $_ENV['OPENAI_API_KEY'] ?? getenv('OPENAI_API_KEY');
        $baseUrl = $_ENV['OPENAI_BASE_URI'] ?? getenv('OPENAI_BASE_URI');

        // Initialize the OpenAI client
        $this->openai = OpenAI::factory()
            ->withApiKey($apiKey)
            ->withBaseUri($baseUrl)
            ->make();

        $this->systemPrompt = $this->loadSystemPrompt(__DIR__ . '/../data/system_prompt.txt');
    }
}

In this setup, we instantiate ChatManager to manage chat data, initialize the OpenAI client, and load the systemPrompt using the loadSystemPrompt method.

The system prompt is a crucial component that guides the AI’s responses. It provides context and instructions for the AI, ensuring that it behaves in a manner consistent with our application's goals. Here’s how we implement the loadSystemPrompt method:

private function loadSystemPrompt(string $filePath): string {
    return file_exists($filePath) ? file_get_contents($filePath) : "You are a helpful assistant.";
}

This method attempts to read the system prompt from a specified file path. If successful, it returns the prompt as a string. In case of an error, it prints an error message and returns a default prompt. This ensures that the application can continue functioning even if the file is missing or corrupted.