Belajar AI Agent & PHP: Cara Membuat Multi Tools Agent dengan Tool Chaining

Terakhir diperbarui: 22 Agustus 2026

Diagram Alur: Multi-Tools Agent Loop & Tool Call Chaining di PHP

WebP Lossless • 74 KB • Schema Ready

Panduan Belajar AI Agent PHP: Multi-Tools & Tool Chaining

Dalam kurikulum belajar ai-agent-php tingkat lanjut, kemampuan Membuat Multi Tools Agent adalah fondasi utama untuk membangun sistem otonom yang benar-benar berguna. Dalam skenario dunia nyata, tugas pengguna jarang bisa diselesaikan hanya dengan satu fungsi tunggal. Sebuah query seperti "Cari user Ahmad di MySQL, cek prakiraan cuaca Jakarta hari ini, dan konversikan 100 USD ke IDR" membutuhkan orkestrasi 3 tools berbeda. Berikut adalah skrip inisialisasi 6 tools enterprise ke dalam satu kesatuan agen:

<?php
// run-multi-tools-agent.php

require_once __DIR__ . '/vendor/autoload.php';

use App\OpenAIClient;
use App\MCP\McpServer;
use App\MCP\McpClient;
use App\Agent\MultiToolsAgent;
use App\Tools\CalculatorTool;
use App\Tools\DatabaseTool;
use App\Tools\FileTool;
use App\Tools\GitHubTool;
use App\Tools\CurrencyTool;
use App\Tools\WeatherTool;

$config = require __DIR__ . '/config/config.php';

// 1. Inisialisasi Koneksi Database PDO Aman
$pdo = new PDO(
    "mysql:host={$config['db']['host']};dbname={$config['db']['name']};charset=utf8mb4",
    $config['db']['user'],
    $config['db']['pass'],
    [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);

// 2. Kumpulkan Seluruh Tools Enterprise
$tools = [
    new CalculatorTool(),
    new DatabaseTool($pdo),
    new FileTool(allowedDir: './uploads'),
    new GitHubTool(token: getenv('GITHUB_TOKEN') ?: null),
    new CurrencyTool(),
    new WeatherTool(),
];

// 3. Daftarkan Tools ke MCP Server & Buat McpClient Adaptor
$mcpServer = new McpServer();
foreach ($tools as $tool) {
    $def = $tool->getDefinition();
    $name = $def['function']['name'] ?? $def['name'];
    $mcpServer->register($name, $tool);
}
$mcpClient = new McpClient($mcpServer);

// 4. Inisialisasi MultiToolsAgent
$client = new OpenAIClient(getenv('OPENAI_API_KEY'));
$agent  = new MultiToolsAgent($client, $mcpClient, maxIterations: 10);

// 5. Eksekusi Kueri Multi-Kriteria
$queries = [
    'Berapa 15% dari 2.500.000? Dan berikan kurs 100 USD ke IDR saat ini.',
    'Cari user bernama "Rusmawan" di database, lalu cek cuaca di Jakarta hari ini.',
    'Cari repository PHP terpopuler di GitHub tentang "ai agent" dan konversikan 50 USD ke IDR.',
];

foreach ($queries as $query) {
    echo "\n" . str_repeat('=', 60) . "\n";
    echo "TASK PENGGUNA: {$query}\n";
    echo str_repeat('-', 60) . "\n";
    $result = $agent->run($query);
    echo "HASIL SINTESIS:\n{$result}\n";
}

Praktik Belajar AI-Agent-PHP: Implementasi Multi-Tools dengan Tool Chaining

Berikut adalah kode sumber class MultiToolsAgent yang mengelola loop penalaran multi-langkah (*Autonomous Reasoning Loop*) secara rekursif hingga tugas selesai:

<?php

namespace App\Agent;

use App\OpenAIClient;
use App\MCP\McpClient;

class MultiToolsAgent
{
    private OpenAIClient $client;
    private McpClient $mcpClient;
    private int $maxIterations;
    private array $messages = [];
    private array $callLog = [];

    public function __construct(
        OpenAIClient $client,
        McpClient $mcpClient,
        int $maxIterations = 10
    ) {
        $this->client        = $client;
        $this->mcpClient     = $mcpClient;
        $this->maxIterations = $maxIterations;
    }

    public function run(string $task): string
    {
        $this->messages = [
            ['role' => 'system', 'content' => $this->buildSystemPrompt()],
            ['role' => 'user',   'content' => $task],
        ];
        $this->callLog = [];
        $toolDefs      = $this->mcpClient->getToolDefinitions();

        for ($iteration = 1; $iteration <= $this->maxIterations; $iteration++) {
            // Request ke model AI dengan membawa seluruh definisi tool
            $response = $this->client->chat($this->messages, $toolDefs);
            $message  = $response['choices'][0]['message'] ?? [];
            $this->messages[] = $message;

            // Jika model meminta eksekusi tool_calls (Multi/Single)
            if (!empty($message['tool_calls'])) {
                foreach ($message['tool_calls'] as $toolCall) {
                    $toolName = $toolCall['function']['name'] ?? 'unknown';
                    $this->callLog[] = $toolName;
                    echo "  [Iterasi {$iteration}] 🔧 Memanggil Tool: {$toolName}\n";

                    // Eksekusi tool lokal via MCP Client
                    $toolResult = $this->mcpClient->executeToolCall($toolCall);
                    $this->messages[] = $toolResult;
                }
                // Lanjutkan loop agar AI dapat memproses hasil tool
                continue;
            }

            // Jika tidak ada tool_calls lagi, artinya model telah mencapai sintesis final
            $finalAnswer = $message['content'] ?? '';
            if (!empty($this->callLog)) {
                $uniqueTools = array_unique($this->callLog);
                $finalAnswer .= "\n\n---\n*Rangkaian Tools yang Digunakan: " . implode(' ➔ ', $uniqueTools) . "*";
            }

            return $finalAnswer;
        }

        return 'Batas iterasi maksimum tercapai sebelum tugas selesai. Silakan sederhanakan instruksi Anda.';
    }

    private function buildSystemPrompt(): string
    {
        $tools = $this->mcpClient->getToolDefinitions();
        $names = array_map(fn($t) => $t['function']['name'] ?? '', $tools);
        $toolList = implode(', ', array_filter($names));

        return "Kamu adalah AI Agent multifungsi tingkat lanjut berbasis PHP.\n"
             . "Tools yang terhubung ke sistem Anda saat ini: {$toolList}.\n"
             . "Aturan Kerja:\n"
             . "1. Analisis task pengguna dan pilih tool yang paling tepat.\n"
             . "2. Jika task membutuhkan beberapa tahapan (chaining), panggil tool secara berurutan.\n"
             . "3. Gunakan hasil dari tool sebelumnya untuk melengkapi input tool berikutnya.\n"
             . "4. Berikan jawaban akhir yang komprehensif, akurat, dan ramah dalam Bahasa Indonesia.";
    }
}

FAQ: Pertanyaan Seputar Multi Tools AI Agent PHP