Wyzwolenie z inicjatywa oznacza zmianę paradygmatu dla ekosystemu PHP. Nie musimy już polegać na ciężkich zewnętrznych adapterach lub surowych żądań HTTP do budowania inteligentnych aplikacji. Symfony zapewnia native, solidne i "Symfony-way" ramy do orkiestracji dużych modeli językowych (LLM), zarządzania kontekstem i wykonywania narzędzi. Symfony AI AI Agent Component W tym artykule omówimy najlepsze praktyki W aplikacji Symfony 7.4 skupimy się na czystej architekturze, bezpieczeństwie typu i testowalności – zapewniając, że funkcje AI są tak samo niezawodne, jak podstawowa logika biznesowa. symfony/ai-agent Instalacja & Architektura Podczas gdy można zainstalować standalone biblioteki, najlepszą praktyką dla aplikacji Symfony jest używanie Ten pakiet integruje elementy agenta, platformy i magazynu bezpośrednio w kontener serwisowy, umożliwiając potężną konfigurację i wtrysk zależności. symfony/ai-agent AI Bundle composer require symfony/ai-bundle symfony/ai-agent
 Konfiguracja Zamiast ręcznie instancjonować klasy agentów w kontrolerach, skonfiguruj je w To scentralizuje wybór modelu i zarządzanie kluczami 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.'
 Uzależnienie od zastrzyku i podstawowe zastosowanie Nigdy nie używaj nowego agenta(...) w kodzie aplikacji. Pakiet aliesuje skonfigurowanych agentów do . 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();
    }
}
 Potęga narzędzi: poszerzanie inteligencji Prawdziwa siła agentów AI leży w — funkcje, które AI może „zwołać” do wykonywania działań lub pobierania danych. Tools Najlepsze praktyki: atrybut #[AsTool] Unikaj ręcznego rejestrowania narzędzi array-by-array. Pozwala to komponentowi automatycznie wygenerować schemat JSON wymagany przez LLM. #[AsTool] Najlepsze praktyki: Bezpieczeństwo typu z Enums Jedną z najsilniejszych cech komponentu Symfony AI jest jego zdolność do wyciągania reguł walidacji z typów PHP. Użyj Backed Enums, aby ściśle ograniczyć wybory, które może dokonać AI. 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
        );
    }
}
 Jeśli używasz tego narzędzia, Tłumaczy to Wprowadzenie do ścisłego schematu JSON Jeśli LLM próbuje nazwać go „Antarctica”, komponent (lub platforma LLM) złapie błąd walidacji, zanim Twój kod będzie nawet działał. Agent component OrderRegion enum Zaawansowana walidacja z #[With] W przypadku ograniczeń, które nie są typami (takimi jak wzorce regex lub zakresy), użyj atrybuty z W umowie . #[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);
    }
}
 Przetwarzanie rurociągów: wejścia i wyjścia Czasami trzeba przechwycić wiadomości, zanim przejdą do sztucznej inteligencji (np. aby dodać dynamiczny kontekst) lub po ich powrocie (np. aby usunąć wyjście). Wstrzyknięcie kontekstu (RAG Lite) Użyj jednego Aby dynamicznie wstrzykiwać odpowiednie dane do okna kontekstowego. 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())
            );
        }
    }
}
 Zarejestruj ten procesor w twoim ai.yaml lub przewód go ręcznie, jeśli budujesz złożone łańcuchy. Tytuł: The MockAgent Testowanie integracji AI jest notorycznie trudne ze względu na nie-deterministyczne wyjścia i koszty API. . MockAgent Nigdy nie uderzaj w prawdziwe API w testach jednostek / funkcji. 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?');
    }
}
 Aby sprawdzić, czy ustawienie działa poprawnie w środowisku Symfony 7.4: 
 
 
 
 Sprawdź konfigurację: uruchom php bin/console debug:config ai, aby zobaczyć rozstrzygniętą konfigurację agenta. Test Agent: Utwórz proste polecenie konsoli src/Command/TestAgentCommand.php. Run: php bin/console app:test-agent. Powinieneś zobaczyć odpowiedź z LLM. konkluzje o komponent przynosi strukturę, stabilność i doświadczenie dewelopera Symfony do chaotycznego świata rozwoju sztucznej inteligencji.Dążąc do tych najlepszych praktyk — korzystając z konfiguracji Bundle, wykorzystując rygorystyczne typy PHP dla narzędzi i wykorzystując do testowania — możesz dziś zbudować gotowe do produkcji aplikacje AI. symfony/ai-agent MockAgent Nie pisz tylko skryptów; zbuduj agentów, które są zintegrowane, bezpieczne dla typowania i podtrzymywalne. Możesz znaleźć pełną implementację i śledzić postęp projektu na GitHub: [ ] Source Code: https://github.com/mattleads/AIAgentSample https://github.com/mattleads/AIAgentSample Let’s Connect! Jeśli znalazłeś to przydatne lub masz pytania dotyczące wdrożenia, chciałbym usłyszeć od ciebie. 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] Na stronie internetowej: [https://x.com/MattLeads] Wiadomości: [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

Ten dźwięk jest produkowany w oryginalnym języku historii!

Symfony AI Agents w Symfony 7.4: najlepsze praktyki dla czystej architektury, narzędzi i testów

About Author

UWAGI

ZAWIEŚĆ TAGI

ARTYKUŁ TEN ZOSTAŁ PREZENTOWANY W

Related Stories

Reach More Readers! BOOST Your Story on HackerNoon

Meet Sekurno: HackerNoon Company of the Week

Meet the Writer: HackerNoon's Contributor Emmanuel Nwaka, Content Marketing Professional

From Desk to HackerNoon: Your Ultimate Guide on How to Publish a Story

Reach More Readers! BOOST Your Story on HackerNoon

Meet Sekurno: HackerNoon Company of the Week

Meet the Writer: HackerNoon's Contributor Emmanuel Nwaka, Content Marketing Professional

From Desk to HackerNoon: Your Ultimate Guide on How to Publish a Story

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps