Release nan inisyativ la marque yon chanjman paradigm pou ekosistèm PHP la. Nou pa gen plis bezwen depann sou adaptè ekstèn difisil oswa demann HTTP brik yo bati aplikasyon entelijan. Avèk , Symfony bay yon anviwònman natif, robust ak "Symfony-way" pou orchestrating Large Language Models (LLMs), jesyon konteks ak egzekite zouti. Symfony AI AI Agent Component Nan atik sa a, nou pral eksplore pratik yo pi byen pou aplike Nan yon aplikasyon Symfony 7.4, nou pral konsantre sou aritèkti limyè, sekirite kalite ak tèsibilite - asire karakteristik AI ou yo menm tan serye kòm lojik biznis prensipal ou. symfony/ai-agent Enstalasyon & Arkitektur Malgre ke ou ka enstale standalone Bibliyotèk, pi bon pratik pou yon aplikasyon Symfony se pou sèvi ak Sa a bundle entegre ajan, platfòm ak depo konpozan dirèkteman nan konte a sèvis, pèmèt konfigirasyon pwisan ak dependency enjections. symfony/ai-agent AI Bundle composer require symfony/ai-bundle symfony/ai-agent
 Konfigirasyon Anplis de manyen instantizasyon klas Agent nan kontwole ou yo, konfigirasyon yo nan Li konsantre sou seleksyon modèl ou ak jesyon kle API. config/packages/ai.yaml ai:
    # Define the platforms (OpenAI, Anthropic, Ollama, etc.)
    platform:
        openai:
            api_key: '%env(OPENAI_API_KEY)%'

    # Define your Agents
    agent:
        default:
            model: 'gpt-4o-mini'
            # Best Practice: Define a system prompt here to keep code clean
            prompt: 'You are a helpful Symfony assistant. concise and technical.'
        
        # specialized agent
        support_bot:
            model: 'gpt-4o'
            prompt: 'You are a customer support agent. Be polite and empathetic.'
 Dependency Injection & Basic itilizasyon Never use new Agent(...) inside your application code. Depi sou Symfony a . Pakè a aliases ajan konfigirasyon ou a nan . autowiring AgentInterface namespace App\Service;

use Symfony\AI\Agent\AgentInterface;
use Symfony\AI\Platform\Message\Message;
use Symfony\AI\Platform\Message\MessageBag;

final readonly class SupportAssistant
{
    // Inject the specific agent if you have multiple, or the default AgentInterface
    public function __construct(
        #[Autowire(service: 'ai.agent.support_bot')]
        private AgentInterface $agent
    ) {}

    public function ask(string $userQuestion): string
    {
        // Use a MessageBag to maintain structure (System, User, Assistant)
        $messages = new MessageBag(
            Message::ofUser($userQuestion)
        );

        // The 'call' method is the primary entry point
        $response = $this->agent->call($messages);

        return $response->getContent();
    }
}
 Potansyèl nan zouti: Extending Intelligence pouvwa reyèl nan Agents AI se nan - fonksyon ki AI ka "kouvri" fè aksyon oswa retire done. Tools Pi bon pratik: Atribit la #[AsTool] Evite manyen enskri zouti array-by-array. Sèvi ak atribit. Sa a pèmèt eleman an yo otomatikman kreye JSON Schema a mande pa LLM la. #[AsTool] Pi bon pratik: sekirite kalite ak Enums Youn nan karakteristik yo pi fò nan konpozan a Symfony AI se kapasite li yo dedye règ validasyon soti nan kalite PHP. Sèvi ak Backed Enums yo estriktirèlman limite chwa yon AI ka fè. Sa a anpeche "hallucination" nan paramèt invalide. namespace App\Enum;

enum OrderRegion: string
{
    case US = 'us';
    case EU = 'eu';
    case ASIA = 'asia';
}
 namespace App\AI\Tool;

use App\Enum\OrderRegion;
use Symfony\AI\Agent\Toolbox\Attribute\AsTool;
use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;

#[Autoconfigure(tags: ['ai.tool'])]
#[AsTool(
    name: 'get_order_status',
    description: 'Retrieves the current status of a customer order.'
)]
final readonly class OrderStatusTool
{
    public function __invoke(
        string $orderId,
        OrderRegion $region,
    ): string {
        return sprintf(
            "Order %s in region %s is currently: SHIPPED",
            $orderId,
            $region->value
        );
    }
}
 Si ou sèvi ak zouti sa a, tradui nan enum nan yon seri estrikti JSON list pou LLM la. Si LLM la eseye rele li ak "Antarktik", eleman an (oswa platfòm la LLM) pral pran erè a validasyon anvan koòd ou menm kouri. Agent component OrderRegion enum Avanse Validasyon ak #[Pou] Pou restriksyon ki pa kalite (tankou modèl regex oswa ranje), sèvi ak Atribit soti nan Kontrakte nan. #[With] JsonSchema namespace App\AI\Tool;

use Symfony\AI\Agent\Toolbox\Attribute\AsTool;
use Symfony\AI\Platform\Contract\JsonSchema\Attribute\With;
use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;

#[Autoconfigure(tags: ['ai.tool'])]
#[AsTool(
    name: 'set_discount',
    description: 'Sets a discount percentage for a product or order.'
)]
final readonly class DiscountTool
{
    public function __invoke(
        #[With(minimum: 0, maximum: 50)]
        int $percentage
    ): string {
        return sprintf("Discount set to %d%%.", $percentage);
    }
}
 Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pwodwi pou Pafwa ou bezwen intercepte mesaj anvan yo ale nan AI (pou egzanp, ajoute konteks dinamik) oswa apre yo retire (pou egzanp, sanite pwodiksyon). Konteks Enjeksyon (RAG Lite) Sèvi ak pou enprime done ki enpòtan nan fenèt la konte dinamikman. Input Processor namespace App\AI\Processor;

use App\Entity\User;
use Symfony\AI\Agent\Input;
use Symfony\AI\Agent\InputProcessorInterface;
use Symfony\AI\Platform\Message\MessageBag;
use Symfony\AI\Platform\Message\SystemMessage;
use Symfony\Bundle\SecurityBundle\Security;
use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;

#[Autoconfigure(tags: ['ai.input_processor'])]
final readonly class UserContextProcessor implements InputProcessorInterface
{
    public function __construct(private Security $security) {}

    public function processInput(Input $input): void
    {
        /** @var User|null $user */
        $user = $this->security->getUser();

        if ($user) {
            $input->setMessageBag(
                (new MessageBag(
                    new SystemMessage(sprintf("Current user is %s (ID: %d)", $user->getEmail(), $user->getId()))
                ))->merge($input->getMessageBag())
            );
        }
    }
}
 Enskri processeur sa a nan ai.yaml ou oswa kab l 'manualman si ou se bati chaj konplèks. Tès nan: The MockAgent Tès entegre AI se notèman difisil akòz pwodiksyon ki pa deterministik ak pri API. Konpozan an nan Symfony AI Agent rezoud sa a ak . MockAgent Pa janm bat reyèl APIs nan tès inite / karakteristik ou. Best Practice: namespace App\Tests\Service;

use App\Service\SupportAssistant;
use PHPUnit\Framework\TestCase;
use Symfony\AI\Agent\MockAgent;

class SupportAssistantTest extends TestCase
{
    public function testAskReturnsExpectedResponse(): void
    {
        $agent = new MockAgent([
            'how do I reset my password?' => 'Go to settings and click reset.',
        ]);

        $service = new SupportAssistant($agent);

        $response = $service->ask('how do I reset my password?');
        
        $this->assertEquals('Go to settings and click reset.', $response);
        
        $agent->assertCalledWith('how do I reset my password?');
    }
}
 Pou tcheke konfigirasyon ou ap travay byen nan yon anviwònman Symfony 7.4: 
 
 
 
 Tcheke Konfigirasyon: Run php bin/console debug:config ai yo wè konfigirasyon a nan ajan ou rezoud. Teste Agent la: Kreye yon komando konsole senp src/Command/TestAgentCommand.php. Run: php bin/console app:test-agent. Ou ta dwe wè yon repons soti nan LLM la. Konklisyon nan Component pote estrikti, estabilite ak eksperyans devlopè nan Symfony nan mond lan chaotik nan devlopman AI. Pa swiv sa yo pratik yo pi bon - lè l sèvi avèk konfigirasyon an Bundle, fè benefis nan kalite PHP estrikti pou zouti ak sèvi ak pou tès - ou ka bati aplikasyon AI pwodiksyon-klare jodi a. symfony/ai-agent MockAgent Pa sèlman ekri skript; bati ajan ki entegre, tip-sèf ak manyen. Ou ka jwenn deplwaman an plen ak swiv pwojè a nan pwojè a sou GitHub: [ ] Source Code: https://github.com/mattleads/AIAgentSample https://github.com/mattleads/AIAgentSample Let’s Connect! Si ou te jwenn sa a itil oswa gen kesyon sou implemantasyon an, mwen ta renmen tande soti nan ou. Reste nan kontak ak kenbe konvèsasyon an sou platfòm sa yo: 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] X (Twitter): [https://x.com/MattLeads] Telefòn: [https://t.me/MattLeads] GitHub: [https://github.com/mattleads] https://www.linkedin.com/in/matthew-mochalkin/ https://x.com/MattLeads https://t.me/MattLeads https://github.com/mattleads

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

Read My Stories

Odyo sa a pwodui nan lang orijinal istwa a!

Symfony AI Agents nan Symfony 7.4: Praktik Pi bon pou Arkitektur Clean, zouti, ak tès

About Author

KÒMANtè

KANDYE TAGS

ATIK SA A TE PREZANTE NAN

Related Stories

HN Editor Picks: Top Tech Stories of March 2023

Meet Fastex: HackerNoon Company of the Week

Code Smell 286 - Parent-Child Method Overlaps

Code Smell 260 - Crowdstrike NULL

HN Editor Picks: Top Tech Stories of March 2023

Meet Fastex: HackerNoon Company of the Week

Code Smell 286 - Parent-Child Method Overlaps

Code Smell 260 - Crowdstrike NULL

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps