Agents invocables

Els agents invocables s’executen sota demanda, activats per un node de workflow o una crida API. A diferència dels agents autònoms (que escolten esdeveniments contínuament), els invocables processen una entrada concreta i retornen un resultat estructurat.

Com funcionen


Node Agent en workflow (o crida API)
  → Invoca l'agent amb dades d'entrada
  → Agent processa la informació
  → Agent retorna resultat estructurat (JSON)
  → El workflow continua amb les dades retornades

Diferències amb agents autònoms

Aspecte	Autònoms	Invocables
Activació	Automàtica per esdeveniments	Manual o des de workflow
Execució	Contínua en segon pla	Sota demanda
Input	Esdeveniment del sistema	Dades passades pel workflow
Output	Accions executades	Dades estructurades retornades
Ús típic	Triatge, resposta automàtica	Extracció de dades, preparació

Agents invocables disponibles

Data Extractor

Propòsit: Extreure dades estructurades de documents, emails i formularis.

Input: Document (PDF, imatge, text) o contingut d’email.

Output: JSON amb dades extretes, estructurades per tipus:


{
  "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 d’ús en workflows:

Processar factures de proveïdors rebudes per email
Extreure dades de documents d’identitat
Digitalitzar formularis emplenats a mà
Capturar informació de contractes

Meeting Prep

Propòsit: Preparar briefings previs a reunions amb context complet del contacte.

Input: ID del contacte i/o expedient associat a la reunió.

Output: Briefing estructurat amb:

Resum del contacte i empresa
Historial d’interaccions recents
Expedients oberts i el seu estat
Últimes comunicacions rellevants
Punts pendents de reunions anteriors
Suggeriments de temes a tractar

Cas d’ús típic: Un workflow programat 30 minuts abans de cada reunió invoca Meeting Prep i envia el briefing a l’operador assignat per email o notificació in-app.

Ús en workflows

Els agents invocables s’integren en workflows mitjançant el node Agent:

Arrossega un node Agent al canvas del workflow
Selecciona l’agent invocable a utilitzar
Configura les dades d’entrada (variables del workflow)
Defineix com s’utilitzarà l’output (variables de destinació)
Connecta el node amb la resta del flux

Exemple de workflow amb agent invocable


Start (document rebut per email)
  → Agent: Data Extractor (extreu dades de la factura)
  → Decision (import > 5000?)
    → Sí: Approval (aprovació del supervisor)
    → No: User Task (registre comptable directe)
  → Notification (confirmar registre a l'emissor)
  → End

Els agents invocables també es poden cridar directament des de l’API REST de BiVelio, permetent integracions personalitzades amb sistemes externs.

Crear agents invocables personalitzats

A més dels templates del marketplace, pots crear agents invocables personalitzats:

Defineix el system prompt amb les instruccions de l’agent
Especifica el format d’entrada esperat
Defineix el format de sortida (estructura JSON)
Configura els models de IA i paràmetres (temperatura, max tokens)
Prova amb dades d’exemple abans d’integrar en workflows

Crèdits

Cada execució d’un agent invocable consumeix crèdits IA. El consum depèn de:

Longitud de l’input processat
Complexitat del prompt
Model de IA utilitzat
Longitud de l’output generat

Consum típic: 2-8 crèdits per execució.