Symfony AI 是一组组件，可将人工智能功能集成到 PHP 应用程序中。

组件与捆绑包

Symfony AI 由多个低级和高级 组件 以及相应的集成 捆绑包 组成：

• 组件
  • Agent：用于构建能够与用户交互并执行任务的人工智能代理的框架。
  • Chat：一个统一的接口，用于向代理发送消息并存储长期上下文。
  • Mate：MCP 开发服务器，使 AI 助手能够通过标准化工具与 PHP 应用程序交互。
  • Platform：一个统一的接口，用于连接 OpenAI、Anthropic、Azure、Gemini、VertexAI 等多种 AI 平台。
  • Store：面向 AI 应用的数据存储抽象层，提供索引和检索功能。
• 捆绑包
  • AI Bundle：为 AI Platform、Store 和 Agent 组件提供的 Symfony 集成。
  • MCP Bundle：为官方 MCP SDK 提供的 Symfony 集成，使其能够作为 MCP 服务器或客户端运行。

示例与演示

要开始使用 Symfony AI，您可以查看 示例，了解如何在小型代码片段中使用这些组件；或者运行 演示应用，以查看这些组件在一个完整的 Symfony Web 应用中协同工作的情况。

资源

• 文档
• 官网

赞助

请通过 赞助 Symfony 的开发来支持我们！

贡献

感谢您考虑为 Symfony AI 做出贡献！您可以在 贡献指南 中找到相关信息。

Symfony AI 快速上手指南

Symfony AI 是一套将人工智能能力集成到 PHP 应用程序中的组件库。本指南将帮助你快速在 Symfony 项目中启用 AI 功能。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统: Linux, macOS 或 Windows (WSL2 推荐)
• PHP: >= 8.2
• Symfony: >= 6.4 或 7.0+
• Composer: 最新稳定版
• AI 服务密钥: 你需要拥有至少一个主流 AI 平台的 API 密钥（如 OpenAI, Anthropic, Azure, Google Gemini 等）

安装步骤

使用 Composer 将 Symfony AI 的核心 Bundle 安装到你的项目中。该 Bundle 会自动注册平台、存储和代理组件所需的服務。

composer require symfony/ai-bundle

安装完成后，你需要配置 API 密钥。在项目根目录的 .env 文件中添加你的密钥（以 OpenAI 为例）：

OPENAI_API_KEY=sk-your-api-key-here

提示：如果你使用的是国内网络环境，建议在 .env 中同时配置代理地址以确保能正常连接海外 AI 服务，或者使用支持国内访问的兼容平台（如部分国产大模型通过 OpenAI 兼容接口接入）。

OPENAI_BASE_URL=https://api.your-provider.com/v1

基本使用

安装并配置完成后，你可以通过依赖注入在控制器或服务中直接使用 AI 功能。以下是一个最简单的聊天示例，展示如何向 AI 发送消息并获取回复。

1. 注入聊天客户端

在你的 Controller 或 Service 中，注入 ChatInterface（由 symfony/ai-bundle 自动配置）：

<?php

namespace App\Controller;

use Symfony\AI\Platform\Result\TextResult;
use Symfony\AI\Agent\AgentInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class AiDemoController extends AbstractController
{
    #[Route('/ai/chat', name: 'ai_chat')]
    public function chat(AgentInterface $agent): Response
    {
        // 定义用户消息
        $messages = [
            ['role' => 'user', 'content' => '请用一句话介绍 Symfony AI。'],
        ];

        // 调用 Agent 处理消息
        $result = $agent->call($messages);

        // 获取文本结果
        if ($result instanceof TextResult) {
            return new Response($result->getContent());
        }

        return new Response('无法获取 AI 响应', 500);
    }
}

2. 运行应用

启动你的 Symfony 本地服务器：

symfony server:start

访问 http://localhost:8000/ai/chat，你将看到 AI 返回的回答。

---

下一步建议：

• 查看 examples 目录了解更多高级用法（如多轮对话上下文、工具调用 MCP 等）。
• 阅读官方文档获取关于 Store (向量存储) 和 Mate (MCP 服务器) 的详细配置指南。