Agent V2
Agent V2 responde a cada mensaje con el modelo de IA que le conectes y usa las herramientas disponibles cuando las necesita. Recuerda la conversación entre mensajes y, si lo configuras, entrega la respuesta con unos campos fijos para que el resto del flujo la procese. El agente conoce siempre la fecha y hora actuales.
Es un componente antiguo que se mantiene por compatibilidad con flujos existentes. Para flujos nuevos usa Agent.
Existe también la variante Agent V2 With Mem Support, con los mismos campos y una conexión Memory adicional (ver más abajo).
Cuándo usarlo
- Mantener flujos existentes construidos con este agente.
- Un asistente que consulta sistemas a través de herramientas y recuerda lo que se ha hablado.
- Extraer datos de un mensaje y devolverlos con campos fijos para los pasos siguientes del flujo.
Configuración
| Conexión | Qué conectar |
|---|---|
| Model | El modelo de IA que responde. Es necesario para que el agente funcione. |
| Tools | Herramientas opcionales que el agente puede usar. |
| Campo | Qué hace |
|---|---|
| Input | El mensaje del usuario, normalmente desde Chat Input. |
| System Prompt | Las instrucciones del agente. Por defecto: “You are a helpful assistant”. |
| User Prompt | La plantilla del mensaje que recibe el agente. Por defecto: {input}, que se sustituye por el contenido de Input. Cada variable entre llaves se convierte en un campo con ese nombre. |
| Agent Name | Nombre del agente cuando lo usa otro agente o un supervisor. Por defecto: ReactAgent. |
| Agent Description | Qué hace el agente. Otro agente o un supervisor la lee para decidir cuándo usarlo. |
| State custom schema | Campos adicionales que el agente puede guardar y modificar mientras trabaja. Solo para flujos avanzados; déjalo vacío si no lo necesitas. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Structured Output Schema | Lista de campos (nombre, tipo y descripción) que debe tener la respuesta. Si la rellenas, el agente responde en formato JSON con esos campos. |
| Max Iterations | Número máximo de pasos del agente antes de detenerse. Por defecto: 10 (40 en la variante con memoria). |
| Stream | Muestra la respuesta a medida que se genera. Por defecto: desactivado. |
| Use short term memory | Guarda la conversación para que el agente recuerde los mensajes anteriores. Por defecto: activado. |
| Memory top message | Cuántos mensajes anteriores recibe el agente como contexto. -1 significa todos. Por defecto: -1. |
Variante con memoria a largo plazo
Agent V2 With Mem Support añade la conexión Memory. Si conectas en ella un componente de memoria a largo plazo, el agente recibe herramientas para guardar datos importantes del usuario, buscarlos, consultarlos todos y borrarlos, y decide por sí mismo qué merece la pena recordar.
Uso como herramienta de un agente
Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.
Resultado
- Response: la respuesta como mensaje. Si has definido Structured Output Schema, el mensaje contiene un JSON con los campos indicados. Conéctala a Chat Output o a cualquier componente que reciba texto.
- Agent: el agente configurado, para que otro agente o un supervisor delegue en él.
Ejemplo
La inmobiliaria Casas del Sur quiere clasificar las consultas que llegan por su web:
- Conecta la consulta a Input y un modelo de IA a Model.
- En System Prompt escribe: “Lee la consulta y extrae los datos del cliente.”
- En Structured Output Schema define los campos
nombre,telefono,zonaypresupuesto, cada uno con su descripción. - Conecta Response al componente que guarda la ficha en el CRM.
Cada consulta se convierte en un JSON con esos cuatro campos, listo para guardarse.
Buenas prácticas
- Describe cada campo de Structured Output Schema con claridad: el agente se guía por esa descripción para rellenarlo.
- Limita Memory top message en conversaciones muy largas para que el agente reciba solo el contexto reciente.
Componentes relacionados
- Agent: el agente recomendado para flujos nuevos.
- Supervisor Agent: reparte las peticiones entre varios agentes.