La liberación de la La iniciativa marca un cambio de paradigma para el ecosistema PHP. Ya no necesitamos depender de adaptadores externos pesados o solicitudes HTTP en bruto para construir aplicaciones inteligentes. , Symfony proporciona un marco nativo, robusto y "Symfony-way" para la orquestación de Grandes Modelos de Idiomas (LLMs), la gestión del contexto y la ejecución de herramientas. Symfony AI AI Agent Component En este artículo, analizaremos las mejores prácticas para implementar En una aplicación de Symfony 7.4, nos centraremos en la arquitectura limpia, la seguridad del tipo y la probabilidad, asegurando que sus características de IA sean tan fiables como su lógica de negocio principal. symfony/ai-agent Instalación y arquitectura Puedes instalar el standalone bibliotecas, la mejor práctica para una aplicación Symfony es usar el Este paquete integra el agente, la plataforma y los componentes de almacenamiento directamente en el contenedor de servicio, permitiendo una poderosa configuración e inyección de dependencia. symfony/ai-agent AI Bundle composer require symfony/ai-bundle symfony/ai-agent
 Configuración En lugar de instantizar manualmente las clases de agente en sus controladores, configurelas en Esto centralizará su selección de modelos y la gestión de claves de 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.'
 Dependencia Injeción y uso básico Nunca utilice un nuevo agente(...) dentro de su código de aplicación. El paquete aliesa sus agentes configurados con el . 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();
    }
}
 El poder de las herramientas: ampliando la inteligencia El verdadero poder de los agentes de IA está en - Funciones que la IA puede "chamar" para realizar acciones o recuperar datos. Tools Mejor práctica: el atributo #[AsTool] Evite registrar manualmente las herramientas array-by-array. Esto permite al componente generar automáticamente el esquema JSON requerido por el LLM. #[AsTool] Mejor práctica: Seguridad de tipo con Enums Una de las características más fuertes del componente de Symfony AI es su capacidad de inferir reglas de validación de tipos PHP. Use Backed Enums para limitar estrictamente las opciones que puede hacer un AI. Esto evita la "hallucinación" 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
        );
    }
}
 Cuando se utiliza esta herramienta, el Traduce el Enum en un esquema JSON estricto Si el LLM intenta llamarlo con "Antarctica", el componente (o la plataforma LLM) atrapará el error de validación antes de que su código sea ejecutado. Agent component OrderRegion enum Validación avanzada con #[With] Para las restricciones que no son tipos (como patrones de regex o intervalos), utilice el El atributo de la El 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);
    }
}
 Procesamiento de tuberías: Input & Output A veces es necesario interceptar los mensajes antes de que vayan a la IA (por ejemplo, para agregar contexto dinámico) o después de que vuelvan (por ejemplo, para sanitar la salida). Injeción de contexto (RAG Lite) Utilice un para inyectar datos relevantes en la ventana de contexto de forma dinámica. 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())
            );
        }
    }
}
 Registra este procesador en tu ai.yaml o fíeslo manualmente si estás construyendo cadenas complejas. Categoría: The MockAgent Testar integraciones de IA es notoriamente difícil debido a la salida no determinista y los costos de API. . MockAgent Nunca golpees las API reales en tus pruebas de unidad/función. 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 si la configuración está funcionando correctamente en un entorno de Symfony 7.4: 
 
 
 
 Compruebe Configuración: Execute php bin/console debug:config ai para ver la configuración de su agente resuelto. Pruebe el Agente: Cree un simple comando de consola src/Command/TestAgentCommand.php. Run: php bin/console app:test-agent. Deberías ver una respuesta del LLM. Conclusiones El Componente trae la estructura, la estabilidad y la experiencia de desarrollador de Symfony al mundo caótico del desarrollo de IA. Al seguir estas mejores prácticas - utilizando la configuración de Bundle, aprovechando los estrictos tipos de PHP para herramientas y utilizando para la prueba: puede construir aplicaciones de IA listas para la producción hoy. symfony/ai-agent MockAgent No solo escriba scripts; construya agentes que sean integrados, seguros de tipo y mantenibles. Puedes encontrar la implementación completa y seguir el progreso del proyecto en GitHub: [ ] Source Code: https://github.com/mattleads/AIAgentSample https://github.com/mattleads/AIAgentSample Let’s Connect! Si ha encontrado esto útil o tiene preguntas sobre la implementación, me encantaría escuchar de usted. 
 
 
 
 
 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 audio es producido en el idioma original de la historia!

Agentes de IA de Symfony en Symfony 7.4: mejores prácticas para la arquitectura limpia, herramientas y pruebas

About Author

COMENTARIOS

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN

Related Stories

Valhalla de Floki se une como patrocinador asociado de la gira de la India por Sri Lanka

Creación de productos criptográficos centrados en el usuario: la importancia de los comentarios de los clientes

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

Las capas invisibles: por qué las entrevistas con los usuarios son un activo irremplazable

Valhalla de Floki se une como patrocinador asociado de la gira de la India por Sri Lanka

Creación de productos criptográficos centrados en el usuario: la importancia de los comentarios de los clientes

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

Las capas invisibles: por qué las entrevistas con los usuarios son un activo irremplazable

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps