Membuat AI Agent Pertama dengan PHP

Terakhir diperbarui: 22 Agustus 2026

Konsep & Fondasi AI Agent PHP: Cara Kerja Sistem Otonom

Dalam pengembangan AI Agent PHP modern, langkah fundamental yang wajib dikuasai adalah memahami bagaimana Large Language Model (LLM) seperti GPT-4 dapat diberdayakan tidak hanya sebagai mesin penjawab teks statis, melainkan sebagai mesin penalaran (reasoning engine). Dengan mengombinasikan logika modular PHP 8.2+ dan OpenAI Function Calling API, Anda dapat membangun sistem mandiri yang mampu memecahkan instruksi bertingkat (multi-step problem solving).

Arsitektur Kognitif: Siklus Otonom AI Agent PHP (Cognitive Loop)

WebP Lossless • 56 KB • Multimodal Ready

+-----------------------------------------------------------------------------------+
|                        PENGGUNA / USER INPUT (Goal Specification)                 |
|                   "Bandingkan performa JIT PHP 8.3 vs 7.4"                        |
+-----------------------------------------------------------------------------------+
                                         |
                                         v
+-----------------------------------------------------------------------------------+
| 1. PERCEIVE (Short-term Working Memory)                                           |
|    - System Prompt: Framework penalaran (ReAct), persona, batasan                |
|    - Message History: Inisialisasi array $messages [system, user]                 |
+-----------------------------------------------------------------------------------+
                                         |
                                         v
+-----------------------------------------------------------------------------------+
| 2. PLAN (LLM Reasoning Phase via OpenAI Chat Completion)                          |
|    - Kirim konteks pesan & JSON Schema Function Calling                           |
|    - Evaluasi keputusan: Butuh panggil tool eksternal atau langsung sintesis teks?|
+-----------------------------------------------------------------------------------+
                      /                                             \
        (Ada tool_calls)                                  (Tidak ada tool_calls)
                    /                                                 \
                   v                                                   v
+------------------------------------+               +------------------------------+
| 3. ACT (Local PHP Tool Execution)  |               | 4. REFLECT (Goal Validation) |
|    - JSON Decode argumen fungsi    |               |    - isGoalAchieved() evaluasi|
|    - Eksekusi dynamic tool method  |               |    - Output teks final non-kosong|
|    - Masukkan hasil ke array pesan |               |    - Loop terminasi (Break)  |
|      dengan role 'tool' + ID      |               +------------------------------+
+------------------------------------+                                 |
                   |                                                   v
                   +-------------------+            +-------------------------------+
                                       |            |   RESPONS AKHIR DIKEMBALIKAN  |
                                       v            |   KE USER (Success Status)    |
         (Looping kembali ke Fase 2: PLAN)          +-------------------------------+

Perbedaan Chatbot Konvensional vs Autonomous AI Agent

Berbeda dengan chatbot biasa yang bekerja dengan pola satu kali tanya satu kali jawab (single-turn request), sebuah Autonomous AI Agent memiliki siklus kognitif mandiri (Cognitive Loop):

• Perceive (Menganalisis): Membaca instruksi (goal) dan konteks data yang tersedia dari lingkungan percakapan.
• Plan (Merencanakan): Menentukan fungsi atau alat (tools) apa yang harus dipanggil terlebih dahulu untuk mendapatkan fakta.
• Act (Mengeksekusi): Menjalankan method PHP lokal (query database, manipulasi file system, request REST API).
• Reflect (Mengevaluasi): Membaca output hasil tool dan menentukan apakah tujuan telah tercapai atau perlu langkah penalaran lanjutan.

Panduan Struktur Class: Membuat AI Agent Pertama dengan PHP

Berikut adalah implementasi class Agent lengkap dengan manajemen memory sesi percakapan, integrasi tools, execution loop, dan evaluasi hasil:

<?php

namespace App\Agent;

use App\OpenAIClient;

class Agent
{
    private OpenAIClient $client;
    private array $tools = [];
    private array $messages = [];
    private int $maxIterations;
    private string $systemPrompt;

    public function __construct(
        OpenAIClient $client,
        string $systemPrompt = '',
        int $maxIterations = 10
    ) {
        $this->client        = $client;
        $this->maxIterations = $maxIterations;
        $this->systemPrompt  = $systemPrompt ?: $this->defaultSystemPrompt();
    }

    private function defaultSystemPrompt(): string
    {
        return '''Kamu adalah AI Agent yang cerdas, sistematis, dan efisien.

INSTRUKSI KERJA:
1. Analisis goal yang diberikan user secara mendalam.
2. Buat rencana kerja bertahap untuk menyelesaikan goal tersebut.
3. Gunakan function/tools yang tersedia secara presisi saat memerlukan data eksternal.
4. Evaluasi hasil dari setiap tool call sebelum melanjutkan ke langkah berikutnya.
5. Berikan jawaban final yang komprehensif ketika seluruh goal telah tercapai.

Selalu berkomunikasi dalam Bahasa Indonesia yang profesional dan jelas.''';
    }

    public function registerTool(object $tool): self
    {
        $this->tools[] = $tool;
        return $this;
    }

