A libertação do A iniciativa marca uma mudança de paradigma para o ecossistema PHP. Nós não precisamos mais depender de adaptadores externos pesados ou pedidos HTTP brutos para construir aplicativos inteligentes. A Symfony fornece um framework nativo, robusto e “Symfony-way” para orquestração de Grandes Modelos de Língua (LLMs), gerenciamento de contexto e execução de ferramentas. Symfony AI AI Agent Component Neste artigo, iremos explorar as melhores práticas para a implementação Nós nos concentraremos em arquitetura limpa, segurança de tipo e testabilidade – garantindo que seus recursos de IA sejam tão confiáveis quanto sua lógica de negócios central. symfony/ai-agent Instalação & Arquitetura Enquanto você pode instalar o standalone bibliotecas, a melhor prática para um aplicativo Symfony é usar o Este pacote integra o agente, a plataforma e os componentes de armazenamento diretamente no recipiente de serviço, permitindo uma poderosa configuração e injeção de dependência. symfony/ai-agent AI Bundle composer require symfony/ai-bundle symfony/ai-agent
 Configuração Em vez de instanciar manualmente as classes de agente em seus controladores, configure-as em Isso centraliza sua seleção de modelo e gerenciamento de chaves da 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.'
 Injeção de dependência e uso básico Nunca use um novo Agente(...) dentro do seu código de aplicação. O pacote alia seus agentes configurados para o . 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();
    }
}
 O poder das ferramentas: expandindo a inteligência O verdadeiro poder dos agentes de IA está em — funções que a IA pode “chamar” para realizar ações ou recuperar dados. Tools Melhores práticas: o atributo #[AsTool] Evite registrar manualmente as ferramentas array-by-array. Isso permite ao componente gerar automaticamente o esquema JSON exigido pelo LLM. #[AsTool] Melhor Prática: Segurança de Tipo com Enums Uma das características mais fortes do componente da Symfony AI é a sua capacidade de inferir regras de validação a partir de tipos PHP.Use Backed Enums para restringir estritamente as escolhas que uma IA pode fazer.Isso impede a "alucinação" de parâmetros inválidos. 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
        );
    }
}
 Ao utilizar esta ferramenta, o Traduza o Enum em um esquema JSON rígido Se o LLM tentar chamá-lo com “Antarctica”, o componente (ou a plataforma LLM) vai pegar o erro de validação antes mesmo de seu código correr. Agent component OrderRegion enum Validação Avançada com #[With] Para restrições que não são tipos (como padrões de regex ou intervalos), use o Atributos da do contrato. #[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);
    }
}
 Processamento de gasodutos: Input & Output Às vezes você precisa interceptar mensagens antes que elas vão para a IA (por exemplo, para adicionar contexto dinâmico) ou depois que elas retornam (por exemplo, para sanitar a saída). Injeção de Contexto (RAG Lite) Use um para injetar dados relevantes na janela de contexto dinamicamente. 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())
            );
        }
    }
}
 Registe este processador em seu ai.yaml ou fio-o manualmente se você estiver construindo cadeias complexas. Título original: The MockAgent Testar integrações de IA é notoriamente difícil devido a saídas não-deterministas e custos da API. . MockAgent Nunca toque em APIs reais em seus testes de unidade/feature. 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?');
    }
}
 Para verificar se a instalação está a funcionar corretamente em um ambiente Symfony 7.4: 
 
 
 
 Verifique Configuração: Execute php bin/console debug:config ai para ver a sua configuração de agente resolvida. Teste o Agente: Crie um simples comando console src/Command/TestAgentCommand.php. Run: php bin/console app:test-agent. Você deve ver uma resposta do LLM. Conclusões O O componente traz a estrutura, a estabilidade e a experiência do desenvolvedor da Symfony para o mundo caótico do desenvolvimento de IA. Ao seguir essas melhores práticas – usando a configuração do Bundle, aproveitando tipos PHP rigorosos para Ferramentas e utilizando para testes – você pode construir aplicações de IA prontas para produção hoje. symfony/ai-agent MockAgent Não apenas escreva scripts; crie agentes que sejam integrados, seguros de tipo e mantidos. Você pode encontrar a implementação completa e acompanhar o progresso do projeto no GitHub: [ ] Source Code: https://github.com/mattleads/AIAgentSample https://github.com/mattleads/AIAgentSample Let’s Connect! Se você achou isso útil ou tiver perguntas sobre a implementação, eu gostaria de ouvir de você. 
 
 
 
 
 Linkedin: [https://www.linkedin.com/in/matthew-mochalkin/] X (Twitter): [https://x.com/MattLeads] Telegrama: [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

Este áudio é produzido no idioma original da história!

Agentes de IA da Symfony na Symfony 7.4: melhores práticas para arquitetura limpa, ferramentas e testes

About Author

COMENTARIOS

Rótulos

ESTE ARTIGO FOI APRESENTADO EM

Related Stories

Toque para ganhar: Telegram pode integrar os próximos 10 bilhões de usuários criptográficos antes de Solana

Digital Nomads Ouçam: O que você precisa saber sobre o novo visto DTV da Tailândia

Telegram: a ponte da Crypto Island para o continente

Como melhorar seu fluxo de trabalho em 10 vezes: 17 aplicativos essenciais

Toque para ganhar: Telegram pode integrar os próximos 10 bilhões de usuários criptográficos antes de Solana

Digital Nomads Ouçam: O que você precisa saber sobre o novo visto DTV da Tailândia

Telegram: a ponte da Crypto Island para o continente

Como melhorar seu fluxo de trabalho em 10 vezes: 17 aplicativos essenciais

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps