← Volver al índice de manuales Guías destacadas

Agent Workers

Agentes autónomos: flujos que combinan IA, tus bases de datos, APIs y la web para responder en varios pasos. Solo administradores.

¿Qué es un Agent Worker?

Un agente es un flujo de trabajo (diagrama) que puede:

  1. Entender el mensaje del usuario.
  2. Extraer datos (número de pedido, email).
  3. Consultar una base de datos, una API o la web.
  4. Decidir por qué camino seguir.
  5. Responder con la información recopilada.

Pensalo como un equipo de "empleados virtuales", cada uno con una tarea.

Las 3 secciones

  1. Credenciales y Secretos: claves de acceso a tus sistemas.
  2. Herramientas (Tool Registry): conexiones a tus apps y datos.
  3. Agent Flows: el editor visual donde armás los flujos.

Además, un botón "Centro de Ayuda" con documentación y ejemplos.

Credenciales y Secretos

Guardan de forma segura las claves que las herramientas necesitan (conexiones a bases de datos, claves de API).

  • + Nueva Credencial: crea una.
  • Tabla con nombre, tipo, fecha y acciones.

Tipos: conexión MongoDB (URI), clave JSON de Google (BigQuery/Sheets) y valor/secreto genérico (API keys).

Las credenciales se guardan cifradas (AES-256). Nadie las ve en texto plano. Creá primero la credencial antes de la herramienta que la usa.

Herramientas (Tool Registry)

El catálogo de conexiones que tus agentes pueden usar. Botón "+ Nueva Herramienta", buscador y tarjetas con acciones editar, probar y eliminar. Hay 9 tipos:

1. API REST — Conectar con tus Apps

El agente habla con otros programas (facturación, CRM, mensajería) por HTTP. Configura URL, método (GET/POST/PUT/PATCH), encabezados y payload.

Casos: consultar una orden en tu sistema, crear un ticket en tu CRM.

2. BigQuery — Analizar datos de Google

Ejecuta consultas sobre tus datos en Google BigQuery. Configura dataset y consulta.

Casos: "¿cuánto facturamos este mes?", reportes de ventas.

3. Búsqueda Web (Google Grounding) — Internet en vivo

Busca información actual con grounding. Configura consulta dinámica, motor y dominios restringidos.

Casos: noticias de hoy, precio de una cripto, clima actual.

4. MongoDB — Tu base documental

Consulta MongoDB. Configura base, colección, operación (find/insert/update) y plantilla JSON.

Casos: leer/escribir registros (usuarios, pedidos, catálogos).

5. SQL — Tu base relacional

Ejecuta SQL sobre bases relacionales (PostgreSQL, MySQL). Configura motor, base y consulta.

Casos: "¿cuál es el estado de mi pedido #8892?", listar clientes.

6. AI Scraper — Extraer de la web

Extrae datos de una página. Modos: AI (la IA analiza) o Script (selector CSS).

Casos: estado de un paquete en la web del correo, precio de un producto externo.

7. RAG Dirigida — Tus documentos en profundidad

Búsqueda agéntica en tu conocimiento interno, con hasta 5 preguntas iterativas. Configura consulta, Top K, profundidad y carpetas.

Casos: preguntas complejas sobre manuales donde una búsqueda no alcanza.

8. Google Sheets — Tu planilla

Lee o escribe en una hoja de Google Sheets. Configura el ID de la hoja y rango.

Casos: lista de precios, registrar respuestas, leer inventario.

9. Answer Loop — El agente que planifica

Loop que planifica y ejecuta otras herramientas para preguntas complejas. Configura pregunta, herramientas disponibles y máximo de iteraciones.

Casos: "¿cómo están las ventas?" (BigQuery + Sheets + API).

Todas las herramientas permiten usar {{ variable }} en sus campos para inyectar datos del flujo.

Agent Flows (editor de flujos)

Armás el flujo conectando nodos en un lienzo visual, con botón "Publicar Flujo". Hay 7 nodos:

  • Inicio (Trigger): recibe el mensaje del usuario.
  • LLM Extract — "El Traductor": extrae datos importantes (pedido, email).
  • Router / Condición — "El Supervisor": bifurca en Verdadero/Falso.
  • Multi-Router (Switch): múltiples rutas según una variable.
  • Ejecutar Herramienta — "El Operario": llama a una herramienta y guarda el resultado.
  • Respuesta Final — "El Portavoz": redacta la respuesta al usuario.
  • Esperar Entrada: pide más información y espera.

Variables y Memoria

Memoria compartida durante la ejecución. Usá doble llave:

# pregunta original {"query": "¿dónde está mi pedido?"} → {{ query }} # resultado de un paso anterior {{ node_id.key }}

Operadores y lógica (Routers)

  • Nativos: ==, !=, >, <, .length > 0.
  • De IA: si no usás símbolos, la IA interpreta lenguaje natural (ej. "el usuario parece enojado").

Ejemplo de flujo (e-commerce)

  1. Inicio: "¿Dónde está mi paquete #8892?"
  2. LLM Extract: extrae num_pedido = 8892.
  3. Ejecutar Herramienta (SQL): SELECT estado, fecha_entrega FROM orders WHERE order_id = '{{ num_pedido }}'.
  4. Router: estado == 'enviado' → Verdadero: fecha de entrega · Falso: aviso de problema.