    /**
     * Menjalankan autonomous execution loop agent berdasarkan goal user.
     */
    public function run(string $goal): string
    {
        // Langkah 1: Inisialisasi memory percakapan (system prompt & user goal)
        $this->messages = [
            ['role' => 'system', 'content' => $this->systemPrompt],
            ['role' => 'user',   'content' => "Goal: $goal"],
        ];

        $toolDefinitions = $this->buildToolDefinitions();
        $finalResponse   = '';

        // Langkah 2: Autonomous Execution Loop dengan batas maksimum iterasi
        for ($i = 0; $i < $this->maxIterations; $i++) {
            echo "[Iterasi " . ($i + 1) . "] Mengirim percakapan ke LLM...\n";

            // Langkah 3: Kirim konteks pesan ke OpenAI Chat Completion API
            $response = $this->client->chat($this->messages, $toolDefinitions);
            $message  = $response['choices'][0]['message'];

            // Langkah 4: Rekam respons asisten ke dalam memory history
            $this->messages[] = $message;

            // Langkah 5: Percabangan evaluasi tool_calls (Function Calling)
            if (!empty($message['tool_calls'])) {
                $this->handleToolCalls($message['tool_calls']);
                continue; // Lanjutkan loop berikutnya untuk mengevaluasi output tool
            }

            // Langkah 6: Tangkap respons teks langsung (jawaban akhir)
            $finalResponse = $message['content'] ?? '';

            // Langkah 7: Verifikasi terminasi apakah goal telah tercapai
            if ($this->isGoalAchieved($finalResponse)) {
                echo "[Selesai] Goal berhasil dicapai pada iterasi ke-" . ($i + 1) . ".\n";
                break;
            }
        }

        return $finalResponse;
    }

    /**
     * Memproses dan mengeksekusi daftar tool calls yang diminta oleh model AI.
     */
    private function handleToolCalls(array $toolCalls): void
    {
        foreach ($toolCalls as $toolCall) {
            $toolName = $toolCall['function']['name'];
            $args     = json_decode($toolCall['function']['arguments'], true) ?? [];

            echo "  → [Tool Call] Memanggil fungsi: {$toolName}\n";

            // Eksekusi fungsi PHP lokal
            $result = $this->executeTool($toolName, $args);

            // Masukkan hasil eksekusi kembali ke dalam percakapan sebagai role 'tool'
            $this->messages[] = [
                'role'         => 'tool',
                'tool_call_id' => $toolCall['id'],
                'content'      => json_encode($result),
            ];
        }
    }

    /**
     * Dynamic method dispatcher untuk menjalankan method class tool yang terdaftar.
     */
    private function executeTool(string $name, array $args): mixed
    {
        foreach ($this->tools as $tool) {
            if (method_exists($tool, $name)) {
                return $tool->$name(...array_values($args));
            }
        }
        return ['error' => "Tool '{$name}' tidak ditemukan pada registry agent."];
    }

    /**
     * Evaluasi terminasi kondisi apakah jawaban akhir telah memenuhi kriteria goal.
     */
    private function isGoalAchieved(string $response): bool
    {
        return !empty(trim($response));
    }

    /**
     * Mengumpulkan skema JSON Schema dari seluruh tool yang didaftarkan.
     */
    private function buildToolDefinitions(): array
    {
        $definitions = [];
        foreach ($this->tools as $tool) {
            if (method_exists($tool, 'getDefinition')) {
                $definitions[] = $tool->getDefinition();
            }
        }
        return $definitions;
    }
}

Siklus Otonom: Plan → Execute → Reflect → Repeat AI Agent PHP

WebP Lossless • 41 KB • Semantic Schema

Bedah Teknis Method Class AI Agent di PHP

Untuk memahami bagaimana sebuah AI Agent dapat bekerja secara otonom tanpa campur tangan manusia di setiap langkahnya, mari kita bedah arsitektur internal dan tanggung jawab logis pada masing-masing method di atas secara mendalam:

Langkah Membuat AI Agent Pertama dengan PHP: Eksekusi & Pengujian

Buat file eksekusi pengujian run-agent.php pada root direktori proyek Anda untuk menguji kemampuan penalaran class Agent yang baru dibuat:

<?php
// run-agent.php

// Langkah 1: Load autoloader Composer dan konfigurasi API Key
require_once __DIR__ . '/vendor/autoload.php';
$config = require __DIR__ . '/config/config.php';

// Langkah 2: Inisialisasi wrapper client OpenAI
$client = new App\OpenAIClient($config['openai_api_key']);

// Langkah 3: Buat instance AI Agent dengan batas safety 5 kali iterasi
$agent  = new App\Agent\Agent($client, maxIterations: 5);

// Langkah 4: Tentukan goal instruksi yang membutuhkan penalaran teknis
$goal   = 'Buatkan saya perbandingan teknis singkat antara PHP 8.3 vs PHP 7.4 dalam aspek performa JIT, Type System, dan konsumsi memori.';

// Langkah 5: Eksekusi agent secara mandiri dan cetak hasil akhir
echo "=== MEMULAI AI AGENT ===\n";
$result = $agent->run($goal);

echo "\n=== HASIL AKHIR AGENT ===\n";
echo $result . "\n";

FAQ: Pertanyaan Seputar Pembuatan AI Agent dengan PHP