ослободувањето на Иницијативата означува промена на парадигмата за PHP екосистемот. Ние повеќе не треба да се потпираат на тешки надворешни адаптери или сурови HTTP барања за да се изгради интелигентни апликации. Symfony обезбедува матична, цврста и симфониска рамка за оркестрирање на големи јазични модели (LLMs), управување со контекст и извршување на алатки. Symfony AI AI Agent Component Во оваа статија ќе ги истражуваме најдобрите практики за имплементација на Ние ќе се фокусираме на чиста архитектура, безбедност на типот и тестираност - обезбедување на вашите карактеристики за вештачка интелигенција да бидат исто толку сигурни како вашата основна деловна логика. symfony/ai-agent Инсталација и архитектура Додека можете да го инсталирате standalone Библиотеката, Најдобрата пракса за апликација на Симфонија е да се користи Овој пакет ги интегрира компонентите на агентот, платформата и складиштето директно во сервисниот контејнер, овозможувајќи моќна конфигурација и инјекција на зависност. symfony/ai-agent AI Bundle composer require symfony/ai-bundle symfony/ai-agent
 конфигурација Наместо рачно да ги инстантирате класите агент во контролорите, конфигурирајте ги во Ова го централизира вашиот избор на модел и управување со 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.'
 Зависност инјекција и основна употреба Никогаш не користете нов агент во кодот на вашата апликација. Пакетот ги споделува вашите конфигурирани агенти со . 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();
    }
}
 Моќта на алатките: проширување на интелигенцијата Вистинската моќ на AI агентите лежи во Функции кои вештачката интелигенција може да ги „повика“ за да изврши акции или да ги извлече податоците. Tools Најдобра пракса: Атрибутот #[AsTool] Избегнувајте рачно да ги регистрирате алатките array-by-array. Ова му овозможува на компонентата автоматски да ја генерира JSON шемата потребна од LLM. #[AsTool] Најдобра пракса: Безбедност на типот со Enums Една од најсилните карактеристики на компонентата на Symfony AI е нејзината способност да ги заклучи правилата за валидација од типовите на PHP. Користете Backed Enums за строго да ги ограничите изборите што може да ги направи 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
        );
    }
}
 Кога ја користите оваа алатка, Преведувајте го Внесете ја строгата JSON шема Ако LLM се обиде да го нарече со "Антарктик", компонентата (или платформата LLM) ќе ја фати грешката за валидација пред вашиот код дури и да работи. Agent component OrderRegion enum Напредно валидирање со #[With] За ограничувања кои не се типови (како што се моделите на regex или опсегот), користете атрибути од Договорот е #[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);
    }
}
 Преработувачки цевки: влез и излез Понекогаш треба да ги пресретнете пораките пред да одат на АИ (на пример, за да додадете динамичен контекст) или откако ќе се вратат (на пример, за да го исчистите излезот). Контекстна инјекција (RAG Lite) Користете го да ги вметнете релевантните податоци во контекстниот прозорец динамички. 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())
            );
        }
    }
}
 Регистрирајте го овој процесор во вашиот ai.yaml или рачно да го поврзете ако градите сложени синџири. Ознака: The MockAgent Тестирањето на интегрирањето на АИ е познато тешко поради не-детерминистичките излези и трошоците за API. . MockAgent Никогаш не ги погоди вистинските API во вашите единици / карактеристики тестови. 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?');
    }
}
 За да проверите дали вашата инсталација работи правилно во Symfony 7.4 животната средина: 
 
 
 
 Проверете Configuration: Run php bin/console debug:config ai за да ја видите вашата решена агентна конфигурација. Тестирајте го агентот: Креирајте едноставна команда на конзолата src/Command/TestAgentCommand.php. Run: php bin/console app:test-agent. треба да видите одговор од LLM. Заклучоци на Компонентот ја носи структурата, стабилноста и искуството на програмерите на Symfony во хаотичниот свет на развојот на АИ. Со следење на овие најдобри практики – користејќи ја конфигурацијата на Bundle, искористување на строгите PHP типови за алатки и користење на за тестирање – денес можете да креирате апликации за вештачка интелигенција подготвени за производство. symfony/ai-agent MockAgent Не само да пишувате скрипти; изградете агенти кои се интегрирани, безбедни за пишување и одржливи. Можете да ја најдете целосната имплементација и да го следите напредокот на проектот на GitHub: [ ] Source Code: https://github.com/mattleads/AIAgentSample https://github.com/mattleads/AIAgentSample Let’s Connect! Ако го најдовте ова корисно или имате прашања за имплементацијата, би сакал да слушам од вас. 
 
 
 
 
 LinkedIn: [https://www.linkedin.com/in/matthew-mochalkin/] Социјална мрежа (Twitter): [https://x.com/MattLeads] Телеграм: [https://t.me/MattLeads] ГитХуб: [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

Ова аудио е произведено на оригиналниот јазик на приказната!

Symfony AI агенти во Symfony 7.4: најдобри практики за чиста архитектура, алатки и тестирање

About Author

КОМЕНТАРИ

ВИСЕТЕ ТАГОВИ

ОВОЈ СТАТИЈА БЕШЕ ПРЕТСТАВЕН ВО

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps