Agentes invocables

Los agentes invocables se ejecutan bajo demanda, activados por un nodo de workflow o una llamada API. A diferencia de los agentes autonomos (que escuchan eventos continuamente), los invocables procesan una entrada concreta y devuelven un resultado estructurado.

Como funcionan


Nodo Agent en workflow (o llamada API)
  → Invoca al agente con datos de entrada
  → Agente procesa la informacion
  → Agente devuelve resultado estructurado (JSON)
  → El workflow continua con los datos devueltos

Diferencias con agentes autonomos

Aspecto	Autonomos	Invocables
Activacion	Automatica por eventos	Manual o desde workflow
Ejecucion	Continua en segundo plano	Bajo demanda
Input	Evento del sistema	Datos pasados por el workflow
Output	Acciones ejecutadas	Datos estructurados devueltos
Uso tipico	Triaje, respuesta automatica	Extraccion de datos, preparacion

Agentes invocables disponibles

Data Extractor

Proposito: Extraer datos estructurados de documentos, emails y formularios.

Input: Documento (PDF, imagen, texto) o contenido de email.

Output: JSON con datos extraidos, estructurados por tipo:


{
  "tipo": "factura",
  "emisor": "Empresa XYZ SL",
  "nif": "B12345678",
  "fecha": "2026-03-15",
  "importe_total": 1250.00,
  "iva": 262.50,
  "base_imponible": 987.50,
  "conceptos": [
    { "descripcion": "Servicio de consultoria", "cantidad": 1, "precio": 987.50 }
  ],
  "confianza": 0.95
}

Casos de uso en workflows:

Procesar facturas de proveedores recibidas por email
Extraer datos de documentos de identidad
Digitalizar formularios rellenados a mano
Capturar informacion de contratos

Meeting Prep

Proposito: Preparar briefings previos a reuniones con contexto completo del contacto.

Input: ID del contacto y/o expediente asociado a la reunion.

Output: Briefing estructurado con:

Resumen del contacto y empresa
Historial de interacciones recientes
Expedientes abiertos y su estado
Ultimas comunicaciones relevantes
Puntos pendientes de reuniones anteriores
Sugerencias de temas a tratar

Caso de uso tipico: Un workflow programado 30 minutos antes de cada reunion invoca a Meeting Prep y envia el briefing al operador asignado por email o notificacion in-app.

Uso en workflows

Los agentes invocables se integran en workflows mediante el nodo Agent:

Arrastra un nodo Agent al canvas del workflow
Selecciona el agente invocable a utilizar
Configura los datos de entrada (variables del workflow)
Define como se utilizara el output (variables de destino)
Conecta el nodo con el resto del flujo

Ejemplo de workflow con agente invocable


Start (documento recibido por email)
  → Agent: Data Extractor (extrae datos de la factura)
  → Decision (importe > 5000?)
    → Si: Approval (aprobacion del supervisor)
    → No: User Task (registro contable directo)
  → Notification (confirmar registro al emisor)
  → End

Los agentes invocables tambien pueden llamarse directamente desde la API REST de BiVelio, permitiendo integraciones personalizadas con sistemas externos.

Crear agentes invocables personalizados

Ademas de los templates del marketplace, puedes crear agentes invocables personalizados:

Define el system prompt con las instrucciones del agente
Especifica el formato de entrada esperado
Define el formato de salida (estructura JSON)
Configura los modelos de IA y parametros (temperatura, max tokens)
Prueba con datos de ejemplo antes de integrar en workflows

Creditos

Cada ejecucion de un agente invocable consume creditos IA. El consumo depende de:

Longitud del input procesado
Complejidad del prompt
Modelo de IA utilizado
Longitud del output generado

Consumo tipico: 2-8 creditos por ejecucion.