NeboAI
NeboAI
Comenzar

Flujos de trabajo

Un flujo de trabajo es trabajo que un empleado hace sin que se lo pidan: un resumen por la mañana, 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 viven en el agent.json del empleado, así que viajan con el puesto.

Un primer flujo de trabajo

Agrega 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 hábiles, 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 de grafo, total_per_run limita los tokens de salida; en otro caso, 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 un disparador y sin actividades es válido. Un watch sin actividades solo retransmite sus eventos a otros flujos de trabajo.

Cómo se ejecuta una ejecución

Sin connections, las actividades se ejecutan en orden y el empleado realiza cada una. El resultado de cada actividad se 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 dueño a sus preguntas de inputs. Una ejecución también recibe estos valores, según su disparador.

EntradaPresente cuando
_event_source, _event_payload, _event_originSe activó un disparador event. Las cargas de 8 KB o más se acortan a sus campos escalares, conservando los encabezados de correo y las referencias a adjuntos.
_watch_payloadSe activó un disparador watch o folder. Una línea de la salida del observador, o {files} para una carpeta.
inputsSiempre. Los valores de inputs propios del flujo de trabajo.

Casos

Algunos trabajos duran días: un prospecto que necesita seguimiento, una solicitud que espera documentos. Agrega 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. Toma el nombre del flujo de trabajo de forma predeterminada.
default_waitCuánto esperar cuando un turno no indica espera: 3d, 12h, 45m. Predeterminado tres días.

Cada turno de un caso debe terminar con un objeto JSON y nada después. result es el estado del negocio; next le indica al motor que haga wait o close. Un plazo es RFC 3339 o un lapso 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 dueño fijó para el empleado detiene una ejecución cuando se alcanza. 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 con la herramienta exit.

Ejecutar y administrar flujos de trabajo

El dueño puede ejecutar cualquier flujo de trabajo a mano. Los empleados administran 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.