SQLAgent
SQLAgent responde preguntas sobre los datos de tu base de datos. Le escribes la pregunta con tus palabras (“¿cuáles fueron los cinco productos más vendidos en marzo?”), el agente revisa qué tablas hay, prepara la consulta, la ejecuta y te contesta con los resultados obtenidos. Si una consulta falla, la corrige y lo vuelve a intentar.
Está indicado para consultar datos, no para modificarlos: sus instrucciones le prohíben insertar, cambiar o borrar registros, y le piden responder solo con datos que haya obtenido de la base. Salvo que pidas otra cantidad, limita los resultados a diez filas.
Cuándo usarlo
- Que el equipo comercial consulte ventas por cliente, producto o fecha sin saber escribir consultas.
- Un asistente interno que responde preguntas sobre el inventario.
- Informes rápidos a partir de los datos de pedidos o reservas.
- Darle a otro agente la capacidad de consultar tu base de datos, conectándolo como herramienta.
Configuración
| Conexión | Qué conectar |
|---|---|
| Model (obligatorio) | El modelo de IA que interpreta la pregunta y prepara las consultas. |
| Database Info (obligatorio) | La base de datos que se consulta. Conecta la salida Database Info de un componente de base de datos como MySQL, Postgres SQL, SQL Server o SQLite. |
| Campo | Qué hace |
|---|---|
| Input | La pregunta que debe responder, normalmente desde Chat Input. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Extra Tools | Conexión para herramientas adicionales que el agente puede usar junto a la base de datos. |
| Handle Parse Errors | Si el modelo devuelve una respuesta con un formato inesperado, el agente intenta recuperarse en lugar de detenerse. Por defecto: activado. |
| Verbose | Registra con detalle los pasos del agente. Por defecto: activado. |
| Max Iterations | Número máximo de pasos (consultas y comprobaciones) antes de detenerse. Por defecto: 15. |
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 a la pregunta como mensaje. Conéctala a Chat Output o a cualquier componente que reciba texto.
- Agent: el agente configurado, para conectarlo a componentes que reciban un agente.
- Tool: el agente convertido en herramienta, para la entrada Tools de otro agente.
Ejemplo
La distribuidora Frutas del Valle guarda sus pedidos en una base de datos MySQL. Conecta un componente MySQL a Database Info, un modelo de IA a Model y Chat Input a Input. Desde el chat, el responsable de ventas pregunta: “¿Qué tres clientes han hecho más pedidos este trimestre?”. El agente consulta la tabla de pedidos y responde con los tres clientes y su número de pedidos.
Buenas prácticas
- Conecta la base de datos con un usuario que solo tenga permiso de lectura: así te aseguras de que no se modifica nada.
Componentes relacionados
- SQL Query Database Tool: ejecuta consultas concretas como herramienta.
- Agent: un agente general al que puedes conectar este SQLAgent como herramienta.