The Release of the このイニシアチブは、PHPエコシステムのパラダイム転換を象徴しています. We no longer need to rely on heavy external adapters or raw HTTP requests to build intelligent applications. Symfony は、Large Language Models (LLMs) をオーケストラリングし、文脈を管理し、ツールを実行するためのネイティブで強力な「Symfony-way」フレームワークを提供します。 Symfony AI AI Agent Component この記事では、実施するためのベストプラクティスを調べます。 Symfony 7.4 アプリケーションで、クリーンなアーキテクチャ、タイプの安全性、テスト可能性に焦点を当て、AI 機能があなたのコアビジネスロジックと同じくらい信頼できるようにします。 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エージェントの真の力は、 AIが「呼び出す」ことができる機能は、アクションを実行したり、データを取得したりすることです。 Tools ベスト・プラクティス:The #[AsTool] Attribute Array-by-array ツールを手動で登録しないでください。 これにより、コンポーネントは、LLM が要求する JSON Schema を自動的に生成できます。 #[AsTool] ベスト・プラクティス:Type Safety with 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
        );
    }
}
 このツールを使うと、 翻訳 The 厳格な JSON スケジュール LLMが「Antarctica」と呼び出そうとすると、コンポーネント(またはLLMプラットフォーム)はコードが実行される前に検証エラーを捕まえます。 Agent component OrderRegion enum Advanced Validation with #[With] タイプでない制約(regex パターンや範囲など)の場合、 アトリエーション from the 契約です。 #[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);
    }
}
 プロセッサパイプライン:Input & Output 時には、AI に移動する前にメッセージ(例えば、ダイナミックなコンテキストを追加する)または返信した後にメッセージ(例えば、出力の浄化)をキャプチャする必要があります。 コンテキスト注射(RAG Lite) 使用 1 コンテキストウィンドウに関連するデータをダイナミックに挿入します。 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 AI 統合のテストは、非決定的な出力と 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 to see your resolved agent configuration. 設定をチェックしてください。 エージェントをテスト:単純なコンソールコマンド src/Command/TestAgentCommand.phpを作成します。 Run: php bin/console app:test-agent. あなたはLLMからの回答を見るべきです。 結論 THE コンポーネントは、Symfonyの構造、安定性、開発者の経験をAI開発の混沌とした世界に持ち込んでいます。これらのベストプラクティスを遵守することで、バンドル構成を使用して、Toolsのための厳格なPHPタイプを活用し、 テスト - 今日、生産準備が整ったAIアプリケーションを構築できます。 symfony/ai-agent MockAgent スクリプトを書くだけではなく、統合され、テープセキュアで維持可能なエージェントを構築します。 完全な実装とプロジェクトの進捗状況をGitHubでご覧いただけます。 ] Source Code: https://github.com/mattleads/AIAgentSample https://github.com/mattleads/AIAgentSample Let’s Connect! これが役に立ったか、実装に関する質問があったら、あなたから聞きたいと思います. 連絡をとって、これらのプラットフォームを通じて会話を続けましょう: 
 
 
 
 
 リンク: [https://www.linkedin.com/in/matthew-mochalkin/] ツイッター(Twitter): [https://x.com/MattLeads] テレグラム: [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

このオーディオは、ストーリーの元の言語で制作されています。

Symfony AI Agents in Symfony 7.4: Best Practices for Clean Architecture, Tools, and Testing シンフォニアのAIエージェント:クリーンアーキテクチャ、ツール、テストのためのベストプラクティス

About Author

コメント

ラベル

この記事は

Related Stories

デジタルノマドの皆さん、タイの新しい DTV ビザについて知っておくべきこと

ワークフローを10倍に向上させる方法: 必須アプリ17選

海を航海する: データレイクを使用した本番環境レベルの RAG アプリケーションの開発

暗号通貨の成長: 効果的なユーザーペルソナの作成

デジタルノマドの皆さん、タイの新しい DTV ビザについて知っておくべきこと

ワークフローを10倍に向上させる方法: 必須アプリ17選

海を航海する: データレイクを使用した本番環境レベルの RAG アプリケーションの開発

暗号通貨の成長: 効果的なユーザーペルソナの作成

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps