Oslobađanje od inicijativa označava promjenu paradigme za PHP ekosustav. Više se ne moramo oslanjati na teške vanjske adaptere ili sirove HTTP zahtjeve za izgradnju inteligentnih aplikacija. Symfony pruža nativni, robustan i "Symfony-way" okvir za orkestriranje velikih jezičnih modela (LLM), upravljanje kontekstom i izvršavanje alata. Symfony AI AI Agent Component U ovom članku ćemo istražiti najbolje prakse za provedbu Usredotočit ćemo se na čistu arhitekturu, sigurnost tipa i testiranost – osiguravajući da su vaše AI funkcije pouzdane kao vaša osnovna poslovna logika. symfony/ai-agent Instalacija i arhitektura Dok možete instalirati standalone Knjižnica, najbolja praksa za aplikaciju Symfony je koristiti Ovaj paket integrira komponente agenta, platforme i skladišta izravno u servisni spremnik, što omogućuje snažnu konfiguraciju i injekciju ovisnosti. symfony/ai-agent AI Bundle composer require symfony/ai-bundle symfony/ai-agent
 Konfiguracija Umjesto da ručno instancirate klase agenta u kontrolorima, konfigurirajte ih u To centralizira odabir modela i upravljanje ključima API-ja. 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.'
 Injekcija ovisnosti i osnovna uporaba Nikada ne koristite novog agenta(...) unutar aplikacijskog koda. Bundle alijasi svoje konfigurirane agente na . 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();
    }
}
 Moć alata: širenje inteligencije Prava snaga AI agenata leži u - funkcije koje AI može "pozvati" za izvršavanje akcija ili preuzimanje podataka. Tools Najbolja praksa: atribut #[AsTool] Izbjegavajte ručno registriranje alata array-by-array. To omogućuje komponenti da automatski generiraju JSON shemu koju zahtijeva LLM. #[AsTool] Najbolja praksa: sigurnost tipa s Enums Jedna od najjačih značajki komponente Symfony AI je njegova sposobnost da se izvuku pravila validacije iz PHP tipova. upotrijebite Backed Enums da strogo ograničite izbore koje AI može napraviti. 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
        );
    }
}
 Kada koristite ovaj alat, Prevodi ga Uključivanje u strogu JSON shemu Ako se LLM pokuša nazvati "Antarktika", komponenta (ili LLM platforma) će uhvatiti pogrešku validacije prije nego što se vaš kod čak pokrene. Agent component OrderRegion enum Napredna validacija s #[With] Za ograničenja koja nisu vrste (kao što su regex obrasci ili rasponovi), koristite Prihvaćanje od strane Ugovor je. #[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);
    }
}
 Proizvodnja plinovoda: ulaz i izlaz Ponekad morate presresti poruke prije nego što odu u AI (npr. da biste dodali dinamički kontekst) ili nakon što se vrate (npr. da biste sanitizirali izlaz). Kontekstno ubrizgavanje (RAG Lite) Koristite jedan dinamično ubrizgavanje relevantnih podataka u kontekstni prozor. 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())
            );
        }
    }
}
 Registrirajte ovaj procesor u svoj ai.yaml ili ga ručno žice ako gradite složene lance. Izvođač: The MockAgent Testiranje AI integracija je poznato teško zbog nedeterminističkih izlaza i troškova API-ja. . MockAgent Nikada ne udarite na stvarne API-je u vašim testovima jedinice / značajke. 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?');
    }
}
 Da biste provjerili je li instalacija ispravno radila u okruženju Symfony 7.4: 
 
 
 
 Provjerite konfiguraciju: Pokrenite php bin/console debug:config ai kako biste vidjeli riješenu konfiguraciju agenta. Testirajte agenta: Stvorite jednostavnu konzolnu naredbu src/Command/TestAgentCommand.php. Run: php bin/console app:test-agent. Trebali biste vidjeti odgovor iz LLM. zaključci Naš komponenta donosi strukturu, stabilnost i iskustvo razvijalca Symfony-a u kaotični svijet razvoja AI-a. Prateći ove najbolje prakse – koristeći konfiguraciju Bundle, iskorištavanje strogih PHP tipova za Tools i korištenje za testiranje – danas možete izgraditi AI aplikacije spremne za proizvodnju. symfony/ai-agent MockAgent Nemojte samo pisati skripte; izgradite agente koji su integrirani, sigurni od tipkanja i održivi. Možete pronaći punu implementaciju i pratiti napredak projekta na GitHubu: [ ] Source Code: https://github.com/mattleads/AIAgentSample https://github.com/mattleads/AIAgentSample Let’s Connect! Ako ste ovo pronašli korisno ili imate pitanja o implementaciji, volio bih čuti od vas. 
 
 
 
 
 LinkedIn: [https://www.linkedin.com/in/matthew-mochalkin/] Sljedeći članak: [https://x.com/MattLeads] Vrijeme: [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

Ovaj zvuk je proizveden na izvornom jeziku priče!

Symfony AI agenti u Symfony 7.4: najbolje prakse za čistu arhitekturu, alate i testiranje

About Author

KOMENTARI

VIJESI OZNAKE

OVAJ ČLANAK JE PREDSTAVLJEN U

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps