# Symfony AI 1.0 beta: agentes, RAG y MCP en un proyecto PHP

> Symfony AI 1.0 Beta llega el 26 de octubre de 2026: agentes PHP, RAG y MCP. Instalación, casos de uso SaaS, límites de la beta y precauciones en producción.

IA y desarrollo · Symfony AI

## Symfony AI 1.0 beta: agentes, RAG y MCP en un proyecto PHP

La primera beta de Symfony AI 1.0 acerca los agentes PHP, la búsqueda RAG y la integración MCP. Arquitectura de negocio, ejemplo de código y precauciones antes de pasar a producción.

![Symfony-AI-Beta-Tech-Dashboard.webp](https://sdx-development.com/media/News/Symfony-AI-Beta-Tech-Dashboard.webp?v=1793048385)

[IA y desarrollo](https://sdx-development.com/es/noticias/ia-desarrollo)Publicado el 26 de octubre de 2026 a las 22:02

¿Y si un SaaS PHP pudiera encontrar un procedimiento en sus documentos, responder a una pregunta de negocio y llamar a un servicio interno sin tener que combinar varias integraciones de IA? Con **Symfony AI 1.0.0-BETA1**, el ecosistema Symfony consolida un conjunto de componentes para conectar modelos, agentes, búsqueda RAG y Model Context Protocol (MCP).

 

**El 26 de octubre de 2026**, Symfony publica su primera beta en el camino hacia la versión 1.0. El equipo señala que el alcance funcional de esta versión 1.0 ya está fijado: las próximas semanas servirán para probar y corregir, en lugar de añadir grandes funcionalidades. Se trata de un **lanzamiento efectivo en beta**, todavía no de una versión estable.

 

Para los desarrolladores Symfony y las empresas que mantienen software de gestión, el interés es sobre todo arquitectónico: integrar la IA como un servicio de la aplicación, con una configuración común, herramientas PHP reutilizables y derechos de acceso controlados.

 

Puntos clave 

## Agentes de IA en PHP, pero la versión 1.0 aún está en preparación

 

Symfony AI reúne abstracciones para proveedores de modelos, **agentes con herramientas**, conversaciones y **búsqueda aumentada (RAG)**. MCP Bundle facilita la exposición o el uso de herramientas mediante MCP. **La compatibilidad con versiones anteriores solo estará garantizada a partir de la versión 1.0 final.**

 

**En este artículo** 

[El anuncio](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#annonce)[Los componentes](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#briques)[Caso de negocio](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#architecture)[Ejemplo PHP](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#exemple)[MCP](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#mcp)[¿Conviene migrar?](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#comparaison)[Precauciones](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#risques)[Preguntas frecuentes](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#questions)[Fuentes](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php#sources)

 

## Symfony AI 1.0 Beta: qué hay realmente de nuevo

 

Symfony AI no aparece de repente el 26 de octubre: sus componentes y su integración MCP ya se habían desarrollado y documentado. **La novedad es el paso a una primera versión preliminar 1.0**, que marca una etapa de consolidación del proyecto.

 

La documentación indica que los componentes pueden utilizarse por separado o en el contenedor de servicios de Symfony. Por tanto, la beta facilita la preparación de prototipos más estructurados, pero no garantiza que todas las firmas de la API permanezcan sin cambios.

 

Symfony también organiza un **hackathon de IA y MCP del 26 de octubre al 22 de noviembre de 2026**. Los participantes deben presentar un proyecto funcional que utilice Symfony AI y el SDK oficial MCP para PHP, que también está en camino hacia la versión 1.0. El objetivo anunciado es detectar errores y conocer usos reales antes del lanzamiento final, cuya fecha aún no se ha anunciado oficialmente.

 

Estado de la versión 

## Beta hoy, API estable más adelante

 

Symfony anuncia que las garantías de compatibilidad con versiones anteriores comenzarán con la versión 1.0.0 final, no con esta beta. Para una aplicación en producción, hay que probar las actualizaciones en un entorno aislado y prever que algunos detalles de integración puedan cambiar.

 

## Platform, Agent, Store y MCP: ¿para qué sirven los componentes?

 

Symfony AI no es un nuevo gran modelo de lenguaje. Es una **capa de integración PHP** que permite a la aplicación comunicarse con proveedores de IA, orquestar herramientas y utilizar sus propios datos.

 

| Componente | Función | Caso concreto |
| --- | --- | --- |
| **Platform** | Unificar las interacciones con distintos proveedores y modelos. | Usar OpenAI, Anthropic, Gemini u Ollama según la necesidad. |
| **Agent** | Combinar mensajes, instrucciones y llamadas a herramientas. | Consultar un pedido mediante una función PHP autorizada. |
| **Chat** | Gestionar las conversaciones y su historial. | Conservar el contexto de las conversaciones de atención al cliente. |
| **Store** | Indexar y recuperar documentos, en particular mediante búsqueda vectorial. | Encontrar procedimientos internos para un RAG. |
| **AI Bundle** | Configurar e inyectar los componentes en una aplicación Symfony. | Declarar plataformas, agentes y stores en ` ai.yaml `. |
| **MCP Bundle** | Exponer o utilizar herramientas y recursos MCP. | Compartir una capacidad de negocio con un asistente compatible. |

 

La posible ventaja es la coherencia del desarrollo: se mantienen las prácticas habituales de Symfony —servicios, inyección de dependencias, configuración y pruebas— en lugar de dispersar las llamadas HTTP a los proveedores entre los controladores.

 

Pero conviene tener en cuenta las diferencias entre modelos: no todos ofrecen las mismas posibilidades de *tool calling*, formatos multimodales, límites de contexto ni precios. Una interfaz común no hace que estos comportamientos sean intercambiables.

 

## Un ejemplo útil: un asistente documental conectado a un software de gestión

 

Imaginemos un SaaS B2B en el que los empleados consultan procedimientos, fichas de producto y el estado de sus expedientes. Un asistente convencional quizá no pueda responder a partir de la información propia de la empresa. El reto es proporcionarle el contexto adecuado sin darle acceso a todos los datos.

 

## Seis pasos para diseñar el flujo

 
1. **Identificar al usuario y su organización.** Comprobar los permisos y el ámbito del cliente antes de cualquier búsqueda.
2. **Indexar las fuentes autorizadas.** Dividir los documentos y crear los embeddings asociados a los fragmentos.
3. **Recuperar la información útil.** Consultar el índice mediante un retriever y conservar la procedencia de los extractos.
4. **Crear una respuesta con fuentes.** Proporcionar al modelo los fragmentos seleccionados e indicarle que señale la información que no encuentre.
5. **Utilizar herramientas PHP específicas.** Por ejemplo, consultar el estado de un expediente mediante un servicio de negocio existente, sin exponer toda la base de datos.
6. **Validar las operaciones sensibles.** Una modificación, un envío o un pago debe someterse a las reglas de negocio y, si es necesario, a la confirmación de una persona.

 

El **RAG** (Retrieval-Augmented Generation) consiste en recuperar los fragmentos pertinentes antes de generar una respuesta. Symfony AI documenta vectorizers, stores, indexers, retrievers y una herramienta de búsqueda por similitud que puede utilizar un agente.

 

El punto fundamental de atención sigue siendo el control de acceso: los documentos deben filtrarse **antes** de enviarlos al modelo. Un simple mensaje como «no reveles los datos de otros clientes» no garantiza el aislamiento entre tenants.

 

## Empezar con Symfony AI 1.0 Beta: instalación y primer servicio

 

El comando de prueba publicado en el anuncio oficial es:

 

```
composer require 'symfony/ai-bundle:^1.0@beta'
```

 

Según las funcionalidades utilizadas, quizá se necesiten otros paquetes de la familia Symfony AI. La documentación incluye el siguiente ejemplo para declarar un proveedor y un agente. El nombre del modelo que aparece a continuación es **un marcador que debe sustituirse** por un modelo compatible que esté realmente disponible con tu proveedor:

 

```
# config/packages/ai.yaml
ai:
    platform:
        openai:
            api_key: '%env(OPENAI_API_KEY)%'
    agent:
        default:
            model: 'MODELE_COMPATIBLE'
```

 

A continuación, se puede inyectar la interfaz ` AgentInterface ` en un servicio PHP. Esta es una estructura mínima basada en la API documentada:

 

```
<?php

namespace App\Service;

use Symfony\AI\Agent\AgentInterface;
use Symfony\AI\Platform\Message\Message;
use Symfony\AI\Platform\Message\MessageBag;

final readonly class AssistantMetier
{
    public function __construct(
        private AgentInterface $agent,
    ) {}

    public function repondre(string $question): string
    {
        $messages = new MessageBag(
            Message::ofUser($question),
        );

        return $this->agent->call($messages)->getContent();
    }
}
```

 

Este ejemplo solo muestra la llamada a un agente. **Todavía no es un RAG ni un servicio listo para producción.** Hay que desarrollar el índice documental, los permisos de acceso, la gestión de errores, los costes, las pruebas y la supervisión. La guía oficial *AI Bundle Fast Track* explica en detalle cómo conectar stores y herramientas de búsqueda.

 

## MCP: conectar un agente Symfony con las funciones de una aplicación

 

**Model Context Protocol (MCP)** describe cómo un cliente puede descubrir y utilizar herramientas y recursos ofrecidos por un servidor. No sustituye a los servicios PHP, a un modelo de lenguaje ni a los controles de autorización.

 

Con el SDK oficial MCP para PHP ` mcp/sdk ` y **Symfony MCP Bundle**, una aplicación puede actuar como servidor (exponiendo herramientas, recursos o prompts) o como cliente (consumiendo un servidor MCP remoto), a través de HTTP o STDIO.

 

Servidor MCP 

### Exponer una capacidad específica

 

Una aplicación de negocio puede ofrecer, por ejemplo, «buscar un expediente», sin dar acceso directo y general a su base de datos. El servicio PHP conserva el control de los permisos.

 

Cliente MCP 

### Reutilizar una herramienta remota

 

Un agente Symfony puede consultar un servidor MCP autorizado para enriquecer su contexto o realizar una operación prevista en el recorrido del usuario.

 

La ventaja es reutilizar una interfaz de herramienta en lugar de desarrollar una integración propia para cada asistente. **Sin embargo, MCP no es una capa de seguridad automática**: hay que limitar las capacidades expuestas, validar los parámetros, gestionar la identidad y registrar las acciones.

 

## Symfony AI o integración directa de API: ¿qué conviene para un SaaS?

 

Para un prototipo que llama a un único modelo desde una pantalla aislada, utilizar directamente el SDK del proveedor puede seguir siendo una opción sencilla y suficiente. Symfony AI resulta especialmente interesante cuando el producto debe combinar varias responsabilidades: agentes, herramientas, memoria, búsqueda documental, distintos modelos o interoperabilidad con MCP.

 

Enfoque directo 

### Pocas dependencias arquitectónicas

 

Adecuado para una funcionalidad sencilla y acotada. Las particularidades del proveedor siguen visibles en el código, lo que puede resultar costoso cuando se multiplican los usos.

 

Symfony AI 

### Una base común para varios usos

 

Útil para reutilizar la configuración, los agentes, las herramientas y los pipelines RAG. A cambio, el equipo debe dominar el stack y seguir su evolución durante la beta.

 

## Precauciones que conviene tomar antes de pasar a producción

 
- **Estabilidad:** fijar las versiones, probar los cambios de paquetes y evitar depender de API beta sin una estrategia de actualización.
- **Autorizaciones:** filtrar los datos y las herramientas en cada solicitud, especialmente en un SaaS multi-tenant.
- **Acciones sensibles:** exigir validaciones explícitas para las eliminaciones, modificaciones, envíos o pagos; Symfony documenta un mecanismo de confirmación humana para las llamadas a herramientas.
- **Fiabilidad:** probar las respuestas sin fuentes, los errores de red, las alucinaciones y la inyección de instrucciones en los documentos indexados.
- **Costes y operación:** medir los tokens, embeddings, almacenamiento, llamadas a herramientas, tiempos de respuesta y errores. Una biblioteca PHP no elimina los costes de los proveedores externos.
 

Conviene distinguir 

## Un stack PHP unificado no significa que la IA sea local

 

Symfony AI puede utilizar modelos locales compatibles, pero las integraciones con proveedores remotos envían datos a dichos proveedores según la configuración. El alojamiento, la privacidad y la residencia de los datos se deciden en el conjunto de la arquitectura.

 

**Nuestra valoración:** probar Symfony AI 1.0 Beta desde hoy tiene sentido para un prototipo RAG o un agente de negocio con permisos limitados. Para una aplicación crítica, el mejor primer paso es un proyecto piloto con métricas y conjuntos de pruebas, antes de hacer un cambio generalizado. El lanzamiento final aún está pendiente de confirmación oficial.

 

## Preguntas frecuentes: Symfony AI 1.0 Beta

 

¿Symfony AI 1.0 ya es estable?

 

No. La primera beta se publicó el 26 de octubre de 2026. La garantía de compatibilidad con versiones anteriores comenzará con la versión 1.0 final, cuya fecha aún no se ha anunciado.

 

¿Se puede crear un agente de IA en PHP sin Node.js?

 

Sí. Symfony AI ofrece componentes PHP para comunicarse con modelos, gestionar agentes y proporcionarles herramientas. Los servicios externos que se utilicen también deben configurarse.

 

¿MCP y RAG sirven para lo mismo?

 

No. RAG sirve para recuperar información pertinente de un corpus. MCP estandariza el acceso a herramientas y recursos ofrecidos por un servidor. Ambos pueden combinarse en una misma aplicación.

 

¿Cuánto cuesta un proyecto Symfony AI?

 

Depende de los modelos elegidos, el volumen de solicitudes, los embeddings, el almacenamiento y la operación. No existe un coste universal: el presupuesto debe calcularse a partir de un caso de uso real.

 

## Fuentes oficiales

 
- [Symfony Blog — Symfony AI 1.0.0-BETA1 + AI & MCP Hackathon](https://symfony.com/blog/symfony-ai-1-0-0-beta1-ai-and-mcp-hackathon), anuncio del 26 de octubre de 2026.
- [Symfony Docs — Descripción general de Symfony AI](https://symfony.com/doc/current/ai/index.html), componentes y funcionalidades.
- [Symfony Docs — AI Bundle Fast Track](https://symfony.com/doc/current/ai/cookbook/ai-bundle-fast-track.html), configuración de agentes y pipeline RAG.
- [Symfony Docs — MCP Bundle](https://symfony.com/doc/current/ai/bundles/mcp-bundle.html), servidor y cliente MCP.
- [Symfony Docs — Human-in-the-Loop](https://symfony.com/doc/current/ai/cookbook/human-in-the-loop.html), validación de llamadas a herramientas.
- [Symfony — AI & MCP Hackathon](https://symfony.com/hackathon), del 26 de octubre al 22 de noviembre de 2026.

IA Y DESARROLLO

## Convierte los anuncios sobre IA en integraciones útiles.

Elección del modelo, costes reales, calidad de las respuestas, seguridad e integración: construyamos un caso de uso medible, no una demostración aislada.

- Arquitectura adaptada a tus datos
- Costes de API y operación previstos
- Evaluación antes de la puesta en producción

[Háblame de tu caso de uso](https://sdx-development.com/es/contacto)[Explorar IA y RAG](https://sdx-development.com/es/ia-rag-automatizacion)

---

[Consultar la página HTML](https://sdx-development.com/es/noticias/ia-desarrollo/symfony-ai-1-0-beta-agents-rag-mcp-php)
