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
| Campo | Significado |
|---|---|
trigger | Obligatorio. Cuándo se ejecuta el flujo de trabajo. Consulta Disparadores. |
description | Para qué sirve el flujo de trabajo. |
activities | Los pasos. Consulta Actividades. |
connections | Conexiones {from, to, label} que convierten las actividades en un grafo. __trigger__ es el inicio y __emit__ el final. |
emit | Eventos que este flujo de trabajo anuncia al terminar: una lista o una cadena separada por comas. Consulta Eventos. |
inputs | Valores 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. |
case | Convierte 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.
| Entrada | Presente cuando |
|---|---|
_event_source, _event_payload, _event_origin | Se 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_payload | Se activó un disparador watch o folder. Una línea de la salida del observador, o {files} para una carpeta. |
inputs | Siempre. 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.
| Campo | Significado |
|---|---|
key | Obligatorio. Rutas con puntos separadas por comas dentro de los datos del disparador que identifican al sujeto, como contactEmail,email,phone. |
type | El 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_wait | Cuá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.maxIterationsindique 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_budgetde 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.