Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Symfony : l’AI Bundle

L’AI Bundle de Symfony reprend l’idĂ©e « parler Ă  un modĂšle derriĂšre une interface propre » dans les conventions de Symfony. L’agent est configurĂ©, pas construit Ă  la main, et le fournisseur de modĂšle ne se retrouve jamais cĂąblĂ© en dur dans votre logique mĂ©tier.

composer require symfony/ai-bundle
# config/packages/ai.yaml
ai:
  platform:
    anthropic:
      api_key: '%env(ANTHROPIC_API_KEY)%'
  agent:
    support_assistant:
      model: 'claude-sonnet'
      system_prompt: 'You are a concise, friendly support assistant.'
final class TicketSummaryController
{
    public function __construct(private AgentInterface $supportAssistant) {}

    public function summarize(Ticket $ticket): Response
    {
        $result = $this->supportAssistant->call(
            new UserMessage("Summarize this ticket:\n\n{$ticket->getBody()}"),
        );

        return new JsonResponse(['summary' => $result->getContent()]);
    }
}

Changer de modĂšle ou de fournisseur pour une fonctionnalitĂ©, c’est une ligne de YAML. Dans les tests, l’outillage de Symfony (voir Livrer de la confiance) substitue un faux agent, et aucune vraie API n’est jamais appelĂ©e.

Quand le choisir

Un projet Symfony qui ajoute une fonctionnalitĂ© IA, quand la cohĂ©rence avec la configuration et l’injection de dĂ©pendances de l’application compte, ou quand l’équipe veut pouvoir changer de fournisseur ou simuler l’appel dans les tests sans y passer la journĂ©e.

Quand ce n’est pas le bon outil

Un petit script, ou un projet qui n’est pas sous Symfony. Là, la couche de configuration du bundle demande plus de mise en place qu’un appel direct à l’API HTTP du fournisseur avec Guzzle.

Sous le capot : l’AgentInterface du bundle, c’est encore de l’injection de dĂ©pendances par interface : le conteneur de services de Symfony fournit Ă  votre contrĂŽleur l’implĂ©mentation d’agent configurĂ©e, par le mĂȘme mĂ©canisme qu’il utilise pour injecter une connexion Ă  la base ou un logger.