Di dua artikel sebelumnya, kita bikin sendiri class

PLAINTEXT Snippetplaintext

AiService

1 baris•9 chars

UTF-8•Spaces: 4

yang langsung komunikasi ke API OpenAI, lalu ditambahkan method terpisah untuk Claude. Itu jalan, tapi kamu mungkin sudah sadar ada masalahnya: setiap provider punya format request sendiri, header sendiri, dan struktur response sendiri. Kalau nanti mau tambah Gemini, Mistral, atau Groq, kamu harus bikin lagi method custom untuk masing-masing.

Ini persis masalah yang diselesaikan Prism PHP. Prism kasih satu interface yang konsisten untuk komunikasi dengan berbagai provider AI, jadi ganti provider cukup ubah satu baris kode, bukan tulis ulang semuanya.

Apa Itu Prism PHP

Prism adalah package Laravel open source yang dibuat khusus untuk kerja dengan LLM. Daripada manggil API mentah masing-masing provider sendiri, kamu tulis kode sekali pakai syntax fluent milik Prism, dan Prism yang urus detail spesifik tiap provider di belakang layar.

Saat ini Prism mendukung provider seperti OpenAI, Anthropic, Gemini, Mistral, Groq, DeepSeek, Ollama, xAI, dan beberapa lainnya, lengkap dengan fitur streaming, tool calling, dan structured output.

Langkah 1: Install Prism

Jalankan ini di project Laravel kamu:

Terminalbash

composer require prism-php/prism

1 baris•32 chars

UTF-8•Spaces: 4

Lalu publish file config-nya:

Terminalbash

php artisan vendor:publish --provider="Prism\Prism\PrismServiceProvider"

1 baris•72 chars

UTF-8•Spaces: 4

Ini akan bikin file

PLAINTEXT Snippetplaintext

config/prism.php

1 baris•16 chars

UTF-8•Spaces: 4

, tempat API key untuk masing-masing provider dikonfigurasi. Buka file itu dan pastikan key-nya diambil dari

PLAINTEXT Snippetplaintext

.env

1 baris•4 chars

UTF-8•Spaces: 4

, mirip seperti yang kita lakukan di Part 2:

ENV Snippetenv

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

2 baris•76 chars

UTF-8•Spaces: 4

Langkah 2: Penggunaan Dasar

Ini contoh paling sederhana, generate respons teks pakai Claude dari Anthropic:

script.phpphp

use Prism\Prism\Facades\Prism;

use Prism\Prism\Enums\Provider;

$response = Prism::text()

    ->using(Provider::Anthropic, 'claude-3-5-sonnet-20241022')

    ->withPrompt('Jelaskan apa itu dependency injection dengan bahasa sederhana.')

    ->asText();

echo $response->text;

9 baris•274 chars

UTF-8•Spaces: 4

Mau pakai OpenAI sebagai gantinya? Tinggal ubah satu baris:

script.phpphp

$response = Prism::text()

    ->using(Provider::OpenAI, 'gpt-4o-mini')

    ->withPrompt('Jelaskan apa itu dependency injection dengan bahasa sederhana.')

    ->asText();

4 baris•169 chars

UTF-8•Spaces: 4

Perhatikan, sisa kodenya tetap sama persis. Inilah inti dari pakai Prism: kode aplikasimu nggak perlu tahu atau peduli provider mana yang sebenarnya menjawab request itu.

Langkah 3: Bangun Ulang Chatbot Kita Pakai Prism

Mari tulis ulang

PLAINTEXT Snippetplaintext

AiService

1 baris•9 chars

UTF-8•Spaces: 4

dari Part 3 pakai Prism, gantikan pemanggilan HTTP manual. Prism sudah punya dukungan bawaan untuk message chain, yang pas banget buat riwayat percakapan chatbot kita.

AiService.phpphp

<?php

namespace App\Services;

use Prism\Prism\Facades\Prism;

use Prism\Prism\Enums\Provider;

use Prism\Prism\ValueObjects\Messages\UserMessage;

use Prism\Prism\ValueObjects\Messages\AssistantMessage;

use Prism\Prism\Exceptions\PrismException;

use Illuminate\Support\Facades\Log;

class AiService

{

    public function chat(array $history): ?string

{

        $messages = array_map(function ($message) {

            return $message['role'] === 'user'

                ? new UserMessage($message['content'])

                : new AssistantMessage($message['content']);

        }, $history);

        try {

            $response = Prism::text()

                ->using(Provider::OpenAI, 'gpt-4o-mini')

                ->withMessages($messages)

                ->asText();

            return $response->text;

        } catch (PrismException $e) {

            Log::error('Prism AI request failed', ['error' => $e->getMessage()]);

            return null;

}

35 baris•973 chars

UTF-8•Spaces: 4

Controller dan view dari Part 3 tidak perlu diubah sama sekali. Ini keuntungan dari menaruh logika AI di balik service class sejak awal: providernya bisa ganti di belakang layar tanpa menyentuh bagian lain dari aplikasimu.

Langkah 4: Ganti Provider Lewat Config, Bukan Kode

Untuk project beneran, lebih baik bikin provider dan model-nya bisa dikonfigurasi, bukan hardcode, supaya kamu bisa ganti provider lewat

PLAINTEXT Snippetplaintext

.env

1 baris•4 chars

UTF-8•Spaces: 4

tanpa menyentuh kode:

ENV Snippetenv

AI_PROVIDER=openai

AI_MODEL=gpt-4o-mini

2 baris•39 chars

UTF-8•Spaces: 4

script.phpphp

use Prism\Prism\Enums\Provider;

$provider = match (config('services.ai.provider')) {

    'anthropic' => Provider::Anthropic,

    'openai' => Provider::OpenAI,

    default => Provider::OpenAI,

};

$response = Prism::text()

    ->using($provider, config('services.ai.model'))

    ->withMessages($messages)

    ->asText();

12 baris•320 chars

UTF-8•Spaces: 4

Sekarang ganti dari OpenAI ke Claude di production cukup dengan ubah config dan deploy, bukan ubah kode.

Fitur Tambahan yang Kamu Dapat Gratis dari Prism

Beberapa fitur yang perlu kamu tahu karena akan kita pakai di artikel-artikel berikutnya:

PLAINTEXT Snippetplaintext
1
withSystemPrompt()
1 baris•18 chars
UTF-8•Spaces: 4
, untuk mengatur perilaku atau persona AI terpisah dari isi percakapan.
PLAINTEXT Snippetplaintext
1
withClientOptions(['timeout' => 30])
1 baris•36 chars
UTF-8•Spaces: 4
, untuk set timeout dengan cara yang sama seperti yang kita lakukan manual di Part 2.
PLAINTEXT Snippetplaintext
1
withClientRetry(3, 100)
1 baris•23 chars
UTF-8•Spaces: 4
, untuk otomatis retry kalau request-nya gagal.
Data usage response, lewat
PLAINTEXT Snippetplaintext
1
$response->usage->promptTokens
1 baris•30 chars
UTF-8•Spaces: 4
dan
PLAINTEXT Snippetplaintext
1
$response->usage->completionTokens
1 baris•34 chars
UTF-8•Spaces: 4
, berguna untuk melacak biaya.

Apakah Selalu Harus Pakai Prism?

Belum tentu. Kalau kamu memang cuma akan pakai satu provider terus dan nggak butuh fleksibilitas multi-provider, manggil API langsung pakai HTTP client Laravel (seperti yang kita lakukan di Part 2) sudah cukup dan dependency-nya lebih sedikit.

Prism jadi berguna kalau:

Kamu mau kasih user pilihan provider atau model AI-nya sendiri
Kamu butuh fallback gampang kalau satu provider lagi down
Kamu bikin fitur tool calling atau structured output (yang ditangani Prism dengan baik)
Kamu memang malas maintain kode khusus provider untuk setiap integrasi

Selanjutnya

Sekarang ganti provider sudah gampang, kita bisa fokus ke fitur yang lebih advanced. Di artikel selanjutnya, kita akan bangun sistem RAG (Retrieval Augmented Generation) sederhana, supaya AI-nya bisa jawab pertanyaan berdasarkan dokumen atau data milikmu sendiri, bukan cuma dari training umumnya.

Ini adalah Part 4 dari series "Laravel + AI Integration".

Menggunakan Prism PHP untuk Abstraksi Provider AI

Laravel & AI Integration

Apa Itu Prism PHP

Langkah 1: Install Prism

Langkah 2: Penggunaan Dasar

Langkah 3: Bangun Ulang Chatbot Kita Pakai Prism

Langkah 4: Ganti Provider Lewat Config, Bukan Kode

Fitur Tambahan yang Kamu Dapat Gratis dari Prism

Apakah Selalu Harus Pakai Prism?

Selanjutnya

Timur Dian Radha Sejati

Punya Masalah Arsitektur atau Ingin Membangun Sistem yang Benar?

Artikel Rekayasa Terkait

Dari Satu Perintah Jadi Banyak Langkah

Bikin AI yang Bisa "Baca" Website dalam Hitungan Detik

Kenalan sama GPT, Gemini, Claude, sampai yang Gratis (Ollama)