NeboAI
NeboAI
Empezar

Flujos de trabajo

Un flujo de trabajo es trabajo que un empleado hace sin que se lo pidan: un resumen matinal, una respuesta a cada mensaje nuevo, un informe semanal. Cada flujo de trabajo combina un disparador con las actividades que realiza el empleado. Los flujos de trabajo están en el agent.json del empleado, así que viajan con el puesto.

Un primer flujo de trabajo

Añade un mapa workflows a agent.json. Cada clave da nombre a un flujo de trabajo; cada valor tiene un disparador y actividades.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Este flujo de trabajo se ejecuta a las 08:00 los días laborables, en la hora local del bot. El empleado realiza la actividad con su propia personalidad, skills y conexiones.

Campos del flujo de trabajo

CampoSignificado
triggerObligatorio. Cuándo se ejecuta el flujo de trabajo. Consulta Disparadores.
descriptionPara qué sirve el flujo de trabajo.
activitiesLos pasos. Consulta Actividades.
connectionsConexiones {from, to, label} que convierten las actividades en un grafo. __trigger__ es el inicio y __emit__ el final.
emitEventos que este flujo de trabajo anuncia al terminar: una lista o una cadena separada por comas. Consulta Eventos.
inputsValores que se pasan a cada ejecución.
budget{total_per_run, cost_estimate}. En una ejecución en grafo, total_per_run limita los tokens de salida; en los demás casos, ambos son estimaciones.
caseConvierte el flujo de trabajo en un caso de larga duración por persona o cosa. Consulta Casos.

Un flujo de trabajo con disparador y sin actividades es válido. Un watch sin actividades solo transmite sus eventos a otros flujos de trabajo.

Cómo transcurre una ejecución

Sin connections, las actividades se ejecutan en orden y el empleado realiza cada una. El resultado de cada actividad pasa a la siguiente. Una actividad sin salida termina la ejecución.

Con connections, las actividades forman un grafo. Las ramas se ejecutan en paralelo, y seis tipos de actividad se ejecutan sin el modelo: condition, loop, wait, http, command y decide. Usa un grafo cuando el enrutamiento deba ser exacto.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Qué recibe una ejecución

El empleado siempre tiene su personalidad y las respuestas del propietario a sus preguntas de inputs. Una ejecución recibe además estos valores, según su disparador.

EntradaPresente cuando
_event_source, _event_payload, _event_originSe activó un disparador de evento. Las cargas útiles de 8 KB o más se reducen a sus campos escalares, conservando las cabeceras de correo y las referencias a adjuntos.
_watch_payloadSe activó un disparador watch o de carpeta. Una línea de la salida del observador, o {files} en el caso de una carpeta.
inputsSiempre. Los valores de inputs propios del flujo de trabajo.

Casos

Algunos trabajos duran días: un contacto comercial que necesita seguimiento, una solicitud a la espera de documentos. Añade case y el flujo de trabajo mantiene un caso abierto por persona o cosa en lugar de empezar de cero cada vez.

CampoSignificado
keyObligatorio. Rutas con puntos, separadas por comas, dentro de los datos del disparador que identifican al sujeto, como contactEmail,email,phone.
typeEl tipo de caso, como lead. Los flujos de trabajo con el mismo tipo comparten casos. Por defecto, el nombre del flujo de trabajo.
default_waitCuánto esperar cuando un turno no indica espera: 3d, 12h, 45m. Tres días por defecto.

Cada turno de un caso debe terminar con un único objeto JSON y nada después. result es el estado del negocio; next indica al motor que haga wait o close. Un plazo es RFC 3339 o un intervalo relativo. Cualquier otra cosa es un turno no válido.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Límites y recuperación

  • Cada actividad puede usar hasta 50 turnos del modelo, salvo que params.maxIterations indique otra cosa.
  • En un grafo, una actividad puede ejecutarse como máximo 10.000 veces por ejecución.
  • El límite de gasto que el propietario fija para el empleado detiene una ejecución al alcanzarse. El token_budget de una actividad es una estimación.
  • Una ejecución interrumpida por un reinicio se marca como interrumpida y se reanuda una vez.
  • El empleado puede terminar una ejecución antes de tiempo con la herramienta exit.

Ejecutar y gestionar flujos de trabajo

El propietario puede ejecutar a mano cualquier flujo de trabajo. Los empleados gestionan los flujos de trabajo con run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled y las demás herramientas de flujos de trabajo que aparecen en Ayudantes y equipos